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 é um hub central para você gerenciar as versões de pré-lançamento do app e os testadores convidados a cada uma delas.

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
  • O app no Google Play está configurado no painel do app 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. 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ê 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 seu projeto como "AppBundlesCodelab". Lembre-se do ID do seu projeto do Firebase. Se você não editar o ID do projeto, o Firebase vai atribuir automaticamente um ID exclusivo para seu projeto.

    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 que foi 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.

Depois de concluir essas etapas, o app do Firebase será vinculado ao app na sua conta de desenvolvedor do Google Play, desde que os nomes dos pacotes dos apps sejam iguais.

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 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 do Gradle de configurações 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ê precisará autenticar seu projeto do Firebase. Neste codelab, você vai fazer 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 que você distribui o build, os testadores recebem notificações por e-mail do Firebase convidando-os a 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 app. Ele está na guia Geral das Configurações do projeto.
  • artifactType: tipo de arquivo do app (AAB).
  • testers: os endereços de e-mail dos testadores. 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, você também pode substituir os valores definidos no build.gradle.kts transmitindo argumentos de linha de comando na forma de -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 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 seu 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 agora vão receber convites por e-mail para fazer o download e testar o build. Agora, os desenvolvedores podem monitorar o build na guia Versões do painel "Distribuição de apps".

6. Fazer o download e testar a versão

Nesta seção, você vai configurar um testador para fazer o download da versão distribuída. 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 opção, também é possível fazer o download do Firebase App Tester, que impede que versões baixadas 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.

    image9.png
  3. Toque em Fazer o download na versão para instalá-la 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 precisam ser concluídas apenas uma vez.

Quando o download for concluído, a versão 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