Distribuir versões de pacotes de apps para os testadores – Codelab

1. Visão geral

image10.png

Neste codelab, você vai aprender a distribuir as versões do Android App Bundle para os testadores usando o Firebase App Distribution e o plug-in do Gradle. O App Distribution é um hub central para você 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 apps
  • Como criar uma versão e compartilhar com testadores
  • Como fazer o download 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, fechado, aberto ou produção.
    • A avaliação do app no Google Play é concluída e ele é publicado. O app será publicado se a coluna Status do app exibir um dos seguintes status: teste interno (não teste interno de rascunho), teste fechado, teste aberto ou produção.
  • Um endereço de e-mail que você possa usar como testador para receber novos convites de versão 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". Lembre-se do ID do seu projeto do Firebase. Se você não editar o ID do projeto, o Firebase 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.

    .png
  2. Ao registrar seu app, use o mesmo nome do 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 Configurações do projeto.

    .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, seu aplicativo do Firebase será vinculado ao seu aplicativo na conta de desenvolvedor do Google Play, desde que o os nomes dos pacotes sejam correspondentes.

3. Adicionar o App Distribution ao seu projeto

Adicionar o plug-in do App Distribution do Gradle

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

  1. No arquivo do Gradle no nível do projeto (android/build.gradle.kts), adicione o plug-in do Gradle do 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 de configurações do 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 do 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
    

Autentique seu projeto do Firebase

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

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 do build que vai distribuir mais tarde. Depois de distribuir o build, os testadores recebem notificações por e-mail do Firebase os convidando para testar o novo build.

No 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 fica na guia Geral das Configurações do projeto.
  • artifactType: o tipo de arquivo do app (AAB).
  • testers: seus testadores endereços de e-mail. Neste 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 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 bundleVariant do Gradle para criar o arquivo de pacotes do app:
    $ ./gradlew :base:bundleRelease
    
  2. Localize o pacote no diretório de build do seu 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 Gradle do projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: adicionar a distribuição de apps 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 fazer o download e testar o build. Como desenvolvedor, agora é possível monitorar o build na guia Versões do painel do App Distribution.

6. Fazer o download e testar a versão

Nesta seção, você será configurado como testador para fazer o download da versão que distribuiu. Como testador, você precisa autenticar seu dispositivo de teste e ativar o Compartilhamento interno de apps na Google Play Store.

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

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

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

Quando 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 aos testadores.

Próximas etapas