获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Distribuir aplicativos Android para testadores usando a Firebase CLI

Este guia descreve como distribuir APKs para testadores usando a Firebase CLI. A ferramenta CLI permite especificar testadores e notas de versão para uma compilação e, em seguida, distribuir a compilação de acordo.

Antes de você começar

Se ainda não o fez, adicione o Firebase ao seu projeto Android .

Se você não estiver usando nenhum outro produto Firebase, basta criar um projeto e registrar seu aplicativo. No entanto, se você decidir usar produtos adicionais no futuro, certifique-se de concluir todas as etapas na página vinculada acima.

Etapa 1. Crie seu aplicativo

Quando estiver pronto para distribuir uma versão de pré-lançamento do seu aplicativo para testadores, crie seu APK usando seu processo normal. Você deve assinar o APK com sua chave de depuração ou chave de assinatura do app.

Etapa 2. Distribua seu aplicativo para testadores

Para distribuir seu app aos testadores, faça upload do arquivo do app 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 para a CLI específica do seu sistema operacional). Certifique-se de entrar e testar se você pode acessar seus projetos.
  2. Na página Distribuição de aplicativos do Firebase console, selecione o aplicativo que deseja distribuir e clique em Começar .
  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: distribui opções
    --app

    Obrigatório : o ID do app Firebase do seu app. 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 Use 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 separada por vírgulas de endereços de e-mail:

    --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 apelidos de grupo , que você pode procurar 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.apk  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    A Firebase CLI gera os links a seguir após o upload da versão. Esses links ajudam você a gerenciar binários e garantir que os testadores e outros desenvolvedores tenham a versão correta:

    • firebase_console_uri - Um link para o console do Firebase exibindo uma única versão. Você pode compartilhar este link com outros desenvolvedores em sua organização.
    • testing_uri - Um link para a versão na experiência do testador (aplicativo nativo do Android) que permite aos testadores visualizar as notas da versão e instalar o aplicativo em seus dispositivos. O testador precisa acessar a versão para usar o link.
    • binary_download_uri - Um link assinado que baixa e instala diretamente o aplicativo binário (arquivo APK ou AAB). O link expira após uma hora.

    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 Firebase. Depois que um testador for adicionado ao seu projeto do Firebase, você poderá adicioná-lo a versões individuais. Assim que você 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 aos seus lançamentos 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 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 (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 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 .