Distribuir lançamentos de app bundle para testadores - Codelab

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 é a configuração no painel de instrumentos aplicativo Google Play , e tem o seguinte estado :
    • O aplicativo está em um estado publicado, o que significa que ele não está em Projecto e sua revisão é completo (a coluna de status de atualização no Google Play Console está vazia).
    • O aplicativo é distribuído em uma das seguintes faixas do Google Play: teste interno, fechado, teste aberto ou produção.
  • Um endereço de e-mail que você pode usar como testador para receber convites de novas versões do 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.

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
    

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 .

  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.

Nesta seção, você será configurado como um testador para baixar a versão distribuída. Como um 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.

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