Distribuisci le versioni dell'app bundle ai tester: Codelab

1. Panoramica

immagine10.png

In questo codelab imparerai come distribuire le versioni di Android App Bundle ai tester utilizzando Firebase App Distribution e il relativo plug-in Gradle. App Distribution fornisce un hub centrale per gestire le versioni pre-release della tua app e i tester che inviti a ciascuna versione.

Cosa imparerai

  • Come collegare la tua app Firebase a Google Play
  • Come creare un pacchetto e creare la tua app come app bundle
  • Come creare una versione e condividerla con i tester dal vivo
  • 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 ha il seguente stato :
    • L'app viene distribuita in uno dei percorsi di Google Play (Test interno, Test chiuso, Test aperto o Produzione).
    • La revisione dell'app su Google Play è completata e l'app è pubblicata. La tua app viene pubblicata se nella colonna Stato app viene visualizzato 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 il nome al progetto "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.

    immagine8.png
  3. (Facoltativo) Quando richiesto, attiva 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 .

    immagine5.png
  2. Quando registri la tua app, assicurati di utilizzare lo stesso nome del pacchetto dell'app caricata sul 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 sulla console .
  1. Nella console Firebase, vai alle Impostazioni progetto .

    immagine2.png
  2. Nella scheda Integrazioni , fai clic su Collegamento sulla scheda Google Play .
  3. Segui le istruzioni visualizzate 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 purché i nomi dei pacchetti delle app corrispondano.

3. Aggiungi la distribuzione delle app al tuo progetto

Aggiungi il plug-in App Distribution Gradle

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 App Distribution Gradle 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 ad 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, dovrai autenticare il tuo progetto Firebase. Per questo codelab, accederai al tuo Account Google utilizzando la CLI Firebase .

Esegui il seguente comando nella root del tuo progetto Android:

~/your-android-project$ firebase login

La documentazione di riferimento contiene maggiori dettagli.

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 via email da Firebase che li invitano a testare la nuova build.

Nel tuo 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 progetto .
  • artifactType : il tipo di file della tua app ( AAB ).
  • testers : indirizzi email dei tuoi tester. Per questo codelab, aggiungi il tuo indirizzo email in modo da poter testare la 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 nel formato -PappDistribution- property-name = property-value .

5. Costruisci 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 build della tua applicazione (il percorso predefinito è app/build/outputs/bundle/release ).
  3. Per distribuire la versione, crea le destinazioni bundleRelease e appDistributionUploadRelease con il wrapper Gradle del tuo progetto. Includi il token Firebase (quello che hai ricevuto nel passaggio 3: aggiungi la distribuzione dell'app alla tua app).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

I tester ora riceveranno inviti via email per scaricare e testare la build. In qualità di sviluppatore, ora puoi monitorare la build nella scheda Versioni del dashboard Distribuzione app.

6. Scarica e prova la tua versione

In questa sezione verrai impostato 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 di tester e apri l'invito da Firebase.

    immagine6.png
  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 che le versioni scaricate vengano aggiunte alla cartella Downloads del tuo dispositivo. Visualizza inoltre informazioni aggiuntive sulle versioni, come l'avanzamento del download e la versione di rilascio.

    immagine9.png
  3. Tocca Scarica sulla versione per installarla dal Play Store.
  4. Quando richiesto, completa i passaggi rimanenti per abilitare la condivisione interna delle 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 collegamento 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