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 root (a livello di progetto) ( <project>/build.gradle o <project>/build.gradle.kts ), aggiungi il plug-in App Distribution Gradle come dipendenza buildscript:

   Groovy

   buildscript {
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   
     dependencies {
         ...
         classpath 'com.android.tools.build:gradle:7.2.0'
   
         // Make sure that you have the Google services Gradle plugin dependency
         classpath 'com.google.gms:google-services:4.3.14'
   
         // Add the dependency for the App Distribution Gradle plugin
         classpath 'com.google.firebase:firebase-appdistribution-gradle:3.1.1'
     }
   }
   

   Kotlin

   buildscript {
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   
     dependencies {
         ...
         classpath("com.android.tools.build:gradle:7.2.0")
   
         // Make sure that you have the Google services Gradle plugin dependency
         classpath("com.google.gms:google-services:4.3.14")
   
         // Add the dependency for the App Distribution Gradle plugin
         classpath("com.google.firebase:firebase-appdistribution-gradle:3.1.1")
     }
   }
   

2. Nel file Gradle del tuo modulo (a livello di app) (di solito <project>/<app-module>/build.gradle o <project>/<app-module>/build.gradle.kts ), aggiungi il plug-in Gradle di distribuzione app:

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

   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")
   }
   

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 in uno dei seguenti modi. Per impostazione predefinita, il plug-in Gradle cerca le credenziali dalla CLI di Firebase se non viene utilizzato nessun altro metodo di autenticazione.

Passaggio 3. Configura le proprietà della distribuzione

Nel file Gradle del tuo modulo (a livello di app) (di solito <project>/<app-module>/build.gradle o <project>/<app-module>/build.gradle.kts ), configura App Distribution aggiungendo almeno una sezione firebaseAppDistribution .

Ad esempio, per distribuire la build di release ai tester, segui queste istruzioni:

android {

  // ...

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

  // ...
}

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

android {

  // ...

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

  // ...
}

Puoi configurare la distribuzione dell'app 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", segui queste istruzioni:

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

  // ...
}

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

  // ...
}

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.

Prossimi passi

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

• Scopri le best practice per la distribuzione di app Android ai tester QA utilizzando CI/CD .