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ê envia e veicular APKs otimizados para as configurações de dispositivo dos seus testadores. Distribuir AABs permite fazer o seguinte:
Execute APKs otimizados (fornecidos pelo Google Play) otimizados para os dispositivos dos seus testadores.
Descubra e depure problemas específicos do dispositivo.
Teste recursos do pacote de aplicativos, como Play Feature Delivery e 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ê precisa vincular seu aplicativo do 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, peça a um proprietário do projeto do Firebase para atribuir a função aplicável a você 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 do Firebase a um aplicativo no Google Play, bem como ao upload de AABs.
Ação no console do Firebase | Permissão IAM necessária | Funções do IAM que incluem as permissões necessárias por padrão | Funções adicionais necessárias |
---|---|---|---|
Vincular um aplicativo do 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
Adicione o Firebase ao seu projeto Android , caso ainda não o tenha feito. Ao final deste fluxo de trabalho, você terá um aplicativo Android do Firebase em seu projeto do 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 o Firebase ao seu projeto Android .
Para criar um link do Firebase para o Google Play e fazer upload de AABs, verifique se seu aplicativo atende 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 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.
Vincule seu aplicativo Firebase para Android à sua conta de desenvolvedor do Google Play:
No console do Firebase, acesse seu
No cartão do Google Play , clique em Link .
Se você já possui links para o Google Play, clique em Gerenciar .Siga as instruções na tela para ativar a integração do App Distribution e selecionar quais aplicativos Firebase para Android 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 aos testadores, crie seu AAB (acesse a documentação do Android Studio para obter instruções).
Etapa 2. Distribua seu aplicativo aos testadores
Para distribuir seu aplicativo aos testadores, faça upload do arquivo AAB usando o console do Firebase:
Abra a página App Distribution do console do Firebase. Selecione seu projeto do Firebase quando solicitado.
Na página Lançamentos , 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 a compilação. Em seguida, adicione notas de versão para a compilação.
Consulte Gerenciar testadores para saber mais sobre como criar grupos de testadores.
Clique em Distribuir para disponibilizar a compilação aos 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 têm 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 sua versão, ela ficará disponível no painel de distribuição de aplicativos do console do Firebase por 150 dias (cinco meses). Quando faltam 30 dias para a expiração da compilação, um aviso de expiração aparece no console e na lista de compilações do testador no 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 ser testada. Para obter instruções sobre como instalar o aplicativo de teste, consulte Configurar como testador com o App Distribution . Você pode monitorar o status de cada testador (se eles aceitaram o convite e se fizeram o download do aplicativo) no Console do Firebase.
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 usando o menu suspenso na linha do testador.
Próximos passos
Implemente feedback no aplicativo para facilitar aos testadores o envio de feedback sobre seu aplicativo (incluindo capturas de tela).
Aprenda como exibir alertas no aplicativo para seus testadores quando novas versões do seu aplicativo estiverem disponíveis para instalação.
Aprenda as práticas recomendadas para distribuir aplicativos Android para testadores de controle de qualidade usando CI/CD .