Distribuir versões de pacotes de apps para os testadores: codelab

1. Visão geral

Imagem10.png

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

Conteúdo

  • 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 compartilhá-la com testadores em tempo real
  • 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 que você gerou no Android Studio
  • Uma conta de desenvolvedor do Google Play em que você é proprietário ou administrador
  • O app 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 vai ser publicado se a coluna Status do app exibir 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-o 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 ele.

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

Adicionar seu pacote de app ao projeto

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

    imagem5.png
  2. Ao registrar seu app, use o mesmo nome de pacote que o app enviado à 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) do seu app. No Android, o 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.

    Imagem2.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 Firebase recém-criado para vincular ao Google Play.

Agora que você concluiu essas etapas, o app Firebase será vinculado ao seu aplicativo na conta de desenvolvedor do Google Play, desde que os nomes dos pacotes 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 seu app.

  1. No arquivo do Gradle no nível do projeto (android/build.gradle.kts), adicione o plug-in do App Distribution do Gradle 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 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 permita 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ê fará login na sua Conta do Google usando a CLI do Firebase.

Execute o seguinte comando na raiz do seu 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ê distribuir a versão, os testadores receberão notificações por e-mail do Firebase os convidando para testar a nova versão.

Em 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: o 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, também é possível substituir os valores definidos em 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 seu arquivo de pacotes de apps:
    $ ./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 Gradle do projeto. Inclua o token do Firebase (o 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

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

6. Fazer o download e testar sua versão

Nesta seção, você vai configurar um testador para fazer o download da versão distribuída. Como testador, você precisará 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.

    imagem6.png
  2. Faça login com sua Conta do Google e aceite o convite para testar a versão distribuída. Você também pode fazer o download do Firebase App Tester, que impede que versões transferidas por download sejam adicionadas à pasta Downloads do seu dispositivo. Ela também exibe mais informações sobre as versões, como o progresso do download e a versão de lançamento.

    Imagem9.png
  3. Toque em Fazer o download na versão para fazer a instalação pela Play Store.
  4. Quando solicitado, conclua as etapas restantes para ativar o Compartilhamento interno de apps. As instruções aparecem no dispositivo de teste e só precisam ser concluídas 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 para os testadores.

Próximas etapas