Distribuisci le versioni del bundle dell'app ai tester - Codelab

1. Panoramica

In questo codelab imparerai come distribuire le versioni di Android App Bundle ai tester utilizzando Firebase App Distribution e il suo plug-in Gradle. App Distribution fornisce un hub centrale per la gestione delle versioni pre-release della tua app e dei tester che inviti a ogni release.

Cosa imparerai

• Come collegare la tua app Firebase a Google Play
• Come impacchettare e creare la tua app come un app bundle
• Come creare una versione e condividerla con i live tester
• Come scaricare e testare le nuove versioni come tester

Di cosa avrai bisogno

• Ultima versione di Android Studio
• Un file bundle firmato che hai generato da Android Studio
• Un account sviluppatore Google Play di cui sei il proprietario o l'amministratore
• La tua app in Google Play è configurata nella dashboard dell'app Google Play e presenta il seguente stato :
  • L'app viene distribuita su uno dei percorsi di Google Play (test interni, test chiusi, test aperti o produzione).
  • La revisione dell'app in Google Play è completa e l'app è pubblicata. La tua app è pubblicata se la colonna Stato app mostra uno dei seguenti stati: test interno (non test interno bozza), test chiuso, test aperto o produzione.
• Un indirizzo email che puoi utilizzare come tester per ricevere inviti a nuove build da Firebase

2. Crea un progetto Firebase

1. Accedi a Firebase .
2. Nella console Firebase, fai clic su Aggiungi progetto , quindi assegna al progetto il nome "AppBundlesCodelab". Ricorda l'ID progetto per il tuo progetto Firebase. Se non modifichi l'ID progetto, Firebase assegna automaticamente un ID univoco al tuo progetto.
   
   
3. (Facoltativo) Quando richiesto, abilita Google Analytics.
4. Completa i passaggi rimanenti, quindi fai clic su Crea progetto .

Aggiungi il tuo app bundle al progetto

1. Nella console Firebase, fai clic su Aggiungi app .
   
   
2. Quando registri la tua app, assicurati di utilizzare lo stesso nome di pacchetto dell'app caricata nel tuo account sviluppatore Google Play. Infine, fai clic su Registra app .
3. Completa i passaggi rimanenti per aggiungere il file di configurazione Firebase della tua app ( google-services.json ) alla tua app. Tieni presente che per Android, App Distribution non dispone di un SDK Firebase da aggiungere alla tua app.
4. Fai clic su Continua alla console .

Collegamento a Google Play

1. Nella console Firebase, vai alle impostazioni del tuo progetto .
   
   
2. Nella scheda Integrazioni , fai clic su Link nella scheda Google Play .
3. Segui le istruzioni sullo schermo per abilitare l'integrazione di App Distribution, quindi seleziona l'app Firebase appena creata per collegarla a Google Play.

Ora che hai completato questi passaggi, la tua app Firebase sarà collegata alla tua app nel tuo account sviluppatore Google Play, a condizione che i nomi dei pacchetti delle app corrispondano.

3. Aggiungi App Distribution al tuo progetto

Aggiungere il plug-in Gradle di distribuzione app

Ora utilizzerai Android Studio per aggiungere App Distribution e il relativo plug-in Gradle alla tua app.

1. Nel file Gradle a livello di progetto ( android/build.gradle.kts ), aggiungi il plug-in Gradle di distribuzione app al blocco plugins .

   plugins {
        //...
   
        // Add the App Distribution Gradle plugin
        id("com.google.firebase.appdistribution") version "4.0.0" apply false
   }
   

2. Nel file Gradle delle impostazioni a livello di progetto ( android/settings.gradle.kts ), aggiungi il repository Maven di Google al blocco pluginManagement .

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. Nel file Gradle a livello di app ( android/app/build.gradle.kts ), aggiungi il plug-in App Distribution al blocco plugins .

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. Se sei protetto da un proxy aziendale o da un firewall, aggiungi la seguente proprietà di sistema Java che consente a App Distribution di caricare le tue distribuzioni su Firebase:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

Autentica il tuo progetto Firebase

Prima di poter utilizzare il plug-in Gradle, devi autenticare il tuo progetto Firebase. Per questo codelab, accederai al tuo account Google utilizzando l'azione di accesso del plug-in.

1. Esegui il seguente comando nella radice del tuo progetto Android:

   ~/your-android-project$ ./gradlew appDistributionLogin
   

2. Quando il comando stampa un collegamento di autenticazione, aprilo in un browser. Quando richiesto, accedi al tuo account Google e concedi l'autorizzazione per accedere al tuo progetto Firebase. Il comando Gradle stampa un token di aggiornamento, che il plug-in App Distribution utilizza per l'autenticazione con Firebase.
3. Imposta la variabile di ambiente FIREBASE_TOKEN sul token del passaggio precedente:

   ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
   

4. Configura le proprietà del pacchetto in Android Studio

In questo passaggio, ti aggiungerai come tester per la build che distribuirai in seguito. Una volta distribuita la build, i tester ricevono notifiche e-mail da Firebase che li invitano a testare la nuova build.

Nella tua app/build.gradle.kts , aggiungi una sezione firebaseAppDistribution e includi i seguenti parametri:

• appID : l'ID app Firebase della tua app. Puoi trovarlo nella scheda Generale delle impostazioni del tuo progetto .
• artifactType : il tipo di file della tua app ( AAB ).
• testers : gli indirizzi email dei tuoi tester. Per questo codelab, aggiungi la tua e-mail in modo da poter testare la tua build una volta distribuita.

Per esempio:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Come opzione, puoi anche sovrascrivere i valori impostati nel tuo build.gradle.kts passando gli argomenti della riga di comando nella forma di -PappDistribution- property-name = property-value .

5. Crea e distribuisci una versione

1. Esegui l'attività bundle Variant per creare il file dei bundle dell'app:

   $ ./gradlew :base:bundleRelease
   

2. Individua il bundle nella directory di build della tua applicazione (il percorso predefinito è app/build/outputs/bundle/release ).
3. Per distribuire la versione, crea gli obiettivi bundleRelease e appDistributionUploadRelease con il wrapper Gradle del tuo progetto. Includi il token Firebase (quello che hai ricevuto nel passaggio 3: aggiungi App Distribution alla tua app).

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

I tester riceveranno ora e-mail di invito a scaricare e testare la build. In qualità di sviluppatore, ora puoi monitorare la build nella scheda Release della dashboard di App Distribution.

6. Scarica e prova la tua versione

In questa sezione, verrai configurato come tester per scaricare la versione che hai distribuito. In qualità di tester, dovrai autenticare il tuo dispositivo di prova e abilitare la condivisione interna delle app nell'app Google Play Store.

1. Sul tuo dispositivo di prova, accedi al tuo account email del tester e apri l'invito da Firebase.
   
   
2. Accedi con il tuo account Google e accetta l'invito a testare la versione distribuita. Come opzione, puoi anche scaricare Firebase App Tester , che impedisce alle versioni scaricate di essere aggiunte alla cartella Downloads del tuo dispositivo. Visualizza inoltre informazioni aggiuntive sui rilasci, come l'avanzamento del download e la versione del rilascio.
   
   
3. Tocca Scarica sulla versione per installarla dal Play Store.
4. Quando richiesto, completare i passaggi rimanenti per abilitare la condivisione interna dell'app (le istruzioni vengono visualizzate sul dispositivo di prova e devono essere completate solo una volta).

Una volta completato il download, la tua versione apparirà automaticamente come scorciatoia nella schermata iniziale del tuo dispositivo.

7. Congratulazioni!

Hai appena utilizzato Firebase App Distribution per caricare un app bundle e distribuire una versione ai tester.

Prossimi passi

• Vai alla documentazione di App Distribution per saperne di più su come gestire i tester per la tua versione.
• Vedi Creare e testare il tuo Android App Bundle per informazioni su altri strumenti che puoi usare per distribuire la tua app.