Distribuir apps Android para testadores usando o Console do Firebase

Neste guia, vamos descrever como fazer o upload de Android App Bundles (AABs) para o App Distribution. Também mostramos como distribuir os APKs usando o Console do Firebase.

O App Distribution é integrado ao serviço de Compartilhamento interno de apps do Google Play para processar os AABs enviados e disponibilizar APKs otimizados para os Configuradores de dispositivo dos seus testadores. Com a distribuição de AABs, você pode fazer o seguinte:

  • Executar APKs (distribuídos pelo Google Play) que são otimizados para os dispositivos dos seus testadores

  • Descobrir e depurar problemas específicos do dispositivo

  • Testar recursos do pacote de app, como o Play Feature Delivery e o Play Asset Delivery

  • Reduzir o tamanho dos downloads para seus testadores

Permissões necessárias

Para fazer upload de AABs no App Distribution, vincule seu app do Firebase a um aplicativo no Google Play. Você precisa ter o nível de acesso necessário para realizar essas ações.

Se você não tiver o acesso necessário do Firebase, peça a um proprietário de projeto do Firebase para atribuir a você o papel aplicável usando as 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 aos projetos do Firebase.

A tabela a seguir se aplica à vinculação de um app do Firebase a um aplicativo no Google Play e ao upload de AABs.

Ação no Console do Firebase Permissão do IAM obrigatória Papéis do IAM que incluem as permissões necessárias por padrão Outros papéis necessários
Vincular um app do Firebase a um aplicativo no Google Play firebase.playLinks.update Um dos seguintes papéis: Acesso a uma conta de desenvolvedor do Google Play como Administrador
Fazer upload de AABs no App Distribution firebaseappdistro.releases.update Um dos seguintes papéis: ––

Antes de começar

  1. Adicione o Firebase ao seu projeto para Android, caso ainda não tenha feito isso. No final deste fluxo de trabalho, você terá um app Android do Firebase no seu projeto.

    Caso você não use outros produtos do Firebase, basta criar um projeto e registrar seu app. Se quiser usar outros produtos, conclua todas as etapas em Adicionar o Firebase ao seu projeto do Android.

  2. Para criar um link do Firebase para o Google Play e fazer upload de AABs, verifique se seu app atende aos seguintes requisitos:

    • O app no Google Play e o app Android do Firebase são registrados usando o mesmo nome de pacote.

    • O app no Google Play é configurado no painel do app e distribuído para uma das faixas do Google Play: teste interno, teste fechado, teste aberto ou produção.

    • A avaliação do app no Google Play é concluída e ele é publicado. Seu app será publicado se a coluna Status do app exibir um dos seguintes status: teste interno (e não teste interno de rascunho), teste fechado, teste aberto ou produção.

  3. Vincule o app Android do Firebase à sua conta de desenvolvedor do Google Play:

    1. No Console do Firebase, acesse as Configurações do projeto e selecione a guia Integrações.

    2. No card do Google Play, clique em Vincular.
      Se você já tiver links para o Google Play, clique em Gerenciar.

    3. Siga as instruções exibidas na tela para ativar a integração do App Distribution e selecione quais apps Android do Firebase serão vinculados ao Google Play.

    Saiba mais sobre como vincular ao Google Play.

Etapa 1. Criar o aplicativo

Quando quiser distribuir uma versão de pré-lançamento do seu app para os testadores, crie seu AAB. Consulte a documentação do Android Studio para conferir as instruções.

Etapa 2. Distribuir seu aplicativo para os testadores

Para distribuir seu app para os testadores, faça o upload do arquivo AAB usando o Console do Firebase:

  1. Abra a página "App Distribution" do Console do Firebase. Selecione seu projeto do Firebase quando solicitado.

  2. Na página Versões, selecione o app que você quer distribuir no menu suspenso.

  3. Arraste o arquivo AAB do seu app ao console para fazer o upload.

  4. Quando o upload for concluído, especifique os grupos de testadores e os testadores individuais que devem receber o build. Em seguida, adicione notas ao build.

    Consulte Gerenciar testadores para saber mais sobre como criar grupos de testadores.

  5. Clique em Distribuir para disponibilizar o build para os testadores. O testador recebe automaticamente um convite por e-mail para testar o app.

  6. (Opcional) Para compartilhar links de versões específicas com testadores que tenham acesso a elas, clique no ícone Link para copiar o link da versão para a área de transferência.

Depois de distribuir o build, ele fica disponível no painel App Distribution do Console do Firebase por 150 dias (cinco meses). Quando faltarem 30 dias para o vencimento do build, o aviso de expiração vai aparecer no console e na lista de builds do testador no dispositivo de teste.

Os testadores que não foram convidados para testar o app recebem convites por e-mail para iniciar o processo, e os testadores atuais recebem notificações por e-mail informando que um novo build está pronto para ser testado. Acesse Configurar usuários como testadores com o App Distribution para consultar instruções sobre como instalar o app de teste. É possível monitorar o status de cada testador, por exemplo, se ele aceitou o convite e se fez o download do app no Console do Firebase.

Os testadores têm 30 dias para aceitar um convite de teste do app antes que ele expire. Quando faltarem cinco dias para o vencimento do convite, um aviso de expiração vai aparecer no Console do Firebase ao lado do testador em uma versão. Para renovar um convite, reenvie-o usando o menu suspenso na linha do testador.

Próximas etapas