Android-Apps mit der Firebase CLI an Tester verteilen


In diesem Leitfaden wird beschrieben, wie Sie Android App Bundles (AABs) mithilfe der Firebase-Befehlszeile 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 ist in den Dienst für die interne App-Freigabe von Google Play eingebunden, um die von Ihnen hochgeladenen AABs zu verarbeiten und APKs bereitzustellen, die für die Gerätekonfigurationen Ihrer Tester optimiert sind. Die Bereitstellung von AABs bietet folgende Vorteile:

  • Optimierte APKs (von Google Play bereitgestellt) ausführen, die für die Geräte Ihrer Tester optimiert sind.

  • Gerätespezifische Probleme erkennen und beheben

  • 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

Wenn Sie Android App Bundles in App Distribution hochladen möchten, müssen Sie Ihre Firebase-App mit einer App in Google Play verknüpfen. Sie benötigen die erforderliche Zugriffsebene, um diese Aktionen auszuführen.

Wenn Sie nicht die erforderlichen Firebase-Zugriffsrechte haben, können Sie einen Firebase-Projektinhaber bitten, Ihnen die entsprechende Rolle über die IAM-Einstellungen in der Firebase Console zuzuweisen. Wenn Sie Fragen zum Zugriff auf Ihr Firebase-Projekt haben, z. B. wie Sie einen Inhaber finden oder zuweisen, lesen Sie die FAQs 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 Android App Bundles.

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

Hinweis

  1. Falls noch nicht geschehen, fügen Sie Ihrem Android-Projekt Firebase hinzu. 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 zusätzliche Produkte verwenden möchten, führen Sie alle Schritte unter Firebase zu Ihrem Android-Projekt hinzufügen aus.

  2. Öffnen Sie die Seite App Distribution der Firebase Console. Wählen Sie Ihr Firebase-Projekt aus, wenn Sie dazu aufgefordert werden, wählen Sie Ihre App über den App-Schnellzugriff aus und klicken Sie auf Jetzt starten.

  3. Ihre App muss die folgenden Anforderungen erfüllen, um eine Firebase-Verknüpfung zu Google Play zu erstellen und Android App Bundles hochzuladen:

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

    • Die App in Google Play wird im App-Dashboard eingerichtet und über einen der Google Play-Tracks veröffentlicht (interner, geschlossener oder offener Test bzw. 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“ (nicht „Entwurf“), „Geschlossener Test“, „Offener Test“ oder „Produktion“.

  4. So verknüpfen Sie Ihre Firebase-Android-App mit Ihrem Google Play-Entwicklerkonto:

    1. Rufen Sie in der Firebase-Konsole die Projekteinstellungen auf und wählen Sie den Tab Integrationen aus.

    2. Klicken Sie auf der Karte Google Play auf Verknüpfen.
      Wenn Sie bereits Verknüpfungen mit Google Play haben, klicken Sie stattdessen auf Verwalten.

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

    Weitere Informationen zum Verknüpfen mit Google Play

Schritt 1: App erstellen

Wenn Sie bereit sind, eine Vorabveröffentlichung Ihrer App an Tester zu verteilen, erstellen Sie Ihr AAB. Eine Anleitung dazu finden Sie in der Android Studio-Dokumentation.

Schritt 2: App für Tester bereitstellen

Wenn Sie Ihre App an Tester verteilen möchten, laden Sie die Datei Ihrer App mit der Firebase-Befehlszeile hoch:

  1. Installieren Sie die neueste Version der Firebase-Befehlszeile oder aktualisieren Sie sie. Wir empfehlen, die eigenständige Binärdatei für die Befehlszeile herunterzuladen, die für Ihr Betriebssystem spezifisch ist. Melden Sie sich an und prüfen Sie, ob Sie auf Ihre Projekte zugreifen können.

  2. Führen Sie den Befehl appdistribution:distribute aus, 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 ausgegeben wird, wenn Sie Ihre CI-Umgebung mit der Firebase-Befehlszeile authentifizieren. Weitere Informationen finden Sie unter Befehlszeile mit CI-Systemen verwenden . 

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

    Alternativ können Sie den Pfad zu einer Nur-Text-Datei angeben:

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

    Alternativ können Sie 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 Gruppen-Aliassen angegeben, 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"

    Sie können auch den Pfad zu einer Nur-Text-Datei mit einer durch Kommas getrennten Liste von Gruppennamen angeben:

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

    Ein Flag, das Sie einfügen können, um eine ausführliche Logausgabe zu drucken.
    --test-devices
    --test-devices-file

    Die Testgeräte, auf denen Sie Tests mit dem KI-Agent zum Testen von Anwendungen ausführen möchten.

    Sie können die Testgeräte als durch Semikolons getrennte Liste von Gerätespezifikationen angeben:

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

    Alternativ können Sie 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 Nutzername für die automatische Anmeldung, der bei Tests mit dem KI-Agenten zum Testen von Anwendungen verwendet werden soll.
    --test-password
    --test-password-file

    Das Passwort für die automatische Anmeldung, das bei Tests mit dem KI-Agenten zum Testen von Anwendungen verwendet werden soll.

    Alternativ können Sie den Pfad zu einer Nur-Text-Datei mit einem Passwort angeben:

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

    Ressourcenname für das Feld für den Nutzernamen für die automatische Anmeldung, das bei Tests mit dem KI-Agenten zum Testen von Anwendungen verwendet werden soll.
    --test-password-resource

    Ressourcenname für das Passwortfeld für die automatische Anmeldung, das bei Tests mit dem KI-Agent zum Testen von Anwendungen verwendet werden soll.
    --test-non-blocking

    Wenn diese Option beim Ausführen von KI-Agent zum Testen von Anwendungen-Tests festgelegt ist, werden die Tests mit dem Befehl gestartet und dann sofort zurückgegeben, anstatt auf den Abschluss zu warten. Die Testergebnisse finden Sie in der Firebase Console. Wenn dieses Flag nicht festgelegt ist, wird der Befehl blockiert, bis die Tests abgeschlossen sind. Wenn einer der Tests fehlschlägt, wird der Befehl mit einem Fehlercode beendet.
    --results-bucket

    Ein benutzerdefinierter Google Cloud Storage-Bucket (GCS), in dem Testergebnisse gespeichert werden. Wenn Sie dieses Feld leer lassen, wird der Standard-Bucket verwendet. Der Bucket muss einem Projekt mit aktivierter Abrechnung gehören. Wenn Sie einen Bucket angeben, fallen Abrechnungsgebühren für den verwendeten Speicher an.

    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 Upload des Release die folgenden Links aus. Über diese Links kannst du Binärdateien verwalten und dafür sorgen, dass Tester und andere Entwickler die richtige Version haben:

    • firebase_console_uri: Ein Link zur Firebase-Konsole, in der ein einzelner Release angezeigt wird. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen.
    • testing_uri: Ein Link zum Release in der Tester-Oberfläche (integrierte Android-App), über den Tester die Versionshinweise 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 Binärdatei der App (APK- oder AAB-Datei) direkt heruntergeladen und installiert wird. Der Link läuft nach einer Stunde ab.

    Tester und Gruppen verwalten

    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.

    Nachdem ein Tester Ihrem Firebase-Projekt hinzugefügt wurde, können Sie ihn einzelnen Releases hinzufügen. Wenn du einen Tester entfernst, hat er keinen Zugriff mehr auf Releases in deinem Projekt. Beachte, dass Tester, die vor Kurzem entfernt wurden, möglicherweise noch eine Zeit lang Zugriff auf deine Releases haben.

    Beispiel:

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

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

    Die E‑Mail-Adressen der Tester 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 Gruppen verwenden: Mit appdistribution:group:create und appdistribution:group:delete können Sie Gruppen in Ihrem Firebase-Projekt erstellen oder löschen.

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

    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

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

Tester, die noch nicht zum Testen der App eingeladen wurden, erhalten eine Einladung per E-Mail, um loszulegen. Bestehende Tester erhalten eine E-Mail-Benachrichtigung, dass ein neuer Build zum Testen bereit ist. Eine Anleitung zum Installieren der Test-App findest du im Leitfaden zur Einrichtung für Tester. In der Firebase Console kannst du den Status der einzelnen Tester im Blick behalten, also ob sie die Einladung angenommen und 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 Console neben dem Tester für einen Release ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem sie über das Drop-down-Menü in der Zeile des Testers noch einmal gesendet wird.

Nächste Schritte