Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Quando distribuisci un'app per la prima volta utilizzando la console Firebase o uno strumento CLI (Firebase CLI, fastlane), App Distribution invia al tester un invito con le istruzioni su come installare e testare la build.
Questa guida descrive come installare e testare una nuova app distribuita tramite App Distribution dal punto di vista di un tester. Per risposte alle domande frequenti o assistenza per la risoluzione dei problemi, consulta la guida alla risoluzione dei problemi.
Passaggio 1: accedi con Google per accettare l'invito
Su un dispositivo iOS, apri l'invito via email in Safari.
Devi aprire l'invito via email per installare correttamente il profilo Firebase e registrare il tuo dispositivo nel Passaggio 2.
Quando richiesto, accedi con Google e accetta l'invito per testare l'app.
Una volta accettato un invito, ti viene concesso l'accesso per installare l'app di test.
Ricevi anche email di notifica della build da
Firebase quando lo sviluppatore dell'app distribuisce una nuova build e ti include come
tester.
Passaggio 2: installa il profilo Firebase
Distribuzioni ad hoc
Nella pagina dell'app di test, tocca Registra dispositivo.
Quando richiesto, scarica il profilo Firebase, quindi installalo
nell'app Impostazioni.
L'installazione del profilo concede a Firebase l'autorizzazione a:
Registra il dispositivo di test raccogliendo il relativo ID univoco (UDID). Se stai testando una distribuzione ad hoc, Firebase invia a tutti i proprietari e gli editor del progetto Firebase un'email che include l'UDID del dispositivo di test, insieme alle istruzioni su come includere il dispositivo nel profilo di provisioning dell'app in modo che la build possa essere testata sul dispositivo.
Installa un clip web Firebase App Distribution nella schermata Home del dispositivo di test. Il clip web ti consente di installare e accedere a tutte le tue app di test.
Distribuzioni Enterprise
Questo passaggio è facoltativo, ma consigliato per testare le distribuzioni firmate da Enterprise. L'installazione del profilo aggiunge il Firebase App Distribution
clip web alla schermata Home del dispositivo, in modo da poter installare e accedere a tutte
le tue app di test. Per installare manualmente il profilo:
In Testa app, seleziona l'app che vuoi testare.
In alto a destra nella pagina dell'app, tocca mobile_screen_share.
Segui le istruzioni visualizzate per installare il profilo Firebase.
Passaggio 3: installa e testa la build
Distribuzioni ad hoc
Dopo aver registrato il dispositivo, lo sviluppatore deve aggiornare il proprio profilo di provisioning con l'UDID del dispositivo e ridistribuire una build configurata per l'esecuzione sul dispositivo. Firebase ti invia una notifica via email quando la build è disponibile per l'installazione.
Nella sezione Testa le app del clip web Firebase App Distribution, selezionate l'app per cui volete installare una nuova build, quindi toccate Scarica. La build viene scaricata nella schermata Home del dispositivo, quindi puoi iniziare subito a testarla.
Distribuzioni Enterprise
Nella sezione Testa le app del clip web Firebase App Distribution, selezionate l'app per cui volete installare una nuova build, quindi toccate Scarica. La build viene scaricata nella schermata Home del dispositivo, quindi puoi iniziare subito a testarla.
Nell'app Impostazioni > schermata Gestione profili e dispositivo, seleziona il nome dello sviluppatore dell'app e attendi che venga considerata attendibile.
Se non hai il clip web Firebase App Distribution, puoi installare una nuova build per la tua app di test toccando Scarica la build più recente nell'email di notifica della nuova build inviata da Firebase.
Infine, torna alla schermata Home del dispositivo e apri l'app di test.
Passaggio 4: (facoltativo) attiva gli avvisi relativi alle nuove build
Se l'SDK Firebase App Distribution è stato aggiunto all'app di test, puoi attivare facoltativamente gli avvisi in-app che vengono visualizzati quando sono disponibili nuove build da testare. Per ulteriori informazioni sull'SDK, inclusa la procedura per aggiungerlo a un'app di test, consulta la guida Inizia.
Apri l'app di test dalla schermata Home del dispositivo.
Quando viene visualizzata la finestra di dialogo Attiva avvisi, tocca Sì.
Accedi con l'Account Google utilizzato in precedenza nel passaggio 1
(l'account utilizzato per accettare l'invito dell'app).
Gli avvisi in-app vengono attivati automaticamente.
Torna all'app di test. Ora riceverai avvisi in-app quando sono disponibili nuove versioni dell'app per i test.
Per scaricare una nuova versione dell'app direttamente da un avviso, tocca Aggiorna nella finestra di dialogo dell'avviso. La nuova versione dell'app viene scaricata e aggiunta alla schermata iniziale del dispositivo.
[null,null,["Ultimo aggiornamento 2025-07-08 UTC."],[],[],null,["\u003cbr /\u003e\n\niOS+ Android \n\n\u003cbr /\u003e\n\nWhen you first distribute an app using\nthe [Firebase console](/docs/app-distribution/android/distribute-console) or\na CLI tool ([Firebase CLI](/docs/app-distribution/android/distribute-cli),\n[fastlane](/docs/app-distribution/android/distribute-fastlane)),\nApp Distribution emails the tester an invitation with instructions on how to\ninstall and test the build.\n\nThis guide describes how to install and test a new app\ndistributed through App Distribution from a tester's point of view. For answers to\nfrequently asked questions or help with troubleshooting, read the\n[troubleshooting guide](/docs/app-distribution/troubleshooting).\n\n**Step 1**: Sign in with Google to accept the invitation\n\n1. On an iOS device, open the email invitation in Safari.\n You must open the email invitation to properly install the Firebase\n profile and register your device in [Step 2](#install-profile).\n\n2. When prompted, sign in with Google and accept the invitation to\n test the app.\n\n| **Keep the following in mind:**\n|\n| - After opening an invitation to test an app, you can sign in with any Google account to accept the invitation, not just the account to which the invitation was originally sent.\n| - Invitations can only be accepted once before becoming invalid.\n| - A Google account can be associated with any email address, not only addresses with Gmail or G Suite domains. Find out how to [sign in](https://support.google.com/accounts/answer/176347?co=GENIE.Platform%3DDesktop&hl=en&oco=1) with another email address.\nOnce you accept an invitation, you're given access to install the test app. You also receive build notification emails from Firebase when the app's developer distributes a new build and includes you as a tester. **Tip:** If you don't want to go through your email to accept new app invitations, you can also access your pending app invitations directly in the Firebase App Distribution web clip: [appdistribution.firebase.google.com](http://appdistribution.firebase.google.com).\n\n**Step 2**: Install the Firebase profile \n\nAd Hoc distributions\n\n1. In the test app's page, tap **Register device**.\n2. When prompted, download the Firebase profile, then install the profile in the **Settings** app.\n\nInstalling the profile gives Firebase permission to:\n\n- Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends all Owners and Editors of the Firebase project an email that includes the test device's UDID , along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.\n- Install a Firebase App Distribution web clip to the test device's home screen. The web clip allows you to install and access all of your test apps.\n\nEnterprise distributions\n\nThis step is optional but recommended for testing Enterprise-signed\ndistributions. The profile installation adds the Firebase App Distribution\nweb clip to your device's home screen, so you can install and access all\nyour test apps. To manually install the profile:\n\n1. Under **Test apps**, select the app you want to test.\n\n2. In the top right of the app's page, tap *mobile_screen_share*.\n\n3. Follow the instructions displayed to install the Firebase profile.\n\n**Step 3**: Install and test the build \n\nAd Hoc distributions\n\nAfter you register your device, the developer must update their\nprovisioning profile with your device's UDID and redistribute a build\nthat's configured to run on your device. Firebase emails you a notification\nwhen the build is available for you to install.\nIn the **Test apps** section of the Firebase App Distribution web clip, select the app for which you want to install a new build, then tap **Download** . The build is downloaded to your device's home screen so you can start testing right away. \n\nEnterprise distributions\n\n1. In the **Test apps** section of the Firebase App Distribution web clip, select the app for which you want to install a new build, then tap **Download** . The build is downloaded to your device's home screen so you can start testing right away. \n2. In the **Settings** app \\\u003e **Profiles \\& Device Management** screen, select\n the app's developer name and trust it.\n\nIf you do not have the Firebase App Distribution web clip, you can install\na new build for your test app by tapping **Download the latest build** in\nthe new build notification email from Firebase.\n\nFinally, return to your device's home screen and open the test app.\n\n**Step 4**: (Optional) Enable new build alerts\n\nIf the Firebase App Distribution SDK has been added to your test app, you\ncan optionally enable in-app alerts that appear when new builds are available\nto test. For more information about the SDK, including how to add it to a test\napp, refer to the Get Started guide.\n\n1. From your device's home screen, open the test app.\n\n2. When the **Enable alerts** dialogue appears, tap **Yes**.\n\n | **If you don't see the dialogue,** note the following:\n | - The dialogue may appear at a different point in your app, depending on where the developer implemented the feature.\n | - If the developer customized the dialogue, it may appear with different text, buttons, or other elements.\n | - Check that you have accepted terms on your test device when you accepted the invitation to test the app.\n3. Sign in with the Google account you previously used in [Step 1](#sign-in)\n (the account you used to accept the app's invitation).\n In-app alerts are turned on automatically.\n\n If you have trouble signing in to your Google account, visit the\n [troubleshooting guide](/docs/app-distribution/troubleshooting#google-signin-ios).\n4. Return to the test app. Now, you receive in-app alerts when new app versions\n are available for testing.\n\nTo download a new app version directly from an alert, tap **Update** in the\nalert dialogue. The new app version is downloaded and added to your device's\nhome screen.\n\nDelete your tester account\n\nTo delete your App Distribution tester account and its\ndata, see the [App Distribution troubleshooting \\& FAQ](/docs/app-distribution/troubleshooting#delete-tester-account)."]]