Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Distribuir aplicativos Android para testadores usando a Firebase CLI

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este guia descreve como distribuir Android App Bundles (AABs) para testadores usando a Firebase CLI. A ferramenta CLI permite especificar testadores e notas de versão para uma compilação e, em seguida, distribui a compilação de acordo.

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 testadores. A distribuição de AABs permite que você faça 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 aplicativos, 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, peça 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 do Firebase a um aplicativo no Google Play, bem como ao upload de AABs.

Ação no console do Firebase Permissão do 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 Um dos seguintes papéis: Acesso a uma conta de desenvolvedor do Google Play como administrador
Carregar AABs para o App Distribution firebaseappdistro.releases.update Um dos seguintes papéis: ––

Antes de você começar

  1. Se ainda não o fez, adicione o Firebase ao seu projeto Android . Ao final deste fluxo de trabalho, você terá um Firebase Android App em seu projeto Firebase.

    Se você não estiver usando nenhum outro produto do Firebase, precisará apenas 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 .

  2. 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.

  3. Vincule seu aplicativo Firebase para Android à sua conta de desenvolvedor do Google Play:

    1. No console do Firebase, acesse suas projeto e selecione a guia Integrações .

    2. No cartão do Google Play , clique em Link .
      Se você já tiver links para o Google Play, clique em Gerenciar .

    3. Siga as instruções na tela para ativar a integração do App Distribution e selecione quais aplicativos Android do Firebase devem ser vinculados 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 aplicativo para testadores, faça upload do arquivo do seu aplicativo usando a Firebase CLI:

  1. Instale ou atualize para a versão mais recente da Firebase CLI (recomendamos fazer o download do binário autônomo da CLI específica para seu sistema operacional). Certifique-se de entrar e testar se você pode acessar seus projetos.
  2. Na página App Distribution do Firebase console, selecione o aplicativo que você deseja distribuir e clique em Get started .
  3. Execute o comando appdistribution:distribute para carregar seu aplicativo e distribuí-lo aos testadores. Use os seguintes parâmetros para configurar a distribuição:

    appdistribution: opções de distribuição
    --app

    Obrigatório : o ID do aplicativo Firebase do seu aplicativo. Você pode encontrar o App ID no Firebase console, na página General Settings .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Um token de atualização que é impresso quando você autentica seu ambiente de CI com a Firebase CLI (leia Usar a CLI com sistemas de CI para obter mais informações).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Notas de versão para esta compilação.

    Você pode especificar as notas de versão diretamente:

    --release-notes "Text of release notes"

    Ou especifique o caminho para um arquivo de texto simples:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Os endereços de e-mail dos testadores que você deseja convidar.

    Você pode especificar os testadores como uma lista de endereços de e-mail separados por vírgulas:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Ou você pode especificar o caminho para um arquivo de texto simples contendo uma lista de endereços de e-mail separados por vírgulas:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Os grupos de testadores que você deseja convidar (consulte Gerenciar testadores ). Os grupos são especificados usando aliases de grupo , que você pode pesquisar no console do Firebase.

    Você pode especificar os grupos como uma lista separada por vírgulas:

    --groups "qa-team, trusted-testers"

    Ou você pode especificar o caminho para um arquivo de texto simples contendo uma lista separada por vírgulas de nomes de grupos:

    --groups-file "/path/to/groups.txt"
    --debug

    Um sinalizador que você pode incluir para imprimir a saída de log detalhada.

    Por exemplo:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    Além de distribuir versões, você também pode usar appdistribution:testers:add e appdistribution:testers:remove para convidar novos testadores ou remover testadores existentes do seu projeto do Firebase. Depois que um testador for adicionado ao seu projeto do Firebase, você poderá adicioná-lo a versões individuais. Depois de remover um testador, ele não terá mais acesso às versões do seu projeto. Observe que os testadores que foram removidos recentemente ainda podem manter o acesso às suas versões por um período de tempo.

    Por exemplo:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    Os e-mails do testador devem ser separados por um espaço. Você também pode especificar testadores usando --file /path/to/testers.txt .

Depois de distribuir sua compilação, ela fica disponível no painel do App Distribution do Firebase console por 150 dias (cinco meses). Quando faltam 30 dias para a compilação expirar, um aviso de expiração é exibido 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 versão está pronta para teste (leia o guia de configuração do testador para obter instruções sobre como instalar o aplicativo de teste). Você pode monitorar o status de cada testador - se eles aceitaram o convite e se fizeram o download do aplicativo - no Firebase console.

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 é exibido 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 distribuir aplicativos Android para testadores de controle de qualidade usando CI/CD .