Distribuir versões de pacotes de aplicativos para testadores - Codelab

1. Visão Geral

image10.png

Neste codelab, você aprenderá a distribuir versões do Android App Bundle para testadores usando o Firebase App Distribution e seu plug-in Gradle. O App Distribution fornece um hub central para você gerenciar versões de pré-lançamento do seu aplicativo e os testadores que você convida para cada lançamento.

O que você aprenderá

  • Como vincular seu aplicativo Firebase ao Google Play
  • Como empacotar e construir seu aplicativo como um pacote de aplicativos
  • Como criar um lançamento e compartilhá-lo com testadores ao vivo
  • Como baixar e testar novos lançamentos como testador

O que você precisará

  • 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 da qual você é o proprietário ou administrador
  • Seu aplicativo no Google Play está configurado no painel de aplicativos do Google Play e tem o seguinte status :
    • O aplicativo é distribuído para uma das faixas do Google Play (teste interno, teste fechado, teste aberto ou produção).
    • A revisão do aplicativo no Google Play está concluída e o aplicativo foi publicado. Seu aplicativo será publicado se a coluna Status do aplicativo 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ê pode usar como testador para receber novos convites de compilação do Firebase

2. Crie 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 projeto do seu projeto Firebase. Se você não editar o ID do projeto, o Firebase 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 .

Adicione seu pacote de apps ao projeto

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

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

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

Agora que você concluiu essas etapas, seu aplicativo Firebase será vinculado ao seu aplicativo em sua conta de desenvolvedor do Google Play, desde que os nomes dos pacotes dos aplicativos correspondam.

3. Adicione o App Distribution ao seu projeto

Adicione o plug-in Gradle de distribuição de aplicativos

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

  1. No arquivo Gradle de nível de projeto ( android/build.gradle.kts ), adicione o plug-in App Distribution 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 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 Gradle no nível do aplicativo ( android/app/build.gradle.kts ), adicione o plug-in App Distribution ao bloco plugins .
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. Se você estiver atrás de um proxy corporativo ou firewall, adicione a seguinte propriedade de sistema Java que permite que o App Distribution carregue suas distribuições no Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Autentique seu projeto do Firebase

Antes de poder usar o plug-in Gradle, você precisará autenticar seu projeto Firebase. Para este codelab, você fará login na sua conta do Google usando a Firebase CLI .

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. Configure as propriedades do pacote no Android Studio

Nesta etapa, você se adicionará como testador da compilação que distribuirá posteriormente. Depois de distribuir a compilação, os testadores recebem notificações por e-mail do Firebase, convidando-os a testar a nova compilação.

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

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

Por 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 em seu build.gradle.kts passando argumentos de linha de comando na forma de -PappDistribution- property-name = property-value .

5. Crie e distribua um lançamento

  1. Execute a tarefa bundle Variant para criar seu arquivo de pacotes de aplicativos:
    $ ./gradlew :base:bundleRelease
    
  2. Localize o pacote no diretório de compilação 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 seu projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: Adicionar distribuição de aplicativo ao seu aplicativo).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

Os testadores agora receberão convites por e-mail para baixar e testar a compilação. Como desenvolvedor, agora você pode monitorar a compilação na guia Releases do painel App Distribution.

6. Baixe e teste sua versão

Nesta seção, você será configurado como um testador para fazer o download da versão distribuída. Como testador, você precisará autenticar seu dispositivo de teste e habilitar o compartilhamento interno de aplicativos no aplicativo 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. Opcionalmente, você também pode baixar o Firebase App Tester , que evita que as versões baixadas sejam adicionadas à pasta Downloads do seu dispositivo. Ele também exibe informações adicionais sobre lançamentos, como o andamento do download e a versão do lançamento.

    image9.png
  3. Toque em Download no lançamento para instalá-lo na Play Store.
  4. Quando solicitado, conclua as etapas restantes para habilitar o compartilhamento interno de aplicativos (as instruções são exibidas em seu dispositivo de teste e precisam ser concluídas apenas uma vez).

Assim que o download for concluído, seu lançamento aparecerá automaticamente como um atalho na tela inicial do seu 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óximos passos