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.
A seguir está 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 esse problema, siga estas etapas:
Verifique o tamanho do IPA. 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 IPA estiver dentro do limite de tamanho de arquivo e for reproduzível, siga estas etapas:
Verifique seu arquivo
Info.pliste confirme seCFBundleDisplayNamecontém algum delimitador<array>.Remova os delimitadores
<array>e reconstrua seu aplicativo. O upload deve ser bem-sucedido.Se você ainda estiver enfrentando problemas, entre em contato com o suporte do Firebase .
Se o tamanho do IPA estiver acima do limite de tamanho do arquivo, faça as alterações necessárias para diminuir o tamanho do arquivo.
Se diminuir o tamanho do arquivo IPA não resolver o problema, entre em contato com o suporte do Firebase e pergunte sobre o uso do Testflight .
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 se importar em receber notificações por e-mail e apenas quiser aceitar convites de aplicativos, ele poderá visualizar convites de aplicativos pendentes diretamente no web clip do Firebase App Distribution: appdistribution.firebase.google.com .
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.
O erro Untrusted Enterprise Developer aparece se você não confiou no certificado de desenvolvedor no dispositivo de teste antes de abrir o aplicativo. Na tela Configurações do aplicativo> Perfis e gerenciamento de dispositivos , selecione o nome do desenvolvedor do aplicativo e confie nele.
O erro Modo de desenvolvedor obrigatório aparece quando você tenta iniciar um aplicativo iOS provisionado ad hoc no iOS 16 ou posterior sem primeiro ativar o Modo de desenvolvedor.
Para ativar o modo de desenvolvedor e resolver esse erro, siga estas etapas:
- No seu iPhone, abra o aplicativo Ajustes e toque em Privacidade e segurança .
- Role para baixo até Segurança e toque em Modo de desenvolvedor .
- Toque no controle deslizante Modo de desenvolvedor .
- Toque em Reiniciar .
- Depois que o dispositivo for reiniciado, desbloqueie-o. A opção Ativar modo de desenvolvedor? caixa de diálogo aparece.
- Toque em Ativar . Agora você pode iniciar seu aplicativo e começar a testar.
Se você estiver instalando uma distribuição Ad Hoc, esta mensagem aparecerá quando o desenvolvedor ainda não tiver configurado o aplicativo para execução no dispositivo de teste. Para disponibilizar o aplicativo para você, o desenvolvedor deve seguir as instruções em Registrar dispositivos adicionais .
Se sua conta do Google não tiver acesso a um aplicativo de teste que você instalou anteriormente (ou para o qual aceitou um convite), é provável que você tenha feito login na conta do Google errada. Os aplicativos aos quais você tem acesso estão associados à conta do Google que você usou quando aceitou pela primeira vez o convite para testar o aplicativo. Tente novamente fazendo login com a conta do Google usada anteriormente para aceitar o convite.
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.
Ativando alertas no aplicativo com o SDK do App Distribution para iOS
Use as dicas a seguir para solucionar problemas que envolvem a ativação de alertas de nova compilação no aplicativo usando o SDK do iOS do App Distribution.
Se você já configurou o SDK do iOS do App Distribution em seu aplicativo e seus testadores não estão recebendo alertas no aplicativo, verifique se seu aplicativo está buscando novos lançamentos:
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 "[Firebase/AppDistribution]".
Verifique se o testador tem acesso à nova versão:
Se um objeto de lançamento válido for retornado, é provável que haja um problema no ciclo de vida do View Controller em que a caixa de diálogo de alerta é carregada antes que o View apareça.
Se nenhuma versão for retornada, seu testador poderá ainda não estar associado à nova versão. No painel App Distribution do Firebase console, 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 atualizações, peça que ele 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 web clip do Firebase App Distribution. Lembre-se de selecionar a conta Google que você usou pela primeira vez quando aceitou o convite para testar o aplicativo.
Certifique-se de que a nova versão do aplicativo esteja disponível no web clip.
Por padrão, seus testadores só precisam fazer login na conta do Google uma vez para ativar alertas de novos builds e instalar novos builds. 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 UserDefaults 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.
Consulte Registrar dispositivos adicionais .
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 lançamentos de aplicativos, o lançamento será removido do painel do App Distribution e do aplicativo web do testador do App Distribution. 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 versão, baixe o IPA e exclua a versão do painel do App Distribution. Em seguida, faça upload novamente do IPA 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 instalam a versão do aplicativo da web do testador do App Distribution 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, na página App Distribution do console do Firebase e no aplicativo Web do testador do App Distribution.
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 .
O perfil do Firebase é um perfil de configuração que permite ao App Distribution:
Registre o dispositivo de teste coletando o ID 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, juntamente com instruções sobre como incluir o dispositivo no perfil de provisionamento do aplicativo para que a versão possa ser testada no seu dispositivo.
Instale um web clip do Firebase App Distribution na tela inicial do seu dispositivo. O web clip permite instalar e acessar todos os seus aplicativos de teste em um só lugar. Novas compilações que você foi convidado a testar são adicionadas automaticamente ao web clip.
Para obter ajuda sobre a instalação de perfis de configuração no seu dispositivo iOS, consulte a documentação da Apple .
Se você for um testador, poderá acessar todos os seus aplicativos de teste com o web clip do Firebase App Distribution , que é adicionado automaticamente à tela inicial do seu dispositivo de teste quando você instala o perfil do Firebase. Se estiver testando uma distribuição Ad Hoc, você deverá primeiro instalar o perfil antes de testar o aplicativo.
Se estiver testando uma distribuição Enterprise, você poderá instalar manualmente o perfil:
Se ainda não o fez, faça login no Google e aceite o convite.
Em Testar aplicativos , selecione o aplicativo que deseja testar.
No canto superior direito da página do aplicativo, toque em mobile_screen_share .
Siga as instruções exibidas para instalar o perfil do Firebase.
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.