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

In dieser Anleitung wird beschrieben, wie Sie Android App Bundles (AABs) mithilfe der Firebase-CLI an Tester verteilen. 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 beheben 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 ausführen zu können.

Wenn Sie nicht über den erforderlichen Firebase-Zugriff verfügen, können Sie einen Firebase-Projekteigentümer bitten, Ihnen über die IAM-Einstellungen der Firebase-Konsole die entsprechende Rolle zuzuweisen. Wenn Sie Fragen zum Zugriff auf Ihr Firebase-Projekt haben, einschließlich der Suche oder Zuweisung eines Eigentümers, lesen Sie die FAQs „Berechtigungen und Zugriff auf Firebase-Projekte“ .

Die folgende Tabelle gilt für die Verknüpfung 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-Rollen, die standardmäßig die erforderlichen Berechtigungen enthalten Zusätzlich 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. Falls noch nicht geschehen, fügen Sie Firebase zu Ihrem Android-Projekt hinzu . Am Ende dieses Workflows verfügen Sie über 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. Um einen Firebase-Link zu Google Play zu erstellen und AABs hochzuladen, stellen Sie sicher, dass Ihre App die folgenden Anforderungen erfüllt:

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

    • Die App in Google Play wird im App-Dashboard eingerichtet und an einen der Google Play-Tracks verteilt (interner Test, geschlossener Test, offener Test oder Produktion).

    • Die Überprüfung der App in Google Play ist abgeschlossen und die App veröffentlicht. Ihre App wird veröffentlicht, wenn in der Spalte „App-Status“ einer der folgenden Status angezeigt wird: Interner Test (kein interner Testentwurf), 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 Ihrem 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 die Verknüpfung 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 mit der Firebase-CLI hoch:

  1. Installieren oder aktualisieren Sie die neueste Version der Firebase-CLI (wir empfehlen, die eigenständige Binärdatei für die für Ihr Betriebssystem spezifische CLI herunterzuladen). Melden Sie sich unbedingt an und testen Sie, 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:Distribute-Optionen
    --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 durch Kommas getrennte Liste von E-Mail-Adressen angeben:

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

    Oder Sie können den Pfad zu einer Nur-Text-Datei 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 durch Kommas getrennte Liste angeben:

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

    Oder Sie können den Pfad zu einer Nur-Text-Datei angeben, die eine durch Kommas getrennte Liste von Gruppennamen enthält:

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

    Ein Flag, das Sie einschließen können, um eine ausführliche Protokollausgabe zu drucken.

    --test-devices
    --test-devices-file

    Die folgenden Verteilungstypen sind Teil der Betafunktion des automatisierten Testers .

    Die Testgeräte, an die Sie Builds verteilen möchten (siehe Automatisierte Tests ).

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

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    Oder Sie können den Pfad zu einer Nur-Text-Datei angeben, die eine durch Semikolons getrennte Liste von Testgeräten enthält:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Der Benutzername für die automatische Anmeldung, der bei automatisierten Tests verwendet wird.

    --test-password
    --test-password-file

    Das Passwort für die automatische Anmeldung, das bei automatisierten Tests verwendet wird.

    Oder Sie können den Pfad zu einer Nur-Text-Datei angeben, die ein Passwort enthält:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Ressourcenname für das Benutzernamenfeld für die automatische Anmeldung, das bei automatisierten Tests verwendet werden soll.

    --test-password-resource

    Ressourcenname für das Passwortfeld für die automatische Anmeldung, das bei automatisierten Tests verwendet werden soll.

    --test-non-blocking

    Führen Sie automatisierte Tests asynchron aus. Besuchen Sie die Firebase-Konsole für die automatischen Testergebnisse.

    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 über die richtige Version verfügen:

    • 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 Veröffentlichung im Tester-Erlebnis (native Android-App), mit dem Tester Versionshinweise anzeigen und die App auf ihrem Gerät installieren können. Um den Link nutzen zu können, benötigt der Tester Zugriff auf die Freigabe.
    • 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.

    Verwalten Sie Tester und Gruppen

    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 zu einzelnen Releases hinzufügen. Sobald Sie einen Tester entfernen, hat dieser keinen Zugriff mehr auf Releases in Ihrem Projekt. Beachten Sie, dass Tester, die kürzlich entfernt wurden, noch für einen bestimmten Zeitraum 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.

    Wenn Sie eine große Anzahl von Testern haben, sollten Sie die Verwendung von Gruppen in Betracht ziehen: Sie können appdistribution:group:create und appdistribution:group:delete verwenden, um Gruppen in Ihrem Firebase-Projekt zu erstellen oder zu löschen.

    Verwenden Sie --group-alias , um eine Gruppe für die appdistribution:testers:add und appdistribution:testers:remove anzugeben.

    Zum Beispiel:

    firebase appdistribution:group:create "QA team" qa-team
    
    firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:group:delete qa-team
    

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

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen zum Einstieg, und bestehende Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist (Anweisungen zur Installation der Test-App finden Sie im Einrichtungshandbuch für Tester). 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, eine Einladung zum Testen der App anzunehmen, bevor diese abläuft. Wenn eine Einladung fünf Tage vor dem Ablauf steht, wird in der Firebase-Konsole neben dem Tester einer Veröffentlichung eine Ablaufbenachrichtigung angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Testerzeile erneut senden.

Nächste Schritte