Distribuir versões de pacotes de apps para testadores: Codelab

1. Visão geral

image10.png

Neste codelab, você vai aprender a distribuir versões de pacotes de apps Android para testadores usando o Firebase App Distribution e o plug-in do Gradle. O App Distribution oferece um hub central para gerenciar versões de pré-lançamento do app e os testadores convidados para cada versão.

O que você vai aprender

  • Como vincular seu app do Firebase ao Google Play
  • Como empacotar e criar seu app como um pacote de app
  • Como criar uma versão e compartilhar com testadores ativos
  • Como baixar e testar novas versões como testador

Pré-requisitos

  • Versão mais recente do Android Studio
  • Um arquivo de pacote assinado gerado no Android Studio
  • Uma conta de desenvolvedor do Google Play em que você é proprietário ou administrador
  • Seu app no Google Play está configurado no painel de apps do Google Play e tem o seguinte status:
    • O app é 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 mostrar um dos seguintes status: teste interno (e não teste interno de rascunho), teste fechado, teste aberto ou produção.
  • Um endereço de e-mail que você pode usar como testador para receber convites de novos builds do Firebase

2. Criar um projeto do Firebase

  1. Faça login no Firebase.
  2. No console do Firebase, clique em Adicionar projeto e nomeie o projeto como "AppBundlesCodelab". Memorize o ID do projeto do Firebase. Se você não editar o ID do projeto, o Firebase vai atribuir automaticamente um ID exclusivo a ele.

    image8.png
  3. (Opcional) Quando solicitado, ative o Google Analytics.
  4. Conclua as etapas restantes e clique em Criar projeto.

Adicionar o pacote de apps ao projeto

  1. No console do Firebase, clique em Adicionar app.

    image5.png
  2. Ao registrar o app, use o mesmo nome de pacote do app enviado para sua conta de desenvolvedor do Google Play. Por fim, clique em Registrar app.
  3. Conclua as etapas restantes para adicionar o arquivo de configuração do Firebase (google-services.json) ao app. No Android, a App Distribution não tem um SDK do Firebase para adicionar ao app.
  4. Clique em Continuar para o Console.
  1. No console do Firebase, acesse as Configurações do projeto.

    image2.png
  2. Na guia Integrações, clique em Vincular no card do Google Play.
  3. Siga as instruções na tela para ativar a integração do App Distribution e selecione o app do Firebase recém-criado para vincular ao Google Play.

Agora que você concluiu essas etapas, o app do Firebase será vinculado ao app na sua conta de desenvolvedor do Google Play, desde que os nomes de pacote dos apps correspondam.

3. Adicionar o App Distribution ao seu projeto

Adicionar o plug-in do Gradle para App Distribution

Agora, você vai usar o Android Studio para adicionar o App Distribution e o plug-in do Gradle ao app.

  1. No arquivo Gradle no nível do projeto (android/build.gradle.kts), adicione o plug-in do Gradle para App Distribution ao bloco plugins.
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. No arquivo Settings Gradle no nível do projeto (android/settings.gradle.kts), adicione o repositório Maven do Google ao bloco pluginManagement.
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. No arquivo Gradle no nível do app (android/app/build.gradle.kts), adicione o plug-in do App Distribution ao bloco plugins.
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. Se você tiver um proxy ou firewall corporativo ativado, adicione a seguinte propriedade do sistema Java que permite que o App Distribution faça upload das suas distribuições para o Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Autenticar seu projeto do Firebase

Antes de usar o plug-in do Gradle, você precisa autenticar seu projeto do Firebase. Neste codelab, você vai fazer login na sua Conta do Google usando a Firebase CLI.

Execute o seguinte comando na raiz do projeto Android:

~/your-android-project$ firebase login

A documentação de referência contém mais detalhes.

4. Configurar as propriedades do pacote no Android Studio

Nesta etapa, você vai se adicionar como testador da build que será distribuída mais tarde. Depois que você distribuir a versão, os testadores vão receber notificações por e-mail do Firebase convidando-os para testar a nova versão.

No seu app/build.gradle.kts, adicione uma seção firebaseAppDistribution e inclua os seguintes parâmetros:

  • appID: ID do app do Firebase do seu aplicativo. Ele está na guia Geral das configurações do projeto.
  • artifactType: o tipo de arquivo do app (AAB).
  • testers: os endereços de e-mail dos seus testadores. Para este codelab, adicione seu próprio e-mail para testar o build depois que ele for distribuído.

Exemplo:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Como opção, também é possível substituir os valores definidos no arquivo build.gradle.kts transmitindo argumentos de linha de comando no formato -PappDistribution-property-name=property-value.

5. Criar e distribuir uma versão

  1. Execute a tarefa do Gradle bundleVariant para criar o arquivo de pacotes do app:
    $ ./gradlew :base:bundleRelease
  2. Localize o pacote no diretório de build do aplicativo. O local padrão é app/build/outputs/bundle/release.
  3. Para distribuir a versão, crie os destinos bundleRelease e appDistributionUploadRelease com o wrapper do Gradle do projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: adicionar o App Distribution ao seu app).
    export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

Os testadores vão receber convites por e-mail para baixar e testar o build. Como desenvolvedor, agora você pode monitorar o build na guia Versões do painel do App Distribution.

6. Baixar e testar a versão

Nesta seção, você vai se configurar como um testador para baixar a versão que distribuiu. Como testador, você precisa autenticar seu dispositivo de teste e ativar o compartilhamento interno de apps no app Google Play Store.

  1. No dispositivo de teste, faça login na conta de e-mail do testador e abra o convite do Firebase.

    image6.png
  2. Faça login com sua Conta do Google e aceite o convite para testar a versão distribuída. Como opção, você também pode baixar o Firebase App Tester, que impede que as versões baixadas sejam adicionadas à pasta Downloads do seu dispositivo. Ele também mostra informações adicionais sobre os lançamentos, como o progresso do download e a versão.

    image9.png
  3. Toque em Fazer o download na versão para instalar na Play Store.
  4. Quando solicitado, conclua as etapas restantes para ativar o compartilhamento interno de apps. As instruções são exibidas no dispositivo de teste e só precisam ser concluídas uma vez.

Depois que o download for concluído, o lançamento vai aparecer automaticamente como um atalho na tela inicial do dispositivo.

7. Parabéns!

Você acabou de usar o Firebase App Distribution para fazer upload de um pacote de apps e distribuir uma versão para testadores.

Próximas etapas