Nesta página, você encontrará ajuda para a solução de problemas e respostas a perguntas frequentes sobre a distribuição e o teste de apps com o App Distribution.
Como instalar e testar aplicativos
As dicas a seguir ajudam os testadores a resolver problemas que envolvem a instalação de aplicativos de teste e o acesso a eles em um dispositivo.
A Conta do Google não tem acesso ao app de teste
Se a sua Conta do Google não tiver acesso a um app de teste instalado anteriormente (ou se você aceitou um convite), é provável que tenha você feito login na Conta do Google errada. Os aplicativos a que você tem acesso são associados à Conta do Google que você usou quando aceitou o convite para testar o app. Faça login novamente com a conta usada anteriormente para aceitar o convite.
O erro "Desenvolvedor empresarial não confiável" aparece ao tentar executar um app de teste
O erro Desenvolvedor empresarial não confiável é exibido se você não confiou no certificado de desenvolvedor no dispositivo de teste antes de abrir o aplicativo. No app Configurações, na tela Perfis e gerenciamento de dispositivos, selecione o nome do desenvolvedor do aplicativo e confie nele.
"Aguardando o desenvolvedor" impede a instalação do app de teste
Se você estiver instalando uma distribuição ad hoc, o botão Aguardando desenvolvedor aparecerá quando o desenvolvedor ainda não tiver configurado o aplicativo para execução no dispositivo de teste. Para disponibilizar o app para você, o desenvolvedor precisa concluir as seguintes etapas:
Adicione o UDID do dispositivo de teste no portal Apple Developer (em inglês). O UDID é enviado por e-mail ao desenvolvedor quando você registra o dispositivo no Firebase.
Inclua o dispositivo no perfil de aprovisionamento do aplicativo.
Crie o aplicativo usando o perfil de provisionamento atualizado.
Distribua um novo build usando o Console do Firebase, a CLI ou o fastlane.
Como ativar alertas no aplicativo com o SDK do App Distribution
As dicas a seguir ajudarão você e o testador a solucionar problemas que envolvem a ativação de novos alertas de build no app usando o SDK do App Distribution.
O testador não está recebendo alertas no app
Se você já tiver configurado o SDK do App Distribution no seu app e os testadores não estiverem recebendo alertas no app, verifique se ele está coletando novas versões:
Ative o modo de depuração no app (acesse a documentação do Google Analytics para saber como), execute-o em um simulador e procure a string "[Firebase/AppDistribution"].
Verifique se você está recebendo versões do app:
Se um objeto de versão válido for retornado, é provável que haja um problema no ciclo de vida do controlador de visualização em que a caixa de diálogo de alerta é carregada antes que a visualização apareça. O SDK do App Distribution não exibe um diálogo de alerta por padrão. É preciso especificar como e onde a caixa de diálogo é exibida no app. Consulte Configuração básica de alertas para ver um exemplo.
Se nenhuma versão for retornada, talvez o testador ainda não esteja associado à nova versão. No painel do App Distribution do Console do Firebase, verifique se o testador está incluído na distribuição da versão e se está no estado Aceito.
Se o testador ainda não estiver recebendo alertas, peça para que ele siga as dicas abaixo e verifique se aceitou o convite para testar o app e configurar o dispositivo de teste corretamente:
No dispositivo de teste, faça login no clipe da Web do Firebase App Distribution. Lembre-se de selecionar a Conta do Google que você usou ao aceitar o convite para testar o app.
Verifique se a nova versão do app está disponível no clipe da Web.
O testador recebeu uma solicitação para fazer login novamente após fechar o app
Por padrão, os testadores só precisam fazer login na Conta do Google uma vez para ativar novos alertas de versão e instalar novas versões. Se os testadores precisarem fazer login novamente após encerrar e abrir o app, siga estas dicas para garantir que a configuração do App Distribution seja feita corretamente:
Verifique se você ativou a API Tester do App Distribution. Consulte as instruções no guia do SDK do App Distribution.
No Console do Google Cloud Platform, em Restrições de chave, verifique se você não está usando uma chave de API restrita.
Se você costuma limpar
UserDefaults
no logout, pode estar limpando o estado do testador. O App Distribution armazena uma sinalização que indica se o testador já fez login no app. Consulte o repositório do GitHub para mais informações.
Perguntas frequentes
Há limites para adicionar testadores ao meu app?
O Firebase App Distribution tem os seguintes limites de testadores:
Adicionar no máximo 500 testadores a um projeto do Firebase
Adicionar no máximo 200 testadores a um grupo do App Distribution
Adicionar no máximo 200 testadores por distribuição
Para adicionar mais testadores, solicite um aumento de limite gratuito.
Os builds do meu app expiram?
Quando você faz upload de um build do app no Firebase, ele fica disponível no painel do App Distribution (no Console do Firebase) por 150 dias (cinco meses), a partir da data do upload. Depois disso, é possível distribuir o build para os testadores, que podem instalá-lo a partir do clipe da Web do Firebase App Tester no dispositivo de teste. Para alertar você e seus testadores, uma mensagem de expiração será exibida no build quando faltarem 30 dias para a expiração.
Após o período de 150 dias, o build expira e é removido do painel do App Distribution e do clipe da Web do Firebase App Distribution. Se o testador instalou o build, a versão local do app continuará em execução.
Se você quiser manter seu build por mais tempo, recomendamos as seguintes soluções:
Antes que o build expire, faça o download do IPA e exclua o build no painel "App Distribution". Em seguida, faça upload do IPA novamente para o Firebase App Distribution (como um novo build).
Faça o download do build e depois o envie ao Cloud Storage para Firebase a fim de realizar o arquivamento de longo prazo.
O que é o perfil do Firebase?
O perfil do Firebase é um perfil de configuração que permite ao App Distribution:
Registre o dispositivo de teste coletando o código exclusivo do dispositivo (UDID). Se você estiver testando uma distribuição Ad Hoc, o Firebase enviará ao desenvolvedor do aplicativo um e-mail que inclui o UDID do dispositivo de teste, além de instruções sobre como incluir o dispositivo no perfil de provisionamento do aplicativo para que a versão possa ser testada no dispositivo.
Instale um clipe da Web do Firebase App Distribution na tela inicial do seu dispositivo. O clipe da Web permite que você instale e acesse todos os seus aplicativos de teste em um só lugar. As novas versões que você foi convidado para testar são adicionadas automaticamente ao clipe da Web.
Para ajuda sobre como instalar perfis de configuração no seu dispositivo iOS, consulte a documentação da Apple.
Como posso acessar os apps de teste que instalei no meu dispositivo?
Se você for um testador, poderá acessar todos os seus aplicativos de teste com o clipe da Web do Firebase App Distribution, que é adicionado automaticamente à tela inicial do dispositivo de teste quando ao instalar o perfil do Firebase. Se você estiver testando uma distribuição ad hoc, primeiro instale o perfil antes de testar o aplicativo.
Se você estiver testando uma distribuição do Google Enterprise, poderá instalar manualmente o perfil:
Faça login no Google e aceite o convite, caso ainda não tenha feito isso.
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.
Como faço para excluir minha conta de testador?
Para excluir sua conta de testador do App Distribution e os dados associados a ela, siga estas etapas na ordem recomendada:
Acesse https://appdistribution.firebase.google.com e faça login com sua Conta do Google.
No canto superior direito, clique em settings (Gerenciar conta).
Excluir conta.
Opcional: nas permissões da Conta do Google, revogue o acesso do Firebase App Distribution. Revogar o acesso sem antes excluir a conta do App Distribution não exclui a conta ou os dados do testador.