Esta página fornece ajuda para solução de problemas e respostas para 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 app <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 Firebase e o identificador do aplicativo.
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 esse problema, siga estas etapas:
Verifique o tamanho do IPA. O limite máximo de tamanho de arquivo para todos os binários é de 2.048 MiB, um pouco mais de 2 GB.
Se o tamanho do IPA estiver dentro do limite de tamanho do arquivo e for reproduzível, siga estas etapas:
Verifique seu arquivo
Info.plist
e confirme seCFBundleDisplayName
contém algum delimitador<array>
.Remova os delimitadores
<array>
e reconstrua seu aplicativo. O upload deve ser bem-sucedido.Se você ainda estiver com 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 use esse e-mail para fazer login.
Ao escolher um e-mail alternativo, o testador deve seguir estas diretrizes:
- 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, o testador pode não conseguir ver os aplicativos ou compilações corretos.
O e-mail para o qual o desenvolvedor envia convites e adiciona novos builds (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 e-mail A é adicionado a novas compilações, na verdade é o e-mail B que está obtendo 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 guia Testers & Groups na página App Distribution do Firebase console. 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 aceite o convite com o mesmo endereço de e-mail.
Os testadores podem 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 para a conta de e-mail para a qual o convite foi originalmente enviado.
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á notificações de versão automaticamente 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 todos os 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 nova assinatura de e-mails .
Solução 2
Exclua o testador da guia Testers & Groups na página App Distribution no Firebase console. 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 aceite 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 confia 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 Necessário modo de desenvolvedor aparece quando você tenta iniciar um aplicativo iOS provisionado ad hoc no iOS 16 ou posterior sem antes ativar o modo de desenvolvedor.
Para ativar o modo de desenvolvedor e resolver esse erro, siga estas etapas:
- No seu iPhone, abra o aplicativo Configurações e toque em Privacidade e segurança .
- Role para baixo até Segurança e toque em Modo de desenvolvedor .
- Toque no controle deslizante do modo de desenvolvedor .
- Toque em Reiniciar .
- Depois que o dispositivo for reiniciado, desbloqueie o dispositivo. Ativar modo de desenvolvedor? caixa de diálogo aparece.
- Toque em Ligar . 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 configurou seu aplicativo para ser executado em seu 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 o convite para testar o aplicativo. Tente novamente fazendo login com a conta do Google que você usou 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 apps. O acesso é determinado pelo administrador do domínio da sua conta no Google Workspace.
Se você acredita que deve 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 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.
Habilitando alertas no aplicativo com o App Distribution iOS SDK
Use as dicas a seguir para solucionar problemas que envolvem a ativação de novos alertas de compilação no aplicativo usando o SDK do iOS do App Distribution.
Se você já configurou o SDK para 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 liberação válido for retornado, é provável que haja um problema no ciclo de vida do controlador de exibição em que a caixa de diálogo de alerta é carregada antes que a exibição apareça.
Se nenhuma versão for retornada, seu testador pode 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 compilação e esteja no estado Aceito .
Se o seu testador ainda não estiver recebendo atualizações, peça a ele 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 clipe da Web do Firebase App Distribution. Lembre-se de selecionar a conta do 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 clipe da web.
Por padrão, seus testadores só precisam fazer login na conta do Google uma vez para ativar novos alertas de compilação e instalar novas compilações. Se seus testadores estão sendo solicitados a entrar novamente depois de fechar e reabrir seu aplicativo, siga estas dicas para garantir que a configuração do App Distribution esteja configurada corretamente:
Verifique se você ativou a API Firebase App Testers. Para obter mais informações, consulte Ativar a API App Distribution Tester .
Em Restrições de chave , verifique se a API Firebase App Testers está incluída na lista de APIs permitidas.
Se você normalmente limpa os padrões do usuário ao sair, pode estar limpando o estado do seu testador. O App Distribution armazena um sinalizador que indica se o testador já se conectou ao aplicativo. Para obter mais informações, consulte o repositório do GitHub .
Perguntas frequentes
O Firebase App Distribution tem os seguintes limites de testador:
Adicione no máximo 500 testadores a um projeto do Firebase
Adicione no máximo 200 testadores a um grupo de distribuição de aplicativos
Para adicionar mais testadores, solicite um aumento de limite sem custo .
Os testadores têm 30 dias para aceitar um convite para testar o aplicativo antes que ele expire. Quando faltam 5 dias para um convite expirar, 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 do aplicativo são removidas do App Distribution se ocorrer uma das seguintes condições:
- A versão do aplicativo tem mais de 150 dias.
- Você excedeu o limite de 1.000 versões de aplicativos e a versão do aplicativo é anterior às 1.000 versões de aplicativos mais recentes.
Para obter mais informações, consulte O App Distribution suporta no máximo 1.000 lançamentos .
Depois que o aplicativo atinge ou excede o limite de expiração de 150 dias ou o limite de 1.000 lançamentos de aplicativos, o lançamento é removido do painel do App Distribution e do aplicativo da web do testador do App Distribution. Se o testador instalou a versão, a versão local do aplicativo continua em execução.
Para manter o lançamento do aplicativo disponível por mais tempo, use uma das seguintes recomendações:
- Antes que o lançamento do aplicativo expire ou exceda o limite de lançamento, baixe o IPA e exclua o lançamento do painel do App Distribution. Em seguida, recarregue o IPA como um novo build para o App Distribution.
- Baixe a versão e carregue-a no Cloud Storage para arquivamento de longo prazo.
As versões de aplicativos expiram após 150 dias
Quando você carrega 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 carregar a versão, você pode distribuí-la aos testadores, que instalam a versão do aplicativo da Web do testador do App Distribution em seu dispositivo de teste.
Quando o lançamento estiver 30 dias após a data de vencimento, uma notificação de vencimento do lançamento do aplicativo aparecerá em seu lançamento na página App Distribution do Firebase console e no app da 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 os lançamentos mais antigos acima do limite.
Se você deseja gerenciar manualmente as versões do aplicativo, use a API REST do App Distribution para listar e excluir as versões do aplicativo em massa.
Em caso de dúvidas, entre em contato com o suporte do Firebase .
O perfil do Firebase é um perfil de configuração que permite que o App Distribution:
Registre o dispositivo de teste coletando a ID de dispositivo exclusiva (UDID) do dispositivo. 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 compilação possa ser testada em seu dispositivo.
Instale um web clip 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 compilações que você for convidado a testar são adicionadas automaticamente ao clipe da web.
Para obter ajuda sobre como instalar perfis de configuração em seu dispositivo iOS, consulte a documentação da Apple .
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 seu dispositivo de teste quando você instala o perfil do Firebase. Se estiver testando uma distribuição Ad Hoc, primeiro você deve instalar o perfil antes de poder testar o aplicativo.
Se estiver testando uma distribuição Enterprise, você pode instalar manualmente o perfil:
Se ainda não o fez, faça login no Google e aceite o convite.
Em Aplicativos de teste , 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 )Excluir 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 de testador.