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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 as versões de pré-lançamento do seu aplicativo e os testadores que você convida para cada versão.

O que você vai aprender

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

O que você precisará

  • Android Studio v4.0+
  • 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 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 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 Firebase. Se você não editar o ID do projeto, o Firebase atribuirá automaticamente um ID exclusivo ao seu projeto.

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

Adicionar seu pacote de aplicativos ao projeto

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

    image5.png
  2. Ao registrar seu aplicativo, certifique-se de usar o mesmo nome de pacote do aplicativo enviado para 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 SDK do Firebase para adicionar ao seu aplicativo.
  4. Clique em Continuar no console .
  1. No console do Firebase, acesse as configurações do projeto .

    imagem2.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 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

Adicionar 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 como dependências de buildscript ao seu aplicativo.

  1. Em seu arquivo Gradle no nível do projeto ( android/build.gradle ), adicione o plug-in App Distribution Gradle e o repositório Maven do Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Em seu arquivo Gradle no nível do aplicativo ( android/app/build.gradle ), adicione o plug-in App Distribution:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Se você estiver por trás de um proxy corporativo ou firewall, adicione a seguinte propriedade de sistema Java que permite que o App Distribution carregue 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ê precisará autenticar seu projeto do Firebase. Para este codelab, você fará login na sua conta do Google usando a ação de login do plug-in.

  1. Execute o seguinte comando na raiz do seu projeto Android:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Quando o comando imprimir um link de autenticação, abra-o em um navegador. Quando solicitado, faça login na sua conta do Google e conceda permissão para acessar seu projeto do Firebase. O comando Gradle imprime um token de atualização, que o plug-in App Distribution usa para autenticar com o Firebase.
  3. Defina a variável de ambiente FIREBASE_TOKEN para o token da etapa anterior:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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 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 , 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 que você possa testar sua compilação assim que ela for distribuída.

Por exemplo:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

Como opção, você também pode substituir os valores definidos em seu build.gradle 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 do 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 destinos bundleRelease e appDistributionUploadRelease com o wrapper Gradle do seu projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: adicionar o 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 Versões do painel do App Distribution.

6. Baixe e teste sua versão

Nesta seção, você será configurado como testador para baixar a versão que distribuiu. 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.

    image6.png
  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 impede que as versões baixadas sejam adicionadas à pasta Downloads do seu dispositivo. Ele também exibe informações adicionais sobre os lançamentos, como o andamento do download e a versão do lançamento.

    image9.png
  3. Toque em Download na versão 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).

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