Solução de problemas e perguntas frequentes sobre o App Distribution

iOS+ Android

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 arquivo APK

1. Verifique o tamanho do APK. O tamanho máximo do arquivo para todos os binários é 2048 MiB, pouco mais de 2 GB.

2. Se o tamanho do APK estiver dentro do limite de arquivos e puder ser reproduzido, entre em contato com o suporte do Firebase.

Não foi possível fazer upload do APK com o fastlane. A assinatura do APK foi cancelada.

Verifique se o APK está assinado usando o seguinte:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Como distribuir Android App Bundles (AABs)

Recebimento de erros com provedores de API de terceiros ou de login social

Quando você faz upload de um AAB para o App Distribution, o Google Play automaticamente substitui o APK gerado por um certificado de chave de assinatura do app de teste. Quando solicitado, registre seu app em um dos provedores de API para continuar usando os serviços de terceiros. Depois de atribuído, o certificado de teste do app pode ser visualizado no console do Firebase.

Os AABs enviados por upload também aparecem no Google Play?

Os builds do AAB enviados para o App Distribution não aparecem na sua conta de desenvolvedor do Google Play. Isso inclui o Pesquisador de pacotes de apps e o Compartilhamento interno de apps.

O que vai acontecer se eu desvincular o Firebase do Google Play?

Se um app Android do Firebase for desvinculado do Google Play:

• Não será possível fazer upload de novos pacotes de apps para o App Distribution e exportá-los para o Google Play pela integração do App Distribution com o Google Play.

• Os builds existentes vão continuar disponíveis no painel do Firebase App Distribution e para os testadores.

• Ainda será possível acessar os dados anteriores exportados entre o Firebase e o Google Play nos dois serviços.

Posso tentar vincular um app ao Google Play novamente?

Para distribuir um Android App Bundle (AAB) pelo App Distribution e automaticamente vincular os AABs ao projeto do Firebase e à conta de desenvolvedor do Google Play, verifique se você atende aos seguintes requisitos:

• Sua conta de desenvolvedor do Google Play tem um dos seguintes níveis de acesso: proprietário ou administrador.

• No seu projeto do Firebase, você tem um dos seguintes papéis: Proprietário ou Administrador do Firebase.

• Seu app está registrado no Firebase e na sua conta de desenvolvedor do Google Play. Ou seja, você tem um app Android do Firebase e um do Google Play.

• O app no Google Play e o app Android do Firebase são registrados usando o mesmo nome de pacote.

• O app no Google Play é configurado no painel do app e distribuído para uma das faixas do Google Play: teste interno, teste fechado, teste aberto ou produção.

• A avaliação do app no Google Play é concluída e ele é publicado. Seu app está publicado se a coluna Status do app tiver um dos seguintes status: teste interno (e não teste interno de rascunho), teste fechado, teste aberto ou produção.

Se você tiver feito upload de um app que não atendia aos critérios listados acima, mas agora foi corrigido, tente vincular seu app Android do Firebase ao Google Play novamente.

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:

1. 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.

2. Convide o testador novamente para testar. Ele vai receber um e-mail de convite.

3. 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

1. Peça para o testador verificar a pasta de spam e os filtros definidos no provedor de e-mail.

2. Se o testador cancelou a inscrição nos e-mails, peça para ele fazer o seguinte:

   1. Encontrar um e-mail que o testador recebeu anteriormente do app.
   2. 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, mas quiser aceitar convites para apps, ele poderá ver os convites pendentes diretamente no app App Tester. Faça o download das instruções.

Observação: para ver os convites de apps pendentes, o endereço de e-mail da Conta do Google que o testador usa para fazer login no App Tester precisa corresponder ao endereço de e-mail do destinatário do convite do desenvolvedor.

Solução 3

1. 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.

2. 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 app não indica que está instalado.

Um problema conhecido é quando um testador faz o download e instala uma versão, mas a interface do usuário de detalhes do app não mostra que o app está instalado. Em alguns casos, o ID do pacote no app Firebase não é igual ao do APK.

Verifique se o ID do pacote do APK é o mesmo do pacote do app Firebase que você usou para fazer upload da distribuição.

De acordo com o alerta do Android, meu dispositivo não pode instalar apps desconhecidos

O alerta do Android será exibido se o app ou navegador em execução ainda não tiver permissão para instalar apps fora do Google Play. Para conceder permissão:

• Android versão 8 ou posterior: no app Configurações, toque em Permitir desta fonte.

• Android versão 7 ou anterior: no app Configurações, toque em Segurança e selecione Fontes desconhecidas. Quando a mensagem for exibida, toque em OK > Confiar.

Falha ao instalar APKs de teste

Caso não seja possível instalar o APK de teste no dispositivo do testador:

• Verifique se os certificados da nova versão são iguais aos da instalada no dispositivo do testador. O sistema Android só permite que o app seja atualizado com os mesmos certificados. Para saber mais, consulte Considerações sobre assinaturas.
• Verifique se a versão do SO do dispositivo de testador tem suporte para o app (verifique minSdkVersion).

Não foi possível fazer login no app Android App Tester

Se o App Tester impedir o login e redirecionar para a tela de login, talvez você esteja usando um Google Workspace (antigo G Suite) com restrições configuradas.

Para remover as configurações de restrição, faça o seguinte:

1. Na guia Apps do Google Workspace, verifique se o Firebase App Distribution não está definido como Acesso: bloqueado.

2. Na guia Serviços, verifique se o Cloud Platform não tem restrições.

3. Depois de remover as configurações, tente fazer login novamente.

Erro ao instalar o AAB: "Não é possível instalar o app"

Esse erro pode acontecer quando o app que está sendo instalado entra em conflito com um app já instalado no dispositivo. Por exemplo, pode ser uma variante diferente do mesmo app com a mesma permissão personalizada ou nome do ContentProvider.

É possível pedir ao testador para coletar um relatório do bug imediatamente depois de enfrentar o problema e inspecioná-lo para mais informações sobre a causa. O testador precisa excluir todos os apps conflitantes antes de instalar o novo.

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.

Testar em um novo dispositivo Android

Se for seu primeiro teste, consulte Configurar como testador.

Se você já for um testador do App Distribution e receber um novo dispositivo Android para testar, em vez de passar por todo o fluxo do novo testador novamente, siga estas etapas:

1. Acesse appdistribution.firebase.google.com no seu dispositivo Android.

2. Faça login com sua conta de testador e clique no botão Download App Tester na parte inferior da tela para instalar o app Android App Tester.

Como ativar recursos para o testador com o SDK do Android para App Distribution

Use as dicas a seguir para resolver problemas que envolvem a ativação de novos alertas de build no app ou o envio de feedback no app usando o SDK do Android para App Distribution.

O testador não pode iniciar o feedback no app

Se você já configurou o SDK do Android para App Distribution no seu app para oferecer suporte a feedback no app, mas os testadores não conseguem enviar feedback, siga estas etapas:

1. Ative o registro detalhado do SDK do Android para App Distribution no seu app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Verifique se há mensagens de erro nos registros do app filtrando por "FirebaseAppDistribution".

3. Confirme se o testador tem acesso à versão instalada:

   1. Se os registros indicarem que "o testador não tem acesso a esse recurso", talvez ele não tenha sido convidado para o app ou não tenha acesso à versão.

   2. No painel App Distribution do console do Firebase, localize a versão exata que está em execução no dispositivo do testador e verifique se o testador está listado como "Aceito" na guia Testadores do card de versão.

   Se você ainda não está recebendo feedback, siga estas etapas:

   1. No dispositivo de teste, faça login no Firebase App Distribution usando o App Tester ou o app da Web do testador. Selecione a conta do Google que você usou ao aceitar o convite para testar o app.

   2. Instale o app novamente usando o App Tester ou o app da Web de teste para garantir que o testador tenha acesso à versão.

   3. Tente enviar seu feedback. Novamente, lembre-se de fazer login com a mesma Conta do Google.

4. Verifique se você ativou a API Firebase App Tester. Para mais informações, consulte Ativar a API App Distribution Tester.

5. Em Restrições da chave, verifique se a API Firebase App Tester está incluída na lista de APIs permitidas.

Não estou recebendo feedback enviado no app

1. Se você vir esta mensagem ao enviar feedback, "teria enviado feedback, mas não o fez devido ao modo de desenvolvimento", desative o modo de desenvolvedor no dispositivo executando este comando:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Verifique seu arquivo google-services.json para garantir que você está enviando feedback para o projeto e o app corretos.

3. Ative o registro detalhado do SDK do Android para App Distribution no seu app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Verifique se há mensagens de erro nos registros do app filtrando por "FirebaseAppDistribution".

O testador não está recebendo alertas no app

Se você já configurou o SDK do Android para App Distribution no seu app, mas os testadores não recebem alertas no app, siga estas etapas:

1. Para verificar se há mensagens de erro, anexe um OnFailureListener à tarefa retornada pela API App Distribution do Firebase.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. Verifique se o testador tem acesso à nova versão:

   1. Ative o modo de depuração no seu app. Para saber como, consulte a documentação do Google Analytics.

   2. Execute seu app em um simulador e procure a string "FirebaseAppDistribution".

      Se os registros indicarem que nenhuma versão foi encontrada ou que o testador não tem acesso, talvez ele ainda não esteja associado à nova versão.

   3. 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 alertas, 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:

      1. No dispositivo de teste, faça login no Firebase App Distribution pelo App Tester ou pelo app da Web do testador. Não se esqueça de selecionar a Conta do Google que você usou ao aceitar o convite para testar o app.

      2. Verifique se a nova versão do app está disponível no App Tester ou no app da Web do testador.

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 os recursos de teste. 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 SharedPreferences no logout, 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.

Por quanto tempo as versões do app ficam disponíveis?

As versões do app sã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, a versão é removida do painel do App Distribution e do app Firebase App Tester. 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 APK ou do AAB e exclua a versão do painel do App Distribution. Depois, faça novo upload do APK ou AAB 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 distribuir aos testadores para instalarem usando o app Firebase App Tester no dispositivo de teste.

30 dias após a data de validade da versão, surge uma notificação de expiração no app Firebase App Tester.

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.

Como posso acessar os apps de teste que instalei no meu dispositivo?

Para os testadores, recomendamos fazer o download do Firebase App Tester, um app que permite acessar todos os builds de teste em um só lugar.

Há limites de cota para o recurso Testador automatizado?

O Firebase App Distribution usa a infraestrutura do Firebase Test Lab. Os limites de cota e preços são os mesmos. As cotas de teste são medidas pelo número de testes executados por dia. Para saber mais sobre como testar cotas e faturamento, consulte Níveis de uso, cotas e preços do Test Lab.

Quais são os limites de nova tentativa de cota do recurso Testador automatizado?

Se você exceder a cota, vai receber erros de cota excedida. As cotas demoram cerca de 24 horas para serem redefinidas. Evite novas tentativas até que a cota seja liberada. No entanto, se você receber erros relacionados à infraestrutura do Testador automatizado, as chamadas terão mais chances de sucesso se você fizer nova tentativa imediatamente.

Quais permissões são necessárias para executar o recurso Beta Testador automatizado?

Você vai precisar de acesso de editor no projeto do Firebase para executar os testes com o recurso Testador automatizado.

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:

1. Acesse https://appdistribution.firebase.google.com e faça login com sua Conta do Google.

2. No canto superior direito, clique em (Gerenciar conta).

   Excluir conta.

3. 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.