Configurar usuários como testadores com o App Distribution
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Quando você distribui um app pela primeira vez usando
o console do eFirebase ou
uma ferramenta CLI (CLI do Firebase,
fastlane),
o App Distribution envia para o testador um convite por e-mail com instruções sobre como
instalar e testar o build.
Confira neste guia como instalar e testar um novo app
distribuído com o App Distribution do ponto de vista do testador. Para respostas a perguntas frequentes ou ajuda com a solução de problemas, leia o guia de solução de problemas.
Etapa 1: fazer login com o Google para aceitar o convite
Em um dispositivo iOS, abra o convite por e-mail no Safari
para instalar corretamente o perfil do Firebase
e registrar seu dispositivo na Etapa 2.
Quando solicitado, faça login com o Google e aceite o convite para
testar o app.
Depois de aceitar um convite, você terá acesso para instalar o app de teste.
Você também receberá e-mails de notificação da versão do
Firebase quando o desenvolvedor do app distribuir uma nova versão e incluir
você como testador.
Etapa 2: instalar o perfil do Firebase
Distribuições ad hoc
Na página do app de teste, toque em Registrar dispositivo.
Quando solicitado, faça o download do perfil do Firebase e instale-o no app Configurações.
A instalação do perfil concede ao Firebase permissão para:
Registrar o dispositivo de teste coletando o ID exclusivo do dispositivo (UDID, na sigla em inglês). Se você estiver testando uma distribuição Ad Hoc, o Firebase enviará a todos os proprietários
e editores do projeto do Firebase um e-mail que inclui o UDID do dispositivo de teste,
com instruções sobre como incluir o dispositivo no
perfil de provisionamento do app para que a versão possa ser testada no seu dispositivo.
Instalar um clipe da Web do Firebase App Distribution na tela inicial do dispositivo de teste. O clipe da Web permite que você instale e acesse todos os seus aplicativos de teste.
Distribuições empresariais
Esta etapa é opcional, mas recomendada para testar distribuições assinadas por empresas. A instalação do perfil adiciona o clipe da Web do Firebase App Distributionà tela inicial do dispositivo, para você instalar e acessar todos os apps de teste. Para instalar manualmente o perfil:
Em Testar apps, selecione o app que você quer testar.
No canto superior direito da página do app, toque em mobile_screen_share.
Siga as instruções exibidas para instalar o perfil do Firebase.
Etapa 3: instalar e testar a versão
Distribuições ad hoc
Depois que você registrar seu dispositivo, o desenvolvedor precisará atualizar o perfil de provisionamento dele com o UDID do dispositivo e redistribuir uma versão configurada para ser executada no dispositivo. O Firebase envia uma notificação por e-mail quando a versão está disponível para instalação.
Na seção Testar apps do clipe da Web do Firebase App Distribution, selecione o app em que você quer instalar um novo build e toque em Download. O download da versão é feito na tela
inicial do dispositivo para que você possa começar a testar imediatamente.
Distribuições empresariais
Na seção Testar apps do clipe da Web do Firebase App Distribution, selecione o app em que você quer instalar um novo build e toque em Download. O download da versão é feito na tela
inicial do dispositivo para que você possa começar a testar imediatamente.
No app Configurações, na tela Perfis e gerenciamento de dispositivos, selecione o nome do desenvolvedor do aplicativo e defina-o como confiável.
Se você não tiver o clipe da Web do Firebase App Distribution, toque em Download do build mais recente, no
e-mail de notificação de novo build do Firebase, para instalar um novo build para seu app de teste.
Por fim, volte à tela inicial do dispositivo e abra o app de teste.
Etapa 4 (opcional): ativar alertas de novas versões
Se o SDK do Firebase App Distribution foi adicionado ao app de teste,
você pode ativar alertas no app, que aparecem quando novos builds são disponibilizados para teste. Para mais informações sobre o SDK, incluindo como adicioná-lo a um app
de teste, consulte o Guia explicativo.
Na tela inicial do seu dispositivo, abra o app de teste.
Quando a caixa de diálogo Ativar alertas for exibida, toque em Sim.
Faça login com a Conta do Google usada anteriormente na Etapa 1
(a conta que você usou para aceitar o convite do app).
Os alertas são ativados automaticamente no app.
Volte para o app de teste. Agora você receberá alertas no app quando novas versões do app
estiverem disponíveis para teste.
Para fazer o download de uma nova versão do app diretamente de um alerta, toque em Atualizar na
caixa de diálogo do alerta. A nova versão do app é salva e adicionada à tela inicial
do dispositivo.
[null,null,["Última atualização 2025-08-13 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)."]]
