Este guia descreve como fazer upload de Android App Bundles (AABs) para o App Distribution e distribuir APKs gerados usando o Firebase console.
O App Distribution se integra ao serviço interno de compartilhamento de aplicativos do Google Play para processar os AABs que você carrega e veicular APKs otimizados para as configurações do dispositivo de seus testadores. A distribuição de AABs permite fazer o seguinte:
Execute APKs otimizados (servidos pelo Google Play) otimizados para os dispositivos de seus testadores.
Descubra e depure problemas específicos do dispositivo.
Teste os recursos do pacote de apps, como o Play Feature Delivery e o Play Asset Delivery .
Reduza o tamanho dos downloads para seus testadores.
Permissões necessárias
Para fazer upload de AABs para o App Distribution, você deve vincular seu aplicativo Firebase a um aplicativo no Google Play . Você deve ter o nível de acesso necessário para executar essas ações.
Se você não tiver o acesso necessário ao Firebase, poderá solicitar a um proprietário de projeto do Firebase que atribua a você a função aplicável por meio das configurações de IAM do console do Firebase . Se você tiver dúvidas sobre como acessar seu projeto do Firebase, incluindo encontrar ou atribuir um proprietário, consulte as perguntas frequentes sobre "Permissões e acesso a projetos do Firebase" .
A tabela a seguir se aplica à vinculação de um aplicativo Firebase a um aplicativo no Google Play, bem como ao upload de AABs.
| Ação no console do Firebase | Permissão de IAM necessária | Funções do IAM que incluem as permissões necessárias por padrão | Função(ões) adicional(is) necessária(s) |
|---|---|---|---|
| Vincule um aplicativo Firebase a um aplicativo no Google Play | firebase.playLinks.update | Uma das seguintes funções: | Acesso a uma conta de desenvolvedor do Google Play como administrador |
| Carregar AABs para distribuição de aplicativos | firebaseappdistro.releases.update | Uma das seguintes funções: | –– |
Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto Android . Ao final deste fluxo de trabalho, você terá um aplicativo Firebase para Android em seu projeto Firebase.
Se você não estiver usando nenhum outro produto Firebase, basta criar um projeto e registrar seu aplicativo. Se você decidir usar produtos adicionais, conclua todas as etapas em Adicionar Firebase ao seu projeto Android .
Para criar um link do Firebase para o Google Play e fazer upload de AABs, certifique-se de que seu aplicativo atenda aos seguintes requisitos:
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 está 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.
Vincule seu aplicativo Firebase para Android à sua conta de desenvolvedor do Google Play:
No console do Firebase, acesse suas projeto e selecione a guia Integrações .
No cartão do Google Play , clique em Link .
Se você já tiver links para o Google Play, clique em Gerenciar .Siga as instruções na tela para habilitar a integração do App Distribution e selecione quais Firebase Android Apps vincular ao Google Play.
Saiba mais sobre como vincular ao Google Play .
Etapa 1. Crie seu aplicativo
Quando estiver pronto para distribuir uma versão de pré-lançamento do seu aplicativo para testadores, crie seu AAB (visite a documentação do Android Studio para obter instruções).
Etapa 2. Distribua seu aplicativo para testadores
Para distribuir seu app aos testadores, faça upload do arquivo AAB usando o Firebase console:
Abra a página App Distribution do Firebase console. Selecione seu projeto do Firebase quando solicitado.
Na página Releases , selecione o aplicativo que deseja distribuir no menu suspenso.
Arraste o arquivo AAB do seu aplicativo para o console para carregá-lo.
Quando o upload for concluído, especifique os grupos de testadores e os testadores individuais que você deseja que recebam o build. Em seguida, adicione notas de versão para o build.
Consulte Gerenciar testadores para saber mais sobre como criar grupos de testadores.
Clique em Distribuir para disponibilizar a compilação para os testadores. O testador recebe automaticamente um convite por e-mail para testar o aplicativo.
(Opcional) Para compartilhar links para versões específicas com testadores que tenham acesso a essas versões, clique no ícone Link para copiar o link da versão para a área de transferência.
Depois de distribuir seu build, ele fica disponível no painel App Distribution do Firebase console por 150 dias (cinco meses). Quando a compilação estiver faltando 30 dias para expirar, um aviso de expiração aparecerá no console e na lista de compilações do testador em seu dispositivo de teste.
Os testadores que não foram convidados para testar o aplicativo recebem convites por e-mail para começar, e os testadores existentes recebem notificações por e-mail de que uma nova compilação está pronta para teste. Para obter instruções sobre como instalar o aplicativo de teste, consulte Configurar como um testador com o App Distribution . Você pode monitorar o status de cada testador - se eles aceitaram o convite e se baixaram o aplicativo - no Firebase console.
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 usando o menu suspenso na linha do testador.
Próximos passos
Conheça as práticas recomendadas para distribuição de aplicativos Android para testadores de controle de qualidade usando CI/CD .