1. Visão geral
Neste codelab, você vai aprender a distribuir as versões do Android App Bundle para os testadores usando o Firebase App Distribution e o plug-in do Gradle. O App Distribution é um hub central para você gerenciar versões de pré-lançamento do app e os testadores convidados para cada versão.
O que você vai aprender
- Como vincular seu app do Firebase ao Google Play
- Como empacotar e criar seu app como um pacote de apps
- Como criar uma versão e compartilhar com testadores
- Como fazer o download e testar novas versões como testador
Pré-requisitos
- Versão mais recente do Android Studio
- Um arquivo de pacote assinado que você gerou no Android Studio
- Uma conta de desenvolvedor do Google Play em que você é proprietário ou administrador
- Seu app no Google Play está configurado no painel de apps do Google Play e tem o seguinte status:
- O app é distribuído para uma das faixas do Google Play: teste interno, fechado, aberto ou produção.
- A avaliação do app no Google Play é concluída e ele é publicado. O app será publicado se a coluna Status do app 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 build do Firebase
2. Criar um projeto do Firebase
- Faça login no Firebase.
- 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 a ele.
- (Opcional) Ative o Google Analytics quando solicitado.
- Conclua as etapas restantes e clique em Criar projeto.
Adicionar o pacote de apps ao projeto
- No Console do Firebase, clique em Adicionar app.
- Ao registrar o app, use o mesmo nome do pacote do app que foi enviado para sua conta de desenvolvedor do Google Play. Por fim, clique em Registrar app.
- Conclua as etapas restantes para adicionar ao app o arquivo de configuração do Firebase (
google-services.json
). Para Android, o App Distribution não tem um SDK do Firebase para adicionar ao seu app. - Clique em Continuar para o Console.
Vincular ao Google Play
- No Console do Firebase, acesse Configurações do projeto.
- Na guia Integrações, clique em Vincular no card do Google Play.
- Siga as instruções na tela para ativar a integração do App Distribution e selecione o app do Firebase recém-criado para vincular ao Google Play.
Depois de concluir essas etapas, o app do Firebase será vinculado ao app na sua conta de desenvolvedor do Google Play, desde que os nomes dos pacotes dos apps sejam iguais.
3. Adicionar o App Distribution ao seu projeto
Adicionar o plug-in do App Distribution do Gradle
Agora, você vai usar o Android Studio para adicionar o App Distribution e o plug-in do Gradle ao seu app.
- No arquivo do Gradle no nível do projeto (
android/build.gradle.kts
), adicione o plug-in do Gradle do App Distribution ao blocoplugins
.plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false }
- No arquivo do Gradle de configurações do projeto (
android/settings.gradle.kts
), adicione o repositório Maven do Google ao blocopluginManagement
.pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } }
- No arquivo do Gradle no nível do app (
android/app/build.gradle.kts
), adicione o plug-in do App Distribution ao blocoplugins
.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- Se você tiver um proxy ou firewall corporativo ativado, adicione a seguinte propriedade do sistema Java que permite que o App Distribution faça upload das 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 do Gradle, você precisará autenticar seu projeto do 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. Configurar as propriedades do pacote no Android Studio
Nesta etapa, você vai se adicionar como testador do build que vai distribuir mais tarde. Depois que você distribui o build, os testadores recebem notificações por e-mail do Firebase convidando-os a testar o novo build.
No app/build.gradle.kts
, adicione uma seção firebaseAppDistribution
e inclua os seguintes parâmetros:
appID
: ID do app do Firebase do seu app. Ele está na guia Geral das Configurações do projeto.artifactType
: tipo de arquivo do app (AAB
).testers
: seus testadores endereços de e-mail. Neste codelab, adicione seu próprio e-mail para testar o build depois que ele for distribuído.
Exemplo:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
Como opção, você também pode substituir os valores definidos no build.gradle.kts
transmitindo argumentos de linha de comando na forma de -PappDistribution-property-name=property-value
.
5. Criar e distribuir uma versão
- Execute a tarefa
bundleVariant
do Gradle para criar o arquivo de pacotes de apps:$ ./gradlew :base:bundleRelease
- Localize o pacote no diretório de build do aplicativo (o local padrão é
app/build/outputs/bundle/release
). - Para distribuir a versão, crie os destinos
bundleRelease
eappDistributionUploadRelease
com o wrapper Gradle do projeto. Inclua o token do Firebase (o que você recebeu na etapa 3: adicionar o App Distribution ao seu app).export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
Os testadores vão receber convites por e-mail para fazer o download e testar o build. Agora, os desenvolvedores podem monitorar o build na guia Versões do painel "Distribuição de apps".
6. Fazer o download e testar a versão
Nesta seção, você será configurado como testador para fazer o download da versão que distribuiu. Como testador, você vai precisar autenticar seu dispositivo de teste e ativar o compartilhamento interno de apps no app Google Play Store.
- No dispositivo de teste, faça login na sua conta de e-mail de testador e abra o convite do Firebase.
- Faça login com sua Conta do Google e aceite o convite para testar a versão distribuída. Como opção, também é possível fazer o download do Firebase App Tester, que impede que versões baixadas sejam adicionadas à pasta
Downloads
do dispositivo. Ele também mostra outras informações sobre as versões, como o progresso do download e a versão de lançamento. - Toque em Fazer o download na versão para instalá-la na Play Store.
- Quando solicitado, conclua as etapas restantes para ativar o Compartilhamento interno de apps. As instruções são mostradas no dispositivo de teste e só precisam ser concluídas uma vez.
Quando o download for concluído, o lançamento vai aparecer automaticamente como um atalho na tela inicial do 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óximas etapas
- 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 ver informações sobre outras ferramentas que podem ser usadas para implantar seu app.