Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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:

App Distribution Build-Parameter
appId

Die Firebase-App-ID Ihrer App. Nur erforderlich, wenn Sie das Google Services Gradle-Plugin nicht installiert haben. Sie finden die App-ID in der Datei google-services.json oder in der Firebase-Konsole auf der Seite Allgemeine Einstellungen . Der Wert in Ihrer build.gradle Datei überschreibt den vom google-services Plugin ausgegebenen Wert.

appId="1:1234567890:android:321abc456def7890"
serviceCredentialsFile

Der Pfad zur JSON-Datei mit dem privaten Schlüssel Ihres Dienstkontos. Nur erforderlich, wenn Sie die Dienstkontoauthentifizierung verwenden.

apkPath

Absoluter oder relativer Pfad zu der APK-Datei, die Sie hochladen möchten. Wenn nicht angegeben, ermittelt Gradle den Speicherort der Datei mithilfe des APK-Ausgabeverzeichnisses.

releaseNotes oder releaseNotesFile

Versionshinweise für diesen Build.

Sie können entweder die Versionshinweise direkt oder den Pfad zu einer Nur-Text-Datei angeben.

testers oder testersFile

Die E-Mail-Adressen der Tester, an die Sie Builds verteilen möchten.

Sie können die Tester als durch Kommas getrennte Liste von E-Mail-Adressen angeben:

testers="ali@example.com, bri@example.com, cal@example.com"

Sie können auch den Pfad zu einer Datei angeben, die eine durch Kommas getrennte Liste von E-Mail-Adressen enthält:

testersFile="/path/to/testers.txt"
groups oder groupsFile

Die Testergruppen, an die Sie Builds verteilen möchten (siehe Tester verwalten ). Gruppen werden mit angegeben Gruppen-Aliase finden Sie auf der Registerkarte Tester in der Firebase App Distribution-Konsole.

Sie können die Gruppen als durch Kommas getrennte Liste von Gruppenaliasnamen angeben:

groups="qa-team, android-testers"

Sie können auch den Pfad zu einer Datei angeben, die eine durch Kommas getrennte Liste von Gruppenaliasnamen enthält:

groupsFile="/path/to/tester-groups.txt"
stacktrace

Druckt den Stacktrace für Benutzerausnahmen aus. Dies ist hilfreich beim Debuggen von Problemen.

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.