Distribuisci app Android ai tester utilizzando Gradle

Puoi integrare la distribuzione dell'app nel processo di creazione di Android utilizzando il plug-in Gradle per la distribuzione dell'app. Il plug-in ti consente di specificare i tuoi tester e le note di rilascio nel file build.gradle della tua app, consentendoti di configurare le distribuzioni per diversi tipi di build e varianti della tua app.

Questa guida descrive come distribuire gli APK ai tester utilizzando il plug-in App Distribution Gradle.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android .

Se non utilizzi nessun altro prodotto Firebase, devi solo creare un progetto e registrare la tua app. Tuttavia, se decidi di utilizzare prodotti aggiuntivi in ​​futuro, assicurati di completare tutti i passaggi nella pagina collegata sopra.

Passaggio 1. Configura il tuo progetto Android

1. Nel tuo file Gradle a livello di progetto (di solito android/build.gradle ), aggiungi il plug-in App Distribution come dipendenza buildscript:

   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:3.0.2'
       }
   }
   

2. Nel tuo file Gradle a livello di app (di solito android/app/build.gradle ), includi il plug-in App Distribution sotto il plug-in Android:

   apply plugin: 'com.android.application'
   // ...
   
   // Apply the App Distribution Gradle plugin
   apply plugin: 'com.google.firebase.appdistribution'
   // ...
   

3. Se sei dietro un proxy o un firewall aziendale, 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
   

Passaggio 2. Autenticati con Firebase

Prima di poter utilizzare il plugin Gradle, devi prima autenticarti con il tuo progetto Firebase. Ci sono tre modi per raggiungere questo obiettivo:

Passaggio 3. Configura le proprietà della distribuzione

1. Nel tuo file app/build.gradle , configura App Distribution aggiungendo almeno una sezione firebaseAppDistribution . Ad esempio, per distribuire la build di release ai tester:

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

2. La distribuzione dell'app può essere configurata per i tipi di build e le versioni del prodotto . Ad esempio, per distribuire build di debug e release in versioni di prodotto "demo" e "complete":

   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"
             }
         }
       }
   
       // ...
   }
   

3. Utilizzare i seguenti parametri per configurare la distribuzione:

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"

Passaggio 4. Distribuisci la tua app ai tester

1. Infine, per creare un pacchetto della tua app di test e invitare i tester, crea i target BUILD-VARIANT e appDistributionUpload BUILD-VARIANT con il wrapper Gradle del tuo progetto, dove BUILD-VARIANT è il tipo di prodotto e build facoltativo che hai configurato nel passaggio precedente. Per ulteriori informazioni sulle varianti di prodotto, consulta Configurare varianti di build .

   Ad esempio, per distribuire la tua app utilizzando la release build variant, esegui il comando seguente:

   ./gradlew assembleRelease appDistributionUploadRelease
   

   Oppure, se ti sei autenticato con il tuo account Google e non hai fornito le credenziali nel tuo file di build Gradle, includi la variabile FIREBASE_TOKEN :

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

2. Puoi anche sovrascrivere i valori impostati nel tuo file build.gradle passando argomenti della riga di comando sotto forma di --<property-name>=<property-value> . Per esempio:

   • Per caricare una build di debug in App Distribution:

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

   • Per invitare tester aggiuntivi o rimuovere tester esistenti dal tuo progetto 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"
     

     Una volta che un tester è stato aggiunto al tuo progetto Firebase, puoi aggiungerlo a singole versioni. I tester che vengono rimossi non avranno più accesso ai rilasci nel tuo progetto, ma potrebbero comunque mantenere l'accesso ai rilasci per un periodo di tempo.

   Puoi anche specificare i tester usando --file="/path/to/testers.txt" invece di --emails .

   Le attività appDistributionAddTesters e appDistributionRemoveTesters accettano anche i seguenti argomenti:

   • projectNumber : il numero del tuo progetto Firebase.

   • serviceCredentialsFile : il percorso del file delle credenziali del servizio Google. Questo è lo stesso argomento utilizzato dall'azione di caricamento.

Una volta distribuita, la build diventa disponibile nella dashboard di distribuzione app della console Firebase per 150 giorni (cinque mesi). Quando la build è trascorsi 30 giorni dalla scadenza, viene visualizzato un avviso di scadenza sia nella console che nell'elenco delle build del tester sul dispositivo di test.

I tester che non sono stati invitati a testare l'app ricevono inviti e-mail per iniziare e i tester esistenti ricevono notifiche e-mail che una nuova build è pronta per il test (leggi la guida alla configurazione del tester per istruzioni su come installare l'app di test). Puoi monitorare lo stato di ogni tester, se ha accettato l'invito e se ha scaricato l'app, nella console di Firebase.

I tester hanno 30 giorni per accettare un invito a testare l'app prima che scada. Quando un invito è trascorsi 5 giorni dalla scadenza, viene visualizzato un avviso di scadenza nella console Firebase accanto al tester su una versione. Un invito può essere rinnovato inviandolo nuovamente utilizzando il menu a discesa nella riga del tester.

Passo successivo

Visita il codelab di Android App Bundle per scoprire come distribuire le versioni di app bundle passo dopo passo.