Nesta página, você vai 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.
Distribuição de apps
Use estas dicas para resolver problemas que podem surgir ao distribuir apps para seus testadores.
Não foi possível distribuir um app porque um e-mail de contato está faltando
Este erro pode ocorrer ao fazer upload de um app:
"Não foi possível encontrar um e-mail de contato para o app <app-id>
. Acesse o
App Distribution no console Firebase para configurar um."
Defina um e-mail de contato no console do Firebase, se disponível. Se o problema persistir, entre em contato com o suporte do Firebase.
Ocorreu um erro ao provisionar seu app (erros 400, 409 ou 500)
Se você encontrar os erros 400, 409 ou 500 repetidamente durante o provisionamento, entre em contato com o suporte do Firebase. Forneça o número do projeto e o identificador do app Firebase ao suporte.
Não foi possível fazer upload do IPA
Veja a seguir um exemplo de resposta de rede do navegador:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Para resolver o problema, siga estas etapas:
Verifique o tamanho do IPA. O tamanho máximo do arquivo para todos os binários é 2048 MiB, pouco mais de 2 GB.
Se o tamanho do IPA estiver dentro do limite de arquivos e puder ser reproduzido, siga estas três etapas.
Verifique seu arquivo
Info.plist
e confirme seCFBundleDisplayName
contém delimitadores de<array>
.Remova os delimitadores
<array>
e recrie seu app. Não devem ocorrer erros durante o upload.Se você ainda estiver com problemas, entre em contato com o suporte do Firebase.
Se o tamanho do IPA estiver acima do limite, faça as alterações necessárias para diminuir o arquivo.
Se a redução do tamanho do arquivo IPA não resolver o problema, entre em contato com o suporte do Firebase e pergunte sobre como usar o Testflight.
Como instalar e testar apps
Use as dicas a seguir para resolver problemas que os testadores podem ter ao instalar e testar seus apps.
O testador não tem uma Conta do Google
Quando um usuário cria uma Conta do Google, ele automaticamente recebe um endereço do Gmail.
Se o testador não tiver um endereço do Google Workspace ou do Gmail ou preferir usar outro e-mail para fazer login, peça que ele vincule um endereço que não seja do Gmail à conta e o use para fazer login.
Ao escolher um e-mail alternativo, o testador precisa seguir estas diretrizes:
- Não usar um endereço do Gmail.
- Não usar um endereço de e-mail que já esteja vinculado a outra Conta do Google.
- Usar a senha da Conta do Google ao fazer login com esse endereço de e-mail.
Para saber mais, consulte Fazer login na sua Conta do Google com outro endereço de e-mail.
O testador não consegue ver os apps ou builds certos
Se o testador aceitou o convite por e-mail com um endereço diferente do que foi enviado, talvez não consiga ver os apps ou builds corretos.
O e-mail que o desenvolvedor usar para enviar convites e o adicionar a novos builds (e-mail A) pode ser diferente do e-mail que o testador usa para aceitar o convite (e-mail B). Isso gera um link nos bastidores. Sempre que o e-mail A é adicionado a novos builds, é o e-mail B que tem acesso.
Se o testador aceitar o convite com outro endereço de e-mail, siga estas etapas para resolver o problema:
Exclua o testador da seção Acessar todos os testadores da guia Testadores e grupos na página App Distribution do console do Firebase. Isso remove os convites atuais.
Convide o testador novamente para testar. Ele vai receber um e-mail de convite.
Não esqueça que o testador precisa aceitar o convite usando o mesmo endereço de e-mail.
O testador não está recebendo notificações por e-mail
Os testadores não receberão notificações por e-mail nas seguintes situações:
As notificações por e-mail foram enviadas para as pastas de spam.
O e-mail tem filtros ativos.
O convite foi enviado para uma conta de e-mail, mas o testador aceitou com uma conta de e-mail diferente. O testador está recebendo novos e-mails de versão na conta de e-mail a que o convite foi enviado originalmente.
O testador já foi convidado, mas não aceitou o convite inicial. Se o testador for adicionado a versões seguintes, o App Distribution não vai enviar as notificações de versão automaticamente porque ele não aceitou o convite inicial.
Solução 1
Peça para o testador verificar a pasta de spam e os filtros definidos no provedor de e-mail.
Se o testador cancelou a inscrição nos e-mails, peça para ele fazer o seguinte:
- Encontrar um e-mail que o testador recebeu anteriormente do app.
- Clicar em Gerenciar configurações de e-mail na parte de baixo e clicar em Permitir e-mails para se inscrever novamente.
Solução 2
Se o testador não quiser receber notificações por e-mail e só quiser aceitar convites de apps, ele poderá visualizar os convites de apps pendentes diretamente no clipe da Web do Firebase App Distribution: appdistribution.firebase.google.com.
Solução 3
Exclua o testador da seção Acessar todos os testadores da guia Testadores e grupos na página App Distribution do console do Firebase. Isso remove os convites atuais.
Convide o testador novamente para testar. Ele vai receber um e-mail de convite. O testador precisa aceitar o convite usando o mesmo endereço de e-mail para que ele foi enviado.
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 app. Em Configurações, na tela Perfis e gerenciamento de dispositivos, selecione o nome do desenvolvedor do app e confie nele.
Erro "Modo de desenvolvedor obrigatório" ao tentar executar o aplicativo de teste
O erro "Modo de desenvolvedor obrigatório" é exibido quando você tenta iniciar um app iOS provisionado ad hoc no iOS 16 ou posterior sem ativar o Modo de desenvolvedor.
Para ativar o modo de desenvolvedor e resolver esse erro, siga estas etapas:
- No iPhone, abra o app Ajustes e toque em Privacidade e segurança.
- Role para baixo até "Segurança" e toque em Modo do desenvolvedor.
- Toque no controle deslizante Modo de desenvolvedor.
- Toque em Reiniciar.
- Depois que o dispositivo for reiniciado, desbloqueie-o. A caixa de diálogo "Ativar o modo de desenvolvedor?" é exibida.
- Toque em Ativar. Agora você pode iniciar seu app e começar a testar.
"Dispositivo registrado, tudo pronto! Você vai receber um e-mail quando o app estiver disponível para teste"
Se você estiver instalando uma distribuição ad hoc, essa mensagem vai aparecer quando o desenvolvedor ainda não tiver configurado o app para execução no dispositivo de teste. Para disponibilizar o app para você, o desenvolvedor precisa seguir as instruções em Registrar outros dispositivos.
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.
Erro 403: "Entre em contato com seu administrador para ter acesso"
O erro 403 significa que a conta que você está usando não tem permissão para instalar e testar apps. O acesso é determinado pelo administrador do domínio da sua conta no Google Workspace.
Se você acha que precisa de permissão para instalar e testar apps, peça ao administrador da conta do Google Workspace para mudar as configurações da conta. O administrador precisa seguir as instruções na seção Gerenciar o acesso aos serviços que não são controlados individualmente.
Se você tiver várias contas, tente fazer login com uma que não tenha restrições para instalar e testar apps.
Como ativar alertas no app com o SDK do iOS para App Distribution
Use as dicas a seguir para resolver problemas que envolvem a ativação de novos alertas de build no app usando o SDK do iOS para App Distribution.
O testador não está recebendo alertas no app
Se você já tiver configurado o SDK do iOS para App Distribution no seu app, mas os testadores não recebem alertas no app, verifique se ele está coletando novas versões:
Ative o modo de depuração no seu app. Para saber como, consulte a documentação do Google Analytics.
Execute seu app em um simulador e procure a string "[Firebase/AppDistribution]".
Verifique se o testador tem acesso à nova versão:
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.
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 do build como Aceito.
Se o testador ainda não estiver recebendo atualizações, peça para ele seguir as dicas abaixo e verificar se aceitou o convite para testar o app e configurou o dispositivo de teste corretamente:
No dispositivo de teste, faça login no clipe da Web do Firebase App Distribution. Selecione a Conta do Google que você usou ao aceitar o convite para testar o app.
Veja 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 a configuração correta do App Distribution:
Verifique se você ativou a API Firebase App Tester. Para mais informações, consulte Ativar a API App Distribution Tester.
Em Restrições da chave, verifique se a API Firebase App Tester está incluída na lista de APIs permitidas.
Se você costuma limpar UserDefaults ao sair, pode ser que esteja limpando o estado do testador. O App Distribution armazena uma flag que indica se o testador já fez login no app. Para mais informações, consulte o repositório do GitHub.
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
Para adicionar mais testadores, solicite um aumento de limite sem custos financeiros.
Meus convites para testadores expiram?
Os testadores têm 30 dias para aceitar um convite de teste do app antes que ele expire. Quando faltarem cinco dias para o vencimento do convite, um aviso de expiração vai aparecer no Console do Firebase ao lado do testador em uma versão. Reenvie um convite pelo menu suspenso na linha do testador para renovar.
Quando uma nova versão é criada para uploads no iOS?
Consulte Registrar outros dispositivos.
Por quanto tempo as versões do app ficam disponíveis?
As versões do app serão removidas do App Distribution nas seguintes situações:
- A versão do app tem mais de 150 dias.
- O limite de 1.000 versões do app foi excedido e a versão do app é mais antiga que as 1.000 versões mais recentes.
Para mais informações, consulte o App Distribution oferece suporte a no máximo 1.000 versões.
Quando o app atinge ou excede o limite de validade de 150 dias ou o limite de 1.000 versões do app, a versão é removida do painel do App Distribution e do app da Web do testador do App Distribution. Se o testador instalou a versão, a versão local do app continua em execução.
Para manter a versão do app disponível por mais tempo, use uma destas recomendações:
- Antes que a versão do app expire ou exceda o limite, faça o download do IPA e exclua a versão do painel do App Distribution. Depois, faça novo upload do IPA como um novo build para o App Distribution.
- Faça o download da versão e envie-a para o Cloud Storage para arquivamento de longo prazo.
As versões do app expiram após 150 dias
Quando você faz upload de uma versão do app para o Firebase, ela aparece no painel do App Distribution por 150 dias, a partir da data do upload. Depois de fazer upload da versão, é possível distribuí-la para os testadores. Eles instalam a versão usando o app da Web do testador do App Distribution no dispositivo de teste.
Quando a versão estiver a 30 dias da data de validade, surge uma notificação de validade na página do App Distribution do console do Firebase e no app da Web do testador do App Distribution.
O App Distribution oferece suporte para no máximo 1.000 versões
O App Distribution permite no máximo 1.000 versões por app. Quando o app atinge esse limite, o App Distribution exclui automaticamente as versões mais antigas acima do limite.
Se você quiser gerenciar manualmente as versões do app, use a API REST do App Distribution para listar e excluir versões do app em lote.
Se você tiver dúvidas, entre em contato com o suporte do Firebase.
O que é o perfil do Firebase?
O perfil do Firebase é um perfil de configuração que permite que o 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 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 apps de teste com o clipe da Web do Firebase App Distribution, que é adicionado automaticamente à tela inicial do dispositivo de teste ao instalar o perfil do Firebase. Se você estiver testando uma distribuição ad hoc, instale o perfil antes de testar o app.
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. A revogação do acesso sem antes excluir a conta do App Distribution não exclui sua conta ou os dados de testador.