Distribua aplicativos Android para testadores usando Gradle

Você pode integrar o App Distribution ao processo de construção do Android usando o plug-in App Distribution Gradle. O plug-in permite especificar seus testadores e notas de lançamento no arquivo Gradle do seu aplicativo, permitindo configurar distribuições para diferentes tipos de compilação e variantes do seu aplicativo.

Este guia descreve como distribuir Android App Bundles (AABs) para testadores usando o plug-in App Distribution Gradle.

O App Distribution integra-se ao serviço interno de compartilhamento de aplicativos do Google Play para processar os AABs que você envia e veicular APKs otimizados para as configurações de dispositivo dos seus testadores. Distribuir AABs permite fazer o seguinte:

• Execute APKs otimizados (fornecidos pelo Google Play) otimizados para os dispositivos dos seus testadores.

• Descubra e depure problemas específicos do dispositivo.

• Teste recursos do pacote de aplicativos, como Play Feature Delivery e Play Asset Delivery .

• Reduza o tamanho dos downloads para seus testadores.

Permissões necessárias

Para fazer upload de AABs para o App Distribution, você precisa vincular seu aplicativo do Firebase a um aplicativo no Google Play . Você deve ter o nível de acesso necessário para executar essas ações.

Se você não tiver o acesso necessário ao Firebase, peça a um proprietário do projeto do Firebase para atribuir a função aplicável a você por meio das configurações de IAM do console do Firebase . Se você tiver dúvidas sobre como acessar seu projeto do Firebase, incluindo encontrar ou atribuir um proprietário, consulte as perguntas frequentes sobre "Permissões e acesso a projetos do Firebase" .

A tabela a seguir se aplica à vinculação de um aplicativo do Firebase a um aplicativo no Google Play, bem como ao upload de AABs.

Antes de você começar

1. Adicione o Firebase ao seu projeto Android , caso ainda não o tenha feito. Ao final deste fluxo de trabalho, você terá um aplicativo Android do Firebase em seu projeto do Firebase.

   Se você não estiver usando nenhum outro produto Firebase, basta criar um projeto e registrar seu aplicativo. Se você decidir usar produtos adicionais, conclua todas as etapas em Adicionar o Firebase ao seu projeto Android .

2. Para criar um link do Firebase para o Google Play e fazer upload de AABs, verifique se seu aplicativo atende aos seguintes requisitos:

   • O aplicativo no Google Play e o aplicativo Firebase para Android são registrados usando o mesmo nome de pacote.

   • O aplicativo no Google Play é configurado no painel do aplicativo e 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.

3. Vincule seu aplicativo Firebase para Android à sua conta de desenvolvedor do Google Play:

   1. No console do Firebase, acesse seu settings Configurações do projeto e selecione a guia Integrações .

   2. No cartão do Google Play , clique em Link .
      Se você já possui links para o Google Play, clique em Gerenciar .

   3. Siga as instruções na tela para ativar a integração do App Distribution e selecionar quais aplicativos Firebase para Android vincular ao Google Play.

   Saiba mais sobre como vincular ao Google Play .

Passo 1. Configure seu projeto Android

1. Em seu arquivo Gradle de nível raiz (nível de projeto) ( <project>/build.gradle.kts ou <project>/build.gradle ), adicione o plug-in App Distribution Gradle como uma dependência:

   Kotlin

   plugins {
       // ...
       id("com.android.application") version "7.3.0" apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.1" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "4.2.0" apply false
   }
   

   Groovy

   plugins {
       // ...
       id 'com.android.application' version '7.3.0' apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.1' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '4.2.0' apply false
   }
   

2. No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle ), adicione o plug-in App Distribution Gradle:

   Kotlin

   plugins {
     id("com.android.application")
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution")
   }
   

   Groovy

   plugins {
     id 'com.android.application'
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the App Distribution Gradle plugin
     id 'com.google.firebase.appdistribution'
   }
   

3. Se você estiver protegido por um proxy ou firewall corporativo, 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
   

Etapa 2. Autenticar com Firebase

Antes de usar o plug-in Gradle, você deve primeiro autenticar seu projeto do Firebase de uma das seguintes maneiras. Por padrão, o plug-in Gradle procura credenciais na CLI do Firebase se nenhum outro método de autenticação for usado.

Etapa 3. Configure suas propriedades de distribuição

No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle ), configure o App Distribution adicionando pelo menos uma seção firebaseAppDistribution .

Por exemplo, para distribuir a versão release aos testadores, siga estas instruções::

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("release") {
          firebaseAppDistribution {
              artifactType = "AAB"
              releaseNotesFile = "/path/to/releasenotes.txt"
              testers = "ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      release {
          firebaseAppDistribution {
              artifactType="AAB"
              releaseNotesFile="/path/to/releasenotes.txt"
              testers="ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

Você pode configurar o App Distribution para tipos de compilação e variações de produtos .

Por exemplo, para distribuir compilações debug e release em versões de produto "demo" e "completo", siga estas instruções:

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("debug") {...}
      getByName("release") {...}
  }

  flavorDimensions += "version"
  productFlavors {
      create("demo") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for demo version"
              testers = "demo@testers.com"
          }
      }
      create("full") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for full version"
              testers = "full@testers.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      debug {...}
      release {...}
  }

  flavorDimensions "version"
  productFlavors {
      demo {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for demo version"
              testers="demo@testers.com"
          }
      }
      full {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for full version"
              testers="full@testers.com"
          }
      }
  }

  // ...
}

Use os seguintes parâmetros para configurar a distribuição:

appId="1:1234567890:android:321abc456def7890"

testers="ali@example.com, bri@example.com, cal@example.com"

testersFile="/path/to/testers.txt"

groups="qa-team, android-testers"

groupsFile="/path/to/tester-groups.txt"

testDevices="model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

testDevicesFile="/path/to/testDevices.txt"

testPasswordFile="/path/to/testPassword.txt"

Etapa 4. Distribua seu aplicativo aos testadores

1. Por fim, para empacotar seu aplicativo de teste e convidar testadores, crie os alvos BUILD-VARIANT e appDistributionUpload BUILD-VARIANT com o wrapper Gradle do seu projeto, onde BUILD-VARIANT é o tipo de produto opcional e o tipo de build que você configurou na etapa anterior. Para obter mais informações sobre variações de produtos, consulte Configurar variantes de build .

   Por exemplo, para distribuir seu aplicativo usando a variante de build release , execute o seguinte comando:

   ./gradlew bundleRelease appDistributionUploadRelease
   

   Ou, se você se autenticou com sua Conta do Google e não forneceu credenciais no arquivo de compilação do Gradle, inclua a variável FIREBASE_TOKEN :

   export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
   ./gradlew --stop // Only needed for environment variable changes
   ./gradlew bundleRelease appDistributionUploadRelease
   

2. Você também pode substituir os valores definidos em seu arquivo build.gradle passando argumentos de linha de comando na forma de --<property-name>=<property-value> . Por exemplo:

   • Para fazer upload de uma compilação de depuração para o App Distribution:

     ./gradlew bundleDebug appDistributionUploadDebug
         --artifactType="AAB"
     

   • Para convidar testadores adicionais ou remover testadores existentes do seu projeto do Firebase:

     ./gradlew appDistributionAddTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     ./gradlew appDistributionRemoveTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     

     Depois que um testador for adicionado ao seu projeto do Firebase, você poderá adicioná-lo a versões individuais. Os testadores removidos não terão mais acesso às versões do seu projeto, mas ainda poderão manter o acesso às suas versões por um período de tempo.

   Você também pode especificar testadores usando --file="/path/to/testers.txt" em vez de --emails .

   As tarefas appDistributionAddTesters e appDistributionRemoveTesters também aceitam os seguintes argumentos:

   • projectNumber : o número do seu projeto do Firebase.

   • serviceCredentialsFile : o caminho para o arquivo de credenciais de serviço do Google. Este é o mesmo argumento usado pela ação de upload.

O plug-in Gradle gera os seguintes links após o upload da versão. Esses links ajudam você a gerenciar binários e garantir que os testadores e outros desenvolvedores tenham a versão correta:

• firebase_console_uri – um link para o console do Firebase exibindo uma única versão. Você pode compartilhar esse link com outros desenvolvedores da sua organização.
• testing_uri – Um link para o lançamento na experiência do testador (aplicativo nativo do Android) que permite aos testadores visualizar as notas de lançamento e instalar o aplicativo em seus dispositivos. O testador precisa de acesso à versão para usar o link.
• binary_download_uri - Um link assinado que baixa e instala diretamente o binário do aplicativo (arquivo APK ou AAB). O link expira após uma hora.

Depois de distribuir sua versão, ela ficará disponível no painel de distribuição de aplicativos do console do Firebase por 150 dias (cinco meses). Quando faltam 30 dias para a expiração da compilação, um aviso de expiração aparece no console e na lista de compilações do testador no dispositivo de teste.

Os testadores que não foram convidados para testar o aplicativo recebem convites por email para começar, e os testadores existentes recebem notificações por email de que uma nova compilação está pronta para ser testada (leia o guia de configuração do testador para obter instruções sobre como instalar o aplicativo de teste). Você pode monitorar o status de cada testador (se eles aceitaram o convite e se fizeram o download do aplicativo) no Console do Firebase.

Os testadores têm 30 dias para aceitar um convite para testar o aplicativo antes que ele expire. Quando faltam cinco dias para a expiração de um convite, um aviso de expiração aparece no Console do Firebase ao lado do testador em uma versão. Um convite pode ser renovado reenviando-o usando o menu suspenso na linha do testador.

Próximos passos

• Implemente feedback no aplicativo para facilitar aos testadores o envio de feedback sobre seu aplicativo (incluindo capturas de tela).

• Aprenda como exibir alertas no aplicativo para seus testadores quando novas versões do seu aplicativo estiverem disponíveis para instalação.

• Acesse o codelab do Android App Bundle para saber como distribuir versões de pacotes de apps passo a passo.

• Aprenda as práticas recomendadas para distribuir aplicativos Android para testadores de controle de qualidade usando CI/CD .