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

Práticas recomendadas para distribuir aplicativos Android para testadores de controle de qualidade usando CI/CD

Este documento apresenta as práticas recomendadas para usar o Firebase App Distribution para tornar seus fluxos de trabalho de teste de pré-lançamento do Android sustentáveis ​​e repetíveis em um ambiente de CI/CD. As soluções incluem Gradle e fastlane, mas para oferecer ainda mais flexibilidade, também incluímos soluções disponíveis por meio do Firebase console, da Firebase CLI e da Firebase App Distribution API pública. Também descrevemos os limites de versão e testador para que você possa planejar com antecedência uma experiência ideal.

Se você também estiver usando plataformas Apple, consulte Práticas recomendadas para distribuição de aplicativos Apple para testadores de controle de qualidade usando CI/CD e fastlane .

Antes de você começar

Antes de implementar as práticas recomendadas neste documento, certifique-se de ativar o App Distribution no Firebase console para cada aplicativo . Se você não habilitou o App Distribution, receberá um erro 404.

Para habilitar o App Distribution, siga estas etapas:

  1. Abra a página App Distribution no console do Firebase.
  2. Selecione seu aplicativo Android.
  3. Clique em Começar .

Como os Android App Bundles (AAB) estão se tornando o formato de pacote Android mais comum, recomendamos que você configure a capacidade de distribuir AABs para seus testadores vinculando-os ao Google Play .

Automatize seu fluxo de trabalho de teste de pré-lançamento usando um pipeline de CI/CD

Se você deseja automatizar a criação e o lançamento de aplicativos para seus testadores e está usando CI/CD, recomendamos o uso de fastlane ou Gradle . Outra opção é usar o Firebase CLI , que permite acessar uma ampla variedade de produtos Firebase.

Usar via rápida

Integre o App Distribution em seu pipeline de CI/CD usando o fastlane, uma ferramenta de código aberto que automatiza a criação e o lançamento de aplicativos iOS e Android. Ao criar e distribuir seus lançamentos mais recentes para os testadores automaticamente, você garante que os testadores sempre tenham a versão de teste mais atualizada do seu aplicativo.

Para saber como integrar o App Distribution com o fastlane, consulte Distribuir aplicativos Android para testadores usando o fastlane .

Usar Gradle

Use o Gradle para integrar o App Distribution ao processo de compilação do Android usando o plug-in Gradle do App Distribution. O plug-in permite que você especifique seus testadores e notas de versão no arquivo build.gradle de seu aplicativo, o que permite configurar distribuições para diferentes tipos de compilação e variantes de seu aplicativo.

Para saber como integrar o App Distribution com o Gradle, consulte Distribuir aplicativos Android para testadores usando o Gradle .

Use a CLI do Firebase

Use as ferramentas Firebase CLI fornecidas pelo App Distribution para distribuir builds aos testadores de forma programática. Você pode especificar testadores e notas de versão para um build.

Distribua sua versão mais recente do Android especificando o Firebase App ID do aplicativo, opcionalmente adicionando uma nota da versão e um arquivo contendo os e-mails dos testadores:

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

Para saber mais sobre como usar a Firebase CLI para automatizar suas compilações, consulte Distribuir aplicativos Android para testadores usando a Firebase CLI .

Use credenciais de serviço para autenticar

Use o plug-in App Distribution fastlane , o plug-in Gradle ou a Firebase CLI com contas de serviço. Uma conta de serviço é um tipo de conta do Google que representa aplicativos (em oposição a usuários). Seu sistema CI pode usar contas de serviço para executar suas cargas de trabalho do App Distribution. Para saber mais, consulte Autenticar com uma conta de serviço .

Se você estiver usando federação de identidade de carga de trabalho, poderá gerar e usar um arquivo de configuração de credencial em vez de uma chave de conta de serviço.

Lembre-se dos limites de liberação

O App Distribution oferece suporte a um máximo de 1.000 lançamentos por aplicativo. Isso significa que quando você excede o limite de lançamento, o App Distribution exclui automaticamente os lançamentos mais antigos acima do limite. Para saber como gerenciar os limites de lançamento, consulte Por quanto tempo os lançamentos de aplicativos ficam disponíveis?

Adicione o mesmo conjunto de testadores a vários lançamentos

Se você deseja adicionar um grande número de testadores aos seus lançamentos, use a funcionalidade de gerenciamento de testadores em massa do App Distribution.

Recomendamos que você use grupos para adicionar os mesmos testadores a várias versões. Um grupo atua como uma lista de controle de acesso; quando você remove um testador de um grupo, ele perde o acesso a todos os lançamentos distribuídos a esse grupo. Para saber mais, consulte Adicionar e remover testadores de um grupo .

Se você tiver muitos testadores para gerenciar, poderá adicionar e excluir testadores em massa usando o Firebase console. Para automatizar a adição e remoção de testadores, use Firebase CLI , fastlane , Gradle ou a Firebase App Distribution API pública .

Lembre-se dos limites do testador

O App Distribution limita o número de testadores que você pode adicionar a um projeto do Firebase ou a um grupo de App Distribution. Ao exceder esses limites, você não poderá distribuir seu aplicativo para testadores adicionais. Para saber mais sobre os limites do testador, consulte Existem limites para adicionar testadores ao meu aplicativo?

Permita que testadores em potencial se autorregistrem para testes

Para facilitar a distribuição de seu aplicativo para mais testadores, recomendamos o uso de links de convite. Um link de convite é um URL exclusivo que permite aos testadores inserir seus endereços de e-mail para se inscrever para testar um aplicativo. Permitir que os usuários se adicionem à sua lista de testadores de aplicativos é uma maneira perfeita de aumentar sua base de testes internos.

Os casos de uso de links de convite incluem programas dogfood da empresa, organizações com grandes equipes de controle de qualidade e grupos de desenvolvedores que desejam que clientes individuais possam controlar o acesso do testador.

Recomendamos que você crie um link de convite para um grupo. Qualquer testador que se inscrever usando o link de convite será adicionado automaticamente aos lançamentos subsequentes.

Para saber mais, consulte Criar links de convite e Adicionar e remover testadores de um grupo .

Certifique-se de que os testadores estão testando a versão que você gosta

Quando uma nova versão é carregada, seus testadores são notificados por e-mail. Para complementar essa notificação, você pode usar os seguintes recursos – links de lançamento e alertas no aplicativo – para garantir que seus testadores estejam testando a versão específica do aplicativo de seu interesse:

  • Links de lançamento: use esse recurso quando quiser compartilhar uma versão específica com os testadores. Para saber como usar links de lançamento, consulte Distribuir aplicativos Android para testadores usando o Firebase console . Esses links também estão disponíveis com nossas ferramentas de linha de comando (CLI) Firebase , fastlane e Gradle para uso com suas ferramentas de automação de compilação.
  • Alertas no aplicativo: use esses alertas quando quiser garantir que seus testadores estejam testando a versão mais recente do seu aplicativo. Ao integrar o Firebase App Distribution Android SDK, você pode exibir alertas diretamente dentro do aplicativo para seus testadores quando novas compilações de seu aplicativo estiverem disponíveis. Para saber como adicionar alertas no aplicativo, consulte Notificar testadores sobre novas compilações .

Remova automaticamente o acesso de testadores que saem da empresa

Quando seu fluxo de teste interno de CI/CD estiver funcionando, você precisará garantir que as pessoas que saem da empresa não tenham mais acesso às suas compilações internas. Para ajudá-lo a gerenciar o acesso do testador às compilações, o App Distribution oferece as seguintes opções: