Catch up on highlights from Firebase at Google I/O 2023. Learn more

Verteilen Sie Android-Apps mithilfe der Firebase-Befehlszeilenschnittstelle an Tester

In diesem Leitfaden wird beschrieben, wie Android App Bundles (AABs) mithilfe der Firebase CLI an Tester verteilt werden. Mit dem CLI-Tool können Sie Tester und Versionshinweise für einen Build angeben und den Build dann entsprechend verteilen.

App Distribution lässt sich in den internen App-Sharing-Dienst von Google Play integrieren, um die von Ihnen hochgeladenen AABs zu verarbeiten und APKs bereitzustellen, die für die Gerätekonfigurationen Ihrer Tester optimiert sind. Durch das Verteilen von AABs können Sie Folgendes tun:

  • Führen Sie optimierte APKs (bereitgestellt von Google Play) aus, die für die Geräte Ihrer Tester optimiert sind.

  • Entdecken und debuggen Sie gerätespezifische Probleme.

  • Testen Sie App Bundle-Funktionen wie Play Feature Delivery und Play Asset Delivery .

  • Reduzieren Sie die Größe der Downloads für Ihre Tester.

Erforderliche Berechtigungen

Um AABs in App Distribution hochzuladen, müssen Sie Ihre Firebase-App mit einer App in Google Play verknüpfen . Sie müssen über die erforderliche Zugriffsebene verfügen, um diese Aktionen auszuführen.

Wenn Sie nicht über den erforderlichen Firebase-Zugriff verfügen, können Sie einen Firebase-Projektinhaber bitten, Ihnen die entsprechende Rolle über die IAM-Einstellungen der Firebase-Konsole zuzuweisen. Wenn Sie Fragen zum Zugriff auf Ihr Firebase-Projekt haben, einschließlich zum Suchen oder Zuweisen eines Eigentümers, lesen Sie die häufig gestellten Fragen zu „Berechtigungen und Zugriff auf Firebase-Projekte“ .

Die folgende Tabelle gilt für das Verknüpfen einer Firebase-App mit einer App in Google Play sowie für das Hochladen von AABs.

Aktion in der Firebase-Konsole Erforderliche IAM-Berechtigung IAM-Rolle(n), die standardmäßig erforderliche Berechtigungen enthalten Zusätzliche erforderliche Rolle(n)
Verknüpfen Sie eine Firebase-App mit einer App in Google Play firebase.playLinks.update Eine der folgenden Rollen: Zugriff auf ein Google Play-Entwicklerkonto als Administrator
Laden Sie AABs in die App-Verteilung hoch firebaseappdistro.releases.update Eine der folgenden Rollen: ––

Bevor Sie beginnen

  1. Fügen Sie Ihrem Android-Projekt Firebase hinzu , falls Sie dies noch nicht getan haben . Am Ende dieses Workflows haben Sie eine Firebase-Android-App in Ihrem Firebase-Projekt.

    Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie sich entscheiden, zusätzliche Produkte zu verwenden, stellen Sie sicher, dass Sie alle Schritte unter Hinzufügen von Firebase zu Ihrem Android-Projekt ausführen .

  2. Stellen Sie sicher, dass Ihre App die folgenden Anforderungen erfüllt, um einen Firebase-Link zu Google Play zu erstellen und AABs hochzuladen:

    • Die App in Google Play und die Firebase-Android-App sind beide mit demselben Paketnamen registriert.

    • Die App in Google Play wird auf dem App-Dashboard eingerichtet und auf einen der Google Play-Tracks verteilt (Internes Testen, Geschlossenes Testen, Offenes Testen oder Produktion).

    • Die Überprüfung der App in Google Play ist abgeschlossen und die App wird veröffentlicht. Ihre App wird veröffentlicht, wenn in der Spalte „App-Status“ einer der folgenden Status angezeigt wird: „Interner Test“ (kein interner Entwurfstest), „Geschlossener Test“, „Offener Test“ oder „Produktion“.

  3. Verknüpfen Sie Ihre Firebase Android App mit Ihrem Google Play-Entwicklerkonto:

    1. Gehen Sie in der Firebase-Konsole zu Ihren Projekteinstellungen und wählen Sie dann die Registerkarte Integrationen aus.

    2. Klicken Sie auf der Google Play- Karte auf Link .
      Wenn Sie bereits Links zu Google Play haben, klicken Sie stattdessen auf Verwalten .

    3. Befolgen Sie die Anweisungen auf dem Bildschirm, um die App Distribution-Integration zu aktivieren und auszuwählen, welche Firebase-Android-Apps mit Google Play verknüpft werden sollen.

    Erfahren Sie mehr über das Verknüpfen mit Google Play .

Schritt 1. Erstellen Sie Ihre App

Wenn Sie bereit sind, eine Vorabversion Ihrer App an Tester zu verteilen, erstellen Sie Ihr AAB (Anweisungen finden Sie in der Android Studio-Dokumentation ).

Schritt 2. Verteilen Sie Ihre App an Tester

Um Ihre App an Tester zu verteilen, laden Sie die Datei Ihrer App über die Firebase-Befehlszeilenschnittstelle hoch:

  1. Installieren oder aktualisieren Sie auf die neueste Version der Firebase CLI (wir empfehlen, die eigenständige Binärdatei für die für Ihr Betriebssystem spezifische CLI herunterzuladen). Stellen Sie sicher, dass Sie sich anmelden und testen, ob Sie auf Ihre Projekte zugreifen können.
  2. Wählen Sie auf der Seite App-Verteilung der Firebase-Konsole die App aus, die Sie verteilen möchten, und klicken Sie dann auf Erste Schritte .
  3. Führen Sie den Befehl appdistribution:distribute , um Ihre App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:

    appdistribution:Verteilungsoptionen
    --app

    Erforderlich : Die Firebase-App-ID Ihrer App. Sie finden die App-ID in der Firebase-Konsole auf der Seite „Allgemeine Einstellungen“ .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Ein Aktualisierungstoken, das gedruckt wird, wenn Sie Ihre CI-Umgebung mit der Firebase-CLI authentifizieren (weitere Informationen finden Sie unter Verwenden der CLI mit CI-Systemen ).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Versionshinweise für diesen Build.

    Sie können die Versionshinweise entweder direkt angeben:

    --release-notes "Text of release notes"

    Oder geben Sie den Pfad zu einer Nur-Text-Datei an:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Die E-Mail-Adressen der Tester, die Sie einladen möchten.

    Sie können die Tester als kommagetrennte Liste von E-Mail-Adressen angeben:

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

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

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Die Testergruppen, die Sie einladen möchten (siehe Tester verwalten ). Gruppen werden mit angegeben Gruppenaliase , die Sie in der Firebase-Konsole nachschlagen können.

    Sie können die Gruppen als kommagetrennte Liste angeben:

    --groups "qa-team, trusted-testers"

    Oder Sie können den Pfad zu einer einfachen Textdatei angeben, die eine durch Kommas getrennte Liste von Gruppennamen enthält:

    --groups-file "/path/to/groups.txt"
    --debug

    Ein Flag, das Sie einfügen können, um eine ausführliche Protokollausgabe zu drucken.

    Zum Beispiel:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    Die Firebase-CLI gibt nach dem Release-Upload die folgenden Links aus. Diese Links helfen Ihnen bei der Verwaltung von Binärdateien und stellen sicher, dass Tester und andere Entwickler die richtige Version haben:

    • firebase_console_uri – Ein Link zur Firebase-Konsole, der eine einzelne Version anzeigt. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen.
    • testing_uri – Ein Link zur Version im Tester-Erlebnis (native Android-App), mit dem Tester Versionshinweise anzeigen und die App auf ihrem Gerät installieren können. Der Tester benötigt Zugriff auf die Freigabe, um den Link verwenden zu können.
    • binary_download_uri – Ein signierter Link, der die App-Binärdatei (APK- oder AAB-Datei) direkt herunterlädt und installiert. Der Link läuft nach einer Stunde ab.

    Neben der Verteilung von Releases können Sie auch appdistribution:testers:add und appdistribution:testers:remove verwenden, um neue Tester einzuladen oder vorhandene Tester aus Ihrem Firebase-Projekt zu entfernen. Sobald ein Tester zu Ihrem Firebase-Projekt hinzugefügt wurde, können Sie ihn einzelnen Releases hinzufügen. Sobald Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Beachten Sie, dass kürzlich entfernte Tester noch für ein gewisses Zeitfenster Zugriff auf Ihre Veröffentlichungen behalten können.

    Zum Beispiel:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    Tester-E-Mails müssen durch ein Leerzeichen getrennt werden. Sie können Tester auch mit --file /path/to/testers.txt angeben.

Nachdem Sie Ihren Build verteilt haben, ist er 150 Tage (fünf Monate) lang im App-Verteilungs-Dashboard der Firebase-Konsole verfügbar. Wenn der Build in 30 Tagen abläuft, wird sowohl in der Konsole als auch in der Liste der Builds Ihres Testers auf seinem Testgerät ein Ablaufhinweis angezeigt.

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

Tester haben 30 Tage Zeit, um 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 für eine Version ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Tester-Zeile erneut senden.

Nächste Schritte