Verteilen Sie Android-Apps mit Gradle an Tester

Sie können App Distribution mithilfe des App Distribution Gradle-Plugins in Ihren Android-Erstellungsprozess integrieren. Mit dem Plugin können Sie Ihre Tester und build.gradle in der build.gradle Datei Ihrer App angeben und Distributionen für verschiedene Build-Typen und -Varianten Ihrer App konfigurieren.

Bevor Sie beginnen

Wenn Sie dies noch nicht getan haben, fügen Sie Firebase zu Ihrem Android-Projekt hinzu .

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie sich jedoch für die Verwendung zusätzlicher Produkte in der Zukunft entscheiden, müssen Sie alle Schritte auf der oben verlinkten Seite ausführen.

Schritt 1 . Richten Sie Ihr Android-Projekt ein

1. android/build.gradle in Ihrer Gradle-Datei auf Projektebene (normalerweise android/build.gradle ) das App Distribution-Plugin als Buildscript-Abhängigkeit hinzu:

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

2. android/app/build.gradle in Ihre Gradle-Datei auf App-Ebene (normalerweise android/app/build.gradle ) das App Distribution-Plugin unter dem Android-Plugin ein:

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

3. Wenn Sie sich hinter einem Unternehmens-Proxy oder einer Firewall befinden, fügen Sie die folgende Java-Systemeigenschaft hinzu , mit der App Distribution Ihre Distributionen auf Firebase hochladen kann:

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

Schritt 2 . Mit Firebase authentifizieren

Bevor Sie das Gradle-Plugin verwenden können, müssen Sie sich zunächst bei Ihrem Firebase-Projekt authentifizieren. Es gibt drei Möglichkeiten, dies zu erreichen:

Schritt 3 . Konfigurieren Sie Ihre Verteilungseigenschaften

1. In Ihrem app/build.gradle Datei configure App Verteilung durch mindestens eine Zugabe firebaseAppDistribution Abschnitts. Sie können die App-Verteilung sowohl für Build-Typen als auch für Produktvarianten konfigurieren . So verteilen Sie den release Build beispielsweise an Tester:

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

   Und um debug und release Builds in den Produktvarianten "Demo" und "Full" zu verteilen:

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

Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:

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"

Schritt 4 . Verteilen Sie Ihre App an Tester

Um Ihre Test-App zu verpacken und Tester einzuladen, erstellen Sie schließlich die Ziele assemble BUILD-VARIANT und appDistributionUpload BUILD-VARIANT mit dem Gradle-Wrapper Ihres Projekts, wobei BUILD-VARIANT die optionale Produktvariante und der Build-Typ ist, die Sie im vorherigen Schritt konfiguriert haben. Weitere Informationen zu Produktvarianten finden Sie unter Konfigurieren von Build-Varianten .

Führen Sie beispielsweise den folgenden Befehl aus, um Ihre App mithilfe der release Build-Variante zu verteilen:

./gradlew assembleRelease appDistributionUploadRelease

Wenn Sie sich bei Ihrem Google-Konto authentifiziert und in Ihrer Gradle- FIREBASE_TOKEN keine Anmeldeinformationen angegeben haben, geben Sie die Variable FIREBASE_TOKEN :

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

Sobald Sie Ihren Build verteilt haben, wird er 150 Tage (fünf Monate) lang im App Distribution-Dashboard der Firebase-Konsole verfügbar sein. Wenn der Build 30 Tage nach Ablauf abläuft, wird sowohl in der Konsole als auch in der Liste der Builds Ihres Testers auf dem Testgerät eine Ablaufbenachrichtigung angezeigt.

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen, um loszulegen, und vorhandene Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist (Anweisungen zum Installieren der Test-App finden Sie in der Anleitung zum Einrichten des Testers ). Sie können den Status jedes Testers in der Firebase-Konsole überwachen, ob er die Einladung angenommen und die App heruntergeladen hat.