Distribuir apps para Android para testadores com o fastlane

É possível distribuir versões para os testadores usando o fastlane, uma plataforma de código aberto que automatiza a criação e o lançamento de aplicativos para iOS e Android. Ele segue instruções simples definidas em um Fastfile. Depois de configurar o fastlane e o Fastfile, é possível integrar o App Distribution à sua configuração de fastlane.

Etapa 1. Configurar o fastlane

Instalar e configurar o fastlane.
Para adicionar o App Distribution à sua configuração do Fastlane, execute o seguinte comando a partir da raiz do seu projeto Android:
```
fastlane add_plugin firebase_app_distribution
```
Se o comando solicitar uma escolha, selecione Option 3: RubyGems.org.

Etapa 2. Autenticar com o Firebase

Antes de usar o plug-in do Fastlane, primeiro faça a autenticação com seu projeto do Firebase. Existem três maneiras de fazer isso:

Fazer login na sua Conta do Google por meio da ação de login do plug-in

Execute este comando:
```
bundle exec fastlane run firebase_app_distribution_login
```
O comando exibe um link de autenticação.
Abra o link em um navegador.
Quando solicitado, faça login na sua Conta do Google e conceda permissão para acessar seu projeto do Firebase. Copie o código resultante do navegador de login e o cole na linha de comando. A ação de login exibe um token de atualização, que o plug-in do App Distribution usa para se fazer a autenticação com o Firebase.
Transmita o token da etapa anterior para o plug-in usando o parâmetro firebase_cli_token posteriormente ao configurar o Fastfile ou definindo a variável de ambiente FIREBASE_TOKEN:
```
export FIREBASE_TOKEN=token
```

Usar as credenciais da conta de serviço do Firebase

Autenticar com uma conta de serviço permite que você use o plug-in de forma flexível com seu sistema de integração contínua (CI, na sigla em inglês). Há duas maneiras de fornecer credenciais de conta de serviço:

Transmita o arquivo de chave da conta de serviço para a ação firebase_app_distribution. Esse método poderá ser conveniente caso você já tenha o arquivo de chave da conta de serviço no seu ambiente de build.
Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS a fim de direcionar para o arquivo de chave da sua conta de serviço. Talvez você prefira esse método se já tiver o Application Default Credentials (ADC) configurado para outro serviço do Google, por exemplo, o Google Cloud.

No Console do Google Cloud, selecione seu projeto e crie uma nova conta de serviço.
Adicione o papel administrador do Firebase App Distribution.
Crie uma chave json privada e mova a chave para um local acessível para seu ambiente de criação. Mantenha esse arquivo em algum lugar seguro, porque ele concede acesso de administrador ao App Distribution no seu projeto do Firebase.
Pule esta etapa se você tiver criado seu aplicativo depois de 20 de setembro de 2019: no Console de APIs do Google, ative a API Firebase App Distribution. Quando solicitado, selecione o projeto com o mesmo nome do seu projeto do Firebase.
Forneça ou localize as credenciais da sua conta de serviço:
1. Para transmitir a chave da conta de serviço para a ação firebase_app_distribution da linha, defina o parâmetro service_credentials_file com o caminho para seu arquivo JSON de chave privada.
2. Para localizar suas credenciais com o ADC, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho para o arquivo JSON da chave privada. Exemplo:
```
 export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
```
  Para mais informações sobre a autenticação com o ADC, leia Como fornecer credenciais para um aplicativo.

Fazer login usando a CLI do Firebase

Consulte Fazer login com a CLI do Firebase para ver instruções sobre como autenticar o projeto.

Etapa 3. Configurar o Fastfile e distribuir o app

Em uma pista ./fastlane/Fastfile, adicione um bloco firebase_app_distribution. Use os seguintes parâmetros para configurar a distribuição:

Parâmetros firebase_app_distribution
`app`	Obrigatório: ID do app do Firebase do seu aplicativo. É possível encontrar o ID do app no Console do Firebase, na página Configurações gerais. app: "1:1234567890:android:0a1b2c3d4e5f67890"
`firebase_cli_token`	Um token de atualização que é exibido quando você executa a ação de login do plug-in (consulte Autenticar usando uma Conta do Google acima) ou quando autentica o ambiente de CI com a CLI do Firebase. Leia Usar a CLI com sistemas de CI para mais informações.
`service_credentials_file`	O caminho para o arquivo JSON da sua conta de serviço do Google. Veja acima como fazer a autenticação usando credenciais da conta de serviço.
`apk_path`	Caminho absoluto para o arquivo APK que você quer enviar. Se não for especificado, o fastlane determinará o local do arquivo na linha em que o arquivo foi gerado.
`release_notes` `release_notes_file`	Notas da versão deste build. É possível especificar as notas da versão diretamente: release_notes: "Text of release notes" Como opção, 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ê quer convidar. É possível 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" Como opção, especifique o caminho para um arquivo de texto simples que contém uma lista separada por vírgulas de endereços de e-mail: testers_file: "/path/to/testers.txt"
`groups` `groups_file`	Os grupos de testadores que você quer convidar (consulte Gerenciar testadores). Grupos são especificados usando aliases de grupo, que podem ser encontrados no Console do Firebase. É possível especificar os grupos como uma lista separada por vírgulas: groups: "qa-team, trusted-testers" Também é possível 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`	Uma sinalização booleana. É possível definir isso como `true` para imprimir a saída de depuração detalhada.

Exemplo:

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(...) # build_android_app is a built-in fastlane action.

        firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

Por fim, para disponibilizar o build para os testadores, execute a linha:
```
fastlane <lane>
```

Depois de distribuir o build, ela fica disponível no painel de App Distribution no Console do Firebase por 150 dias (cinco meses). Quando faltarem 30 dias para o vencimento do build, o aviso de expiração 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 dar os primeiros passos, e os testadores atuais recebem notificações por e-mail informando que um novo build está pronto para ser testado (leia o guia de configuração do testador para ver 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 aplicativo no Console do Firebase.