Esta página fornece ajuda para solução de problemas e respostas a perguntas frequentes sobre distribuição e teste de aplicativos com o App Distribution.
Distribuindo aplicativos
Use as dicas a seguir para solucionar problemas que você pode encontrar ao distribuir aplicativos para seus testadores.
Ao fazer upload de um aplicativo, você pode encontrar este erro:
"Não foi possível encontrar um e-mail de contato para o aplicativo <app-id> . Visite o App Distribution no console do 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 .
Se você encontrar repetidamente os erros 400, 409 ou 500 durante o provisionamento, entre em contato com o suporte do Firebase . Forneça ao suporte o número do seu projeto do Firebase e o identificador do aplicativo.
Verifique o tamanho do APK. O limite máximo de tamanho de arquivo para todos os binários é 2.048 MiB, um pouco mais de 2 GB.
Se o tamanho do APK estiver dentro do limite de tamanho de arquivo e for reproduzível, entre em contato com o suporte do Firebase .
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
Distribuindo Android App Bundles (AABs)
Quando você faz upload de um AAB para o App Distribution, o Google Play renuncia automaticamente ao APK gerado usando um certificado de chave de assinatura de aplicativo de teste. Quando solicitado, você deverá registrar seu aplicativo nos provedores de API se quiser continuar usando os serviços de terceiros. Depois de assinado, o certificado de teste do seu aplicativo poderá ser visualizado no console do Firebase.
As compilações AAB que você carrega no App Distribution não aparecem na sua conta de desenvolvedor do Google Play (isso inclui o App Bundle Explorer e o compartilhamento interno de aplicativos).
Se um aplicativo Firebase para Android for desvinculado do Google Play, acontecerá o seguinte:
Você não poderá fazer upload de novos pacotes de aplicativos para o App Distribution e exportá-los para o Google Play por meio da integração do App Distribution com o Google Play.
As compilações existentes continuarão disponíveis no painel do Firebase App Distribution e para seus testadores.
Todos os dados exportados anteriormente entre o Firebase e o Google Play permanecerão acessíveis em ambos os produtos.
Para distribuir um Android App Bundle (AAB) por meio do App Distribution e vincular automaticamente os AABs enviados ao seu projeto do Firebase e à sua conta de desenvolvedor do Google Play, atenda aos seguintes requisitos:
Sua conta de desenvolvedor do Google Play tem um dos seguintes níveis de acesso : Proprietário ou Administrador.
Para seu projeto do Firebase, você tem uma das seguintes funções: Proprietário ou Administrador do Firebase .
Seu aplicativo está registrado no Firebase e na sua conta de desenvolvedor do Google Play. Isso significa que você tem um aplicativo Firebase para Android e um aplicativo Google Play.
O aplicativo no Google Play e o aplicativo Firebase para Android são registrados usando o mesmo nome de pacote.
O aplicativo no Google Play é configurado no painel do aplicativo e distribuído para uma das faixas do Google Play (teste interno, teste fechado, teste aberto ou produção).
A análise do aplicativo no Google Play foi concluída e o aplicativo foi publicado. Seu aplicativo será publicado se a coluna Status do aplicativo exibir um dos seguintes status: Teste interno (não teste interno de rascunho), Teste fechado, Teste aberto ou Produção.
Se você fez upload de um aplicativo que anteriormente não atendia aos critérios listados acima para vinculação, mas agora atende, tente vincular novamente seu aplicativo Firebase para Android ao Google Play .
Instalando e testando aplicativos
Use as dicas a seguir para solucionar problemas que seus testadores podem encontrar ao instalar e testar seus aplicativos.
Quando um usuário cria uma conta do Google, ele recebe automaticamente um endereço do Gmail.
Se um testador não tiver um endereço do Google Workspace ou do Gmail, ou se preferir usar outro endereço de e-mail para fazer login, peça ao testador para vincular um endereço de e-mail que não seja do Gmail à conta e usar esse e-mail para fazer login.
Ao escolher um e-mail alternativo, o testador deve seguir estas orientações:
- Não use um endereço do Gmail.
- Não use um endereço de e-mail que já esteja vinculado a outra conta do Google.
- Lembre-se de usar a senha da sua Conta do Google ao fazer login com este endereço de e-mail.
Para obter mais informações, consulte Faça login na sua Conta do Google com outro endereço de e-mail .
Se o testador aceitou o convite por e-mail com um endereço de e-mail diferente daquele para o qual o convite foi enviado, talvez o testador não consiga ver os aplicativos ou compilações corretos.
O e-mail para o qual o desenvolvedor envia convites e adiciona a novas compilações (E-mail A) pode ser diferente do e-mail que o testador usa para aceitar o convite (E-mail B). Isso cria um link nos bastidores. Sempre que o Email A é adicionado a novas compilações, é na verdade o Email B que obtém acesso.
Se o testador aceitou o convite por e-mail com um endereço de e-mail diferente, siga estas etapas para resolver o problema:
Exclua o testador da seção Exibir todos os testadores da guia Testadores e grupos na página Distribuição de aplicativos do console do Firebase. Os convites existentes são removidos.
Convide novamente o testador para testar seu aplicativo. O testador deve receber um e-mail de convite.
Certifique-se de que o testador aceita o convite com o mesmo endereço de e-mail.
Os testadores poderão não receber notificações por e-mail se ocorrer uma das seguintes situações:
As notificações por e-mail são enviadas para pastas de spam.
Os filtros de e-mail estão definidos.
O convite foi enviado para uma conta de e-mail, mas o testador aceitou com uma conta de e-mail diferente. O testador recebe novos e-mails de lançamento da conta de e-mail para a qual o convite foi enviado originalmente.
O testador foi convidado anteriormente, mas não aceitou o convite inicial. Se o testador for adicionado a versões subsequentes, o App Distribution não enviará automaticamente notificações de lançamento para esse testador porque o testador não aceitou o convite inicial.
Solução 1
Peça ao testador para verificar sua pasta de spam e quaisquer filtros de e-mail definidos em seu serviço de e-mail.
Se o testador cancelou a assinatura dos e-mails, peça ao testador para fazer o seguinte:
- Encontre um e-mail que o testador recebeu anteriormente do aplicativo.
- Clique em Gerenciar configurações de e-mail na parte inferior e clique em Permitir assinatura de e-mail novamente.
Solução 2
Se o testador não quiser receber notificações por e-mail, mas quiser aceitar convites de aplicativos, ele poderá visualizar os convites de aplicativos pendentes diretamente no aplicativo App Tester ( instruções de download ).
Solução 3
Exclua o testador da seção Visualizar todos os testadores da guia Testadores e grupos na página Distribuição de aplicativos no console do Firebase. Esta ação remove os convites existentes.
Convide novamente o testador para testar seu aplicativo. O testador deve receber um e-mail de convite. Certifique-se de que o testador aceita o convite com o mesmo endereço de e-mail para o qual o convite foi enviado.
Se um testador baixar e instalar uma versão, mas a interface do usuário de detalhes do aplicativo não mostrar que o aplicativo está instalado, esse é um problema conhecido. Em alguns casos, o ID do pacote no aplicativo Firebase não corresponde ao ID do pacote do APK.
Verifique se o ID do pacote do APK corresponde ao ID do pacote do aplicativo Firebase que você usou para fazer upload da distribuição.
O alerta do Android aparece se o seu aplicativo ou navegador em execução ainda não tiver permissão para instalar aplicativos fora do Google Play. Para conceder permissão:
Android versão 8 ou posterior : no aplicativo Configurações , toque em Permitir desta fonte .
Android versão 7 ou anterior : no aplicativo Configurações , toque em Segurança e selecione Fontes desconhecidas . Quando o prompt aparecer, toque em OK > Confiar .
Se um APK de teste não for instalado no dispositivo do testador:
- Verifique se os certificados da nova versão correspondem aos da versão instalada no dispositivo do testador. O sistema Android só permite a atualização do aplicativo se os certificados corresponderem. Para saber mais, consulte Considerações sobre assinatura .
- Certifique-se de que a versão do sistema operacional do dispositivo testador seja compatível com o aplicativo (verifique
minSdkVersion).
Se o aplicativo App Tester impedir você de fazer login e redirecioná-lo de volta para a tela de login, você pode estar usando um Google Workspace (antigo GSuite) que inclui configurações de restrição.
Para remover suas configurações de restrição:
Na guia Aplicativos do seu Google Workspace, certifique-se de que o Firebase App Distribution não esteja definido como Access: Blocked .
Na guia Serviços , certifique-se de que o Cloud Platform seja irrestrito.
Depois que as configurações forem removidas, tente fazer login novamente.
Este erro pode ocorrer quando o aplicativo instalado entra em conflito com um aplicativo já instalado no dispositivo. Por exemplo, pode ser uma variante diferente do mesmo aplicativo com a mesma permissão personalizada ou nome ContentProvider .
Você pode pedir ao testador para coletar um relatório de bug imediatamente após enfrentar o problema e inspecionar o relatório para obter mais informações sobre a causa. O testador deve excluir todos os aplicativos conflitantes antes que o novo aplicativo possa ser instalado.
Quando você encontra um erro 403, isso significa que a conta que você está usando não tem permissão para instalar e testar aplicativos. O acesso é determinado pelo administrador do domínio da sua conta no Google Workspace.
Se você acredita que deveria ter permissão para instalar e testar apps, peça ao administrador da conta do Google Workspace para alterar as configurações da sua conta. Seu administrador deve seguir as instruções em Gerenciar o acesso a serviços que não são controlados individualmente .
Se você tiver várias contas, tente fazer login com uma conta diferente que não esteja restrita à instalação e teste de aplicativos.
Se você for um testador iniciante, consulte Prepare-se como testador .
Se você já é um testador do App Distribution e tem um novo dispositivo Android para testar, em vez de passar por todo o fluxo do novo testador novamente, siga estas etapas:
Navegue até appdistribution.firebase.google.com em seu dispositivo Android.
Faça login com sua conta de testador existente e clique no botão Baixar App Tester na parte inferior da tela para instalar o aplicativo Android App Tester.
Ativando recursos de testador com o SDK do Android do App Distribution
Use as dicas a seguir para solucionar problemas que envolvem a ativação de alertas de nova compilação no aplicativo ou o envio de comentários no aplicativo usando o SDK do Android do App Distribution.
Se você já configurou o SDK do Android do App Distribution em seu aplicativo para oferecer suporte a feedback no aplicativo e seus testadores não conseguem enviar feedback, siga estas etapas:
Ative o registro detalhado para o SDK do Android do App Distribution em seu aplicativo:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEVerifique se há mensagens de erro nos registros do seu aplicativo filtrando por "FirebaseAppDistribution".
Confirme se o testador tem acesso à versão instalada:
Se os registros indicarem que "o testador não tem acesso a este recurso", seu testador pode não ter sido convidado para o aplicativo ou pode não ter acesso à versão.
No painel do App Distribution do console do Firebase, encontre a versão exata que está em execução no dispositivo do testador e verifique se o testador está listado na guia Testadores no cartão de versão e se está no estado Aceito.
Se você ainda não estiver recebendo feedback, siga estas etapas:
No dispositivo de teste, faça login no Firebase App Distribution usando o App Tester ou o aplicativo Web testador. Certifique-se de selecionar a conta do Google que você usou pela primeira vez quando aceitou o convite para testar o aplicativo.
Instale o aplicativo novamente usando o App Tester ou o aplicativo web de teste para garantir que o testador tenha acesso à versão.
Tente enviar feedback, certificando-se novamente de fazer login com a mesma conta do Google.
Certifique-se de ativar a API Firebase App Testers. Para obter mais informações, consulte Habilitar a API App Distribution Tester .
Em Restrições de chave , certifique-se de que a API Firebase App Testers esteja incluída na lista de APIs permitidas.
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 falseVerifique seu arquivo
google-services.jsonpara ter certeza de que está enviando feedback sobre o projeto e aplicativo corretos.Ative o registro detalhado para o SDK do Android do App Distribution em seu aplicativo:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEVerifique se há mensagens de erro nos registros do seu aplicativo filtrando por "FirebaseAppDistribution".
Se você já configurou o SDK do Android do App Distribution em seu aplicativo e seus testadores não estão recebendo alertas no aplicativo, siga estas etapas:
Verifique se há mensagens de erro anexando um
OnFailureListenerà tarefa retornada pela API Firebase App Distribution.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }Verifique se o testador tem acesso à nova versão:
Ative o modo de depuração em seu aplicativo. Para saber como, consulte a documentação do Google Analytics .
Execute seu aplicativo em um simulador e procure a string "FirebaseAppDistribution".
Se os logs indicarem que nenhuma versão foi encontrada ou que o testador não tem acesso, é possível que seu testador ainda não esteja associado à nova versão.
No painel de distribuição de aplicativos do console do Firebase, certifique-se de que seu testador esteja incluído em sua distribuição de build e esteja no estado Aceito .
Se o testador ainda não estiver recebendo alertas, peça-lhe que siga as dicas abaixo para garantir que aceitou o convite para testar seu aplicativo e que configurou o dispositivo de teste corretamente:
No dispositivo de teste, faça login no Firebase App Distribution por meio do App Tester ou do aplicativo Web testador. Lembre-se de selecionar a conta Google que você usou pela primeira vez quando aceitou o convite para testar o aplicativo.
Verifique se a nova versão do aplicativo está disponível no App Tester ou no aplicativo web do testador.
Por padrão, seus testadores só precisam fazer login na conta do Google uma vez para ativar os recursos de teste. Se seus testadores forem solicitados a fazer login novamente após fechar e reabrir seu aplicativo, siga estas dicas para garantir que a configuração do App Distribution esteja definida corretamente:
Verifique se você ativou a API Firebase App Testers. Para obter mais informações, consulte Habilitar a API App Distribution Tester .
Em Restrições de chave , certifique-se de que a API Firebase App Testers esteja incluída na lista de APIs permitidas.
Se você normalmente limpa SharedPreferences ao sair, você pode estar limpando o estado do seu testador. O App Distribution armazena um sinalizador que indica se o testador já fez login no aplicativo. Para obter mais informações, consulte o repositório GitHub .
Perguntas frequentes
O Firebase App Distribution tem os seguintes limites de testadores:
Adicione no máximo 500 testadores a um projeto do Firebase
Adicione no máximo 200 testadores a um grupo do App Distribution
Para adicionar mais testadores, solicite um aumento de limite sem custos financeiros .
Os testadores têm 30 dias para aceitar um convite para testar o aplicativo antes que ele expire. Quando faltam cinco dias para a expiração de um convite, um aviso de expiração aparece no Console do Firebase ao lado do testador em uma versão. Um convite pode ser renovado reenviando-o por meio do menu suspenso na linha do testador.
As versões de aplicativos serão removidas do App Distribution se ocorrer uma das seguintes condições:
- O lançamento do aplicativo tem mais de 150 dias.
- Você excedeu o limite de 1.000 lançamentos de aplicativos, e o lançamento do aplicativo é anterior aos 1.000 lançamentos de aplicativos mais recentes.
Para obter mais informações, consulte O App Distribution suporta no máximo 1.000 versões .
Depois que o aplicativo atingir ou exceder o limite de expiração de 150 dias ou o limite de 1.000 versões, a versão será removida do painel do App Distribution e do aplicativo Firebase App Tester. Se o seu testador tiver instalado a versão, a versão local do aplicativo continuará em execução.
Para manter a versão do aplicativo disponível por mais tempo, use uma das seguintes recomendações:
- Antes que a versão do aplicativo expire ou exceda o limite de lançamento, baixe o APK ou AAB e exclua a versão do painel do App Distribution. Em seguida, faça upload novamente do APK ou AAB como uma nova versão para o App Distribution.
- Faça download da versão e faça upload dela no Cloud Storage para arquivamento de longo prazo.
As versões de aplicativos expiram após 150 dias
Quando você faz upload de uma versão do seu aplicativo para o Firebase, a versão aparece no painel do App Distribution por 150 dias, a partir da data de upload. Depois de fazer upload da versão, você poderá distribuí-la aos testadores, que instalarão a versão do aplicativo Firebase App Tester em seus dispositivos de teste.
Quando a versão estiver 30 dias após a data de expiração, uma notificação de expiração da versão do aplicativo aparecerá na sua versão no aplicativo Firebase App Tester.
O App Distribution suporta no máximo 1.000 lançamentos
O App Distribution permite no máximo 1.000 lançamentos por aplicativo. Quando seu aplicativo atinge o limite de 1.000 lançamentos de aplicativos, o App Distribution exclui automaticamente as versões mais antigas acima do limite.
Se você quiser gerenciar manualmente as versões do seu aplicativo, use a API REST do App Distribution para listar e excluir as versões do aplicativo em massa.
Se você tiver dúvidas, entre em contato com o suporte do Firebase .
Se você for um testador, recomendamos baixar o Firebase App Tester , um aplicativo que permite acessar todos os seus builds de teste em um só lugar.
O Firebase App Distribution usa a infraestrutura do Firebase Test Lab e seus limites de cota e preços são os mesmos. As cotas de testes são medidas pelo número de testes executados por dia. Para saber mais sobre cotas de teste e cobrança, consulte Níveis de uso, cotas e preços do Test Lab .
Se você exceder a cota, receberá erros de cota excedida. As cotas levam cerca de 24 horas para serem redefinidas, portanto, evite novas tentativas até que a cota seja liberada. No entanto, se você receber erros relacionados à infraestrutura do testador automatizado, é mais provável que as chamadas sejam bem-sucedidas se você tentar novamente imediatamente.
Você precisará ter acesso de editor no projeto Firebase para executar testes com o recurso Automated Tester.
Para excluir sua conta de testador do App Distribution e seus dados associados, siga estas etapas na ordem:
Visite https://appdistribution.firebase.google.com e faça login com sua conta do Google.
No canto superior direito, clique em ( Gerenciar conta )
Deletar conta .
Opcional: nas permissões da sua conta do Google , revogue o acesso do Firebase App Distribution. Observe que revogar o acesso sem primeiro excluir sua conta do App Distribution não exclui sua conta ou dados do testador.