Distribuir lançamentos de app bundle 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 as 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 uma versão e compartilhá-la com testadores ao vivo
  • Como fazer download 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 instrumentos aplicativo Google Play , e tem o seguinte estado :
    • 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 é publicado Se a coluna de status App exibe um dos seguintes estados: testes internos (não Projecto de testes internos), o teste fechado, testes Open, ou Produção.
  • Um endereço de e-mail que você pode usar como testador para receber convites de novas versões do Firebase

2. Crie um projeto Firebase

  1. Entrar no Firebase .
  2. No console Firebase, clique em Adicionar Project, em seguida, nomeie seu projeto "AppBundlesCodelab." Lembre-se do ID do projeto para seu projeto Firebase. Se você não editar o ID do projeto, o Firebase atribuirá automaticamente um ID exclusivo para o seu projeto.

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

Adicione seu pacote de aplicativos ao projeto

  1. No console Firebase, clique em Adicionar aplicativo.

    image5.png
  2. Ao registrar seu aplicativo, certifique-se de usar o mesmo nome do pacote como o aplicativo que está carregado na sua conta Play Google. Finalmente, clique em Register aplicativo.
  3. Conclua as etapas restantes para adicionar arquivo de configuração Firebase do seu aplicativo ( google-services.json ) para 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 consolar.
  1. No console Firebase, acesse as configurações do projeto.

    image2.png
  2. Na guia Integrações, clique em Link no cartão de Reprodução Google.
  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 App Distribution ao seu projeto

Adicionar o plug-in Gradle do App Distribution

Agora, você usará o Android Studio para adicionar App Distribution e seu plug-in Gradle como dependências de buildscript para seu aplicativo.

  1. Em seu arquivo Gradle em nível de projeto ( android/build.gradle ), adicione o App Distribuição Gradle plugin e repositório Maven do Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Em seu arquivo Gradle de nível aplicativo ( android/app/build.gradle ), adicione o plug-in Distribuição App:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Se você está atrás de um proxy corporativo ou Firewall, adicione a seguinte propriedade de sistema Java que permite App Distribuição fazer upload de suas distribuições de Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Autentique seu projeto Firebase

Antes de usar o plug-in Gradle, você precisará autenticar seu projeto do Firebase. Para este codelab, você fará login em 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 em 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 do App Distribution usa para autenticar com o Firebase.
  3. Defina a variável de ambiente FIREBASE_TOKEN ao 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 um testador para a 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 seu app/build.gradle , adicione um firebaseAppDistribution seção e incluem os seguintes parâmetros:

  • appID : Seu aplicativo Firebase App ID. Você pode encontrá-lo na guia Geral das Configurações do Projeto.
  • artifactType : tipo de arquivo do seu aplicativo ( AAB ).
  • testers : endereços de email dos seus testadores. Para este codelab, adicione seu próprio e-mail para que possa testar sua compilação assim que 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 na sua build.gradle passando argumentos de linha de comando na forma de -PappDistribution- property-name = property-value .

5. Construir e distribuir uma versão

  1. Execute o bundle Variant tarefa Gradle para construir seu aplicativo agrupa arquivo:
    $ ./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 liberação, construir as metas bundleRelease e appDistributionUploadRelease com envoltório Gradle do seu projeto. Inclua o token do Firebase (aquele que você recebeu na etapa 3: adicionar distribuição de aplicativos 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 Lançamentos do painel Distribuição App.

6. Baixe e teste sua versão

Nesta seção, você será configurado como um testador para baixar a 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. Em seu dispositivo de teste, faça login em sua conta de e-mail de 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 Firebase App Tester, que impede que baixado lançamentos de ser adicionado ao do seu dispositivo Downloads pasta. Ele também exibe informações adicionais sobre lançamentos, como o andamento do download e a versão de lançamento.

    image9.png
  3. Tap Baixar sobre a libertação de instalá-lo a partir da Play Store.
  4. Quando solicitado, conclua as etapas restantes para habilitar 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, 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 aplicativos e distribuir uma versão aos testadores.

Próximos passos