Android-Apps mit Gradle für Tester bereitstellen

Sie können App Distribution mit dem App Distribution-Gradle-Plug-in in Ihren Android-Build-Prozess einbinden. Mit dem Plug-in können Sie Ihre Tester und Release-Notes in der Gradle-Datei Ihrer App angeben und so Bereitstellungen für verschiedene Buildtypen und Varianten Ihrer App konfigurieren.

In dieser Anleitung wird beschrieben, wie Sie APKs mit dem App Distribution Gradle-Plug-in an Tester verteilen.

Hinweis

Fügen Sie Ihrem Android-Projekt Firebase hinzu, falls noch nicht geschehen.

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie jedoch in Zukunft zusätzliche Produkte verwenden möchten, müssen Sie alle Schritte auf der oben verlinkten Seite ausführen.

Schritt 1: Android-Projekt einrichten

1. Fügen Sie in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) das App Distribution-Gradle-Plug-in als Abhängigkeit hinzu:

   Kotlin

   plugins {
       // ...
       id("com.android.application") version "7.3.0" apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.2" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "5.0.0" apply false
   }

   Groovy

   plugins {
       // ...
       id 'com.android.application' version '7.3.0' apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.2' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '5.0.0' apply false
   }

2. Fügen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) das Gradle-Plug-in App Distribution hinzu:

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

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

3. Wenn Sie sich hinter einem Unternehmensproxy oder einer Firewall befinden, fügen Sie die folgende Java-Systemeigenschaft hinzu, damit 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-Plug-in verwenden können, müssen Sie sich mit einer der folgenden Methoden bei Ihrem Firebase-Projekt authentifizieren. Standardmäßig sucht das Gradle-Plug-in nach Anmeldedaten aus der Firebase-Befehlszeile, wenn keine andere Authentifizierungsmethode verwendet wird.

Schritt 3: Vertriebseigenschaften konfigurieren

Konfigurieren Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) App Distribution. Fügen Sie dazu mindestens einen firebaseAppDistribution-Abschnitt hinzu.

Wenn Sie beispielsweise den release-Build an Tester verteilen möchten, gehen Sie so vor:

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

android {

  // ...

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

  // ...
}

android {

  // ...

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

  // ...
}

Sie können App Distribution für Build-Typen und Produkt-Varianten konfigurieren.

Wenn Sie beispielsweise debug- und release-Builds in den Produktvarianten „demo“ und „full“ bereitstellen möchten, gehen Sie so vor:

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

  // ...
}

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"

testDevices="model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

testDevicesFile="/path/to/testDevices.txt"

testPasswordFile="/path/to/testPassword.txt"

Schritt 4: App an Tester verteilen

1. Um Ihre Test-App zu verpacken und Tester einzuladen, erstellen Sie abschließend die Ziele BUILD-VARIANT und appDistributionUploadBUILD-VARIANT mit dem Gradle-Wrapper Ihres Projekts. Dabei ist BUILD-VARIANT die optionale Produktvariante und der Build-Typ, die bzw. den Sie im vorherigen Schritt konfiguriert haben. Weitere Informationen zu Produktvarianten finden Sie unter Build-Varianten konfigurieren.

   Wenn Sie Ihre App beispielsweise mit der Buildvariante release verteilen möchten, führen Sie den folgenden Befehl aus:

   ./gradlew assembleRelease appDistributionUploadRelease
   

   Wenn Sie sich mit Ihrem Google-Konto authentifiziert haben, aber keine Anmeldedaten in der Gradle-Build-Datei angegeben haben, fügen Sie die Variable FIREBASE_TOKEN ein:

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

2. Sie können die in der Datei build.gradle festgelegten Werte auch überschreiben, indem Sie Befehlszeilenargumente im Format --<property-name>=<property-value> übergeben. Beispiel:

   • So laden Sie einen Debug-Build auf App Distribution hoch:

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

   • So laden Sie weitere Tester ein oder entfernen vorhandene Tester aus Ihrem Firebase-Projekt:

     ./gradlew appDistributionAddTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     ./gradlew appDistributionRemoveTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"

     Nachdem ein Tester Ihrem Firebase-Projekt hinzugefügt wurde, können Sie ihn einzelnen Releases hinzufügen. Entfernte Tester haben keinen Zugriff mehr auf Releases in Ihrem Projekt, behalten aber möglicherweise für einen bestimmten Zeitraum Zugriff auf Ihre Releases.

   Du kannst Tester auch mit --file="/path/to/testers.txt" anstelle von --emails angeben.

   Die Aufgaben appDistributionAddTesters und appDistributionRemoveTesters akzeptieren außerdem die folgenden Argumente:

   • projectNumber: Ihre Firebase-Projektnummer.

   • serviceCredentialsFile: Der Pfad zur Anmeldedatendatei für Google-Dienste. Dies ist dasselbe Argument, das auch für die Uploadaktion verwendet wird.

Das Gradle-Plug-in gibt nach dem Upload des Release die folgenden Links aus. Über diese Links können Sie Binärdateien verwalten und dafür sorgen, dass Tester und andere Entwickler die richtige Version haben:

• firebase_console_uri: Ein Link zur Firebase-Konsole mit einer einzelnen Version. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen.
• testing_uri – Ein Link zum Release in der Testeroberfläche (native Android-App), über den Tester Release-Notes aufrufen und die App auf ihrem Gerät installieren können. Der Tester benötigt Zugriff auf den Release, um den Link verwenden zu können.
• binary_download_uri: Ein signierter Link, über den die App-Binärdatei (APK- oder AAB-Datei) direkt heruntergeladen und installiert wird. Der Link läuft nach einer Stunde ab.

Sobald Sie Ihren Build veröffentlicht haben, ist er 150 Tage (fünf Monate) lang im App Distribution-Dashboard der Firebase-Konsole verfügbar. 30 Tage vor Ablauf des Builds wird sowohl in der Konsole als auch in der Liste der Builds auf dem Testgerät des Testers eine entsprechende Benachrichtigung angezeigt.

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen zum Starten und bestehende Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build getestet werden kann. Eine Anleitung zum Installieren der Test-App finden Sie im Leitfaden zum Einrichten der Test-App. In der Firebase-Konsole kannst du den Status der einzelnen Tester verfolgen und nachsehen, ob sie die Einladung angenommen haben und ob sie die App heruntergeladen haben.

Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung in 5 Tagen abläuft, wird in der Firebase-Konsole neben dem Tester in einer Version eine entsprechende Benachrichtigung angezeigt. Eine Einladung kann verlängert werden, indem Sie sie über das Drop-down-Menü in der Zeile des Testers noch einmal senden.

Nächste Schritte

• Implementieren Sie In-App-Feedback, damit Tester ganz einfach Feedback zu Ihrer App senden können (einschließlich Screenshots).

• Weitere Informationen

• Im Android App Bundle-Codelab erfahren Sie Schritt für Schritt, wie Sie App Bundle-Releases verteilen.

• Best Practices für die Bereitstellung von Android-Apps für QA-Tester mit CI/CD