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

1. Visão Geral

Neste codelab, você aprenderá a distribuir versões do Android App Bundle para testadores usando o Firebase App Distribution e o 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 versão.

O que você aprenderá

• Como vincular seu aplicativo Firebase ao Google Play
• Como empacotar e criar 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 gerado no Android Studio
• Uma conta de desenvolvedor do Google Play da qual você é 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 análise do aplicativo no Google Play foi 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 convites de novos builds do Firebase

2. Crie um projeto 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 do Firebase. Se você não editar o ID do projeto, o Firebase atribuirá automaticamente um ID exclusivo para o seu projeto.
   
   
3. (Opcional) Quando solicitado, ative o Google Analytics.
4. Conclua as etapas restantes e clique em Criar projeto .

Adicione seu pacote de aplicativos ao projeto

1. No console do Firebase, clique em Adicionar aplicativo .
   
   
2. Ao registrar seu aplicativo, use o mesmo nome de pacote do aplicativo enviado para sua conta de desenvolvedor do Google Play.

   Observação: o mesmo nome de pacote é necessário para vincular seu aplicativo Firebase à sua conta de desenvolvedor do Google Play, o que você fará na próxima seção.

   Por fim, clique em Registrar aplicativo .
3. Conclua as etapas restantes para adicionar o arquivo de configuração do Firebase ( google-services.json ) ao seu aplicativo. Observe que para Android, o App Distribution não tem um SDK do Firebase para adicionar ao seu aplicativo.
4. Clique em Continuar para consolar .

Link para o Google Play

1. No console do Firebase, acesse as configurações do projeto .
   
   
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 selecione seu aplicativo 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 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 App Distribution Gradle

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

1. No arquivo Gradle no nível do 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 protegido por um proxy corporativo ou firewall, adicione a seguinte propriedade de sistema Java que permite que o App Distribution faça upload de 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 Gradle, você precisará autenticar seu projeto 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. Configure as propriedades do seu pacote no Android Studio

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

Em seu 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 projeto .
• artifactType : o tipo de arquivo do seu aplicativo ( AAB ).
• testers : os endereços de e-mail dos seus testadores. Neste codelab, adicione seu próprio e-mail para testar sua versão depois que ela for distribuída.

Por exemplo:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

Como opção, você também pode substituir os valores definidos em build.gradle.kts passando argumentos de linha de comando na forma de -PappDistribution- property-name = property-value .

5. Crie e distribua uma versão

1. Execute a tarefa bundle Variant Gradle 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 alvos bundleRelease e appDistributionUploadRelease com o wrapper Gradle do seu projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: Adicionar App Distribution 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 testador para baixar a versão distribuída. Como testador, você precisará autenticar seu dispositivo de teste e ativar 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.
   
   
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 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 progresso do download e a versão do lançamento.
   
   
3. Toque em Baixar na versão para instalá-lo na Play Store.
4. Quando solicitado, conclua as etapas restantes para ativar o compartilhamento interno de aplicativos (as instruções são exibidas no seu dispositivo de teste e só precisam ser concluídas 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 aplicativos e distribuir uma versão aos testadores.

Próximos passos

• Acesse a documentação do App Distribution para saber mais sobre como gerenciar testadores para sua versão.
• Consulte Criar e testar seu Android App Bundle para obter informações sobre outras ferramentas que você pode usar para implantar seu aplicativo.