Android-Apps mit der Firebase CLI an Tester verteilen


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

App Distribution lässt sich in den internen App-Freigabedienst von Google Play einbinden, um die hochgeladenen AABs verarbeiten und APKs bereitstellen, die für die Tester Ihrer Tester optimiert sind Gerätekonfigurationen. Wenn Sie AABs bereitstellen, haben Sie folgende Möglichkeiten:

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

  • Gerätespezifische Probleme erkennen und beheben

  • App Bundle-Funktionen wie Bereitstellung von Google Play-Funktionen und Play Asset Delivery.

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

Erforderliche Berechtigungen

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

Wenn Sie nicht die erforderlichen Firebase-Zugriffsrechte haben, können Sie ein Firebase-Projekt anfordern Inhaber, um Ihnen die entsprechende Rolle über das IAM-Einstellungen der Firebase-Konsole. Wenn Sie Fragen zum Zugriff auf Ihr Firebase-Projekt haben, z. B. wenn Sie einen Inhaber finden oder zuweisen, „Berechtigungen und Zugriff auf Firebase-Projekte“ FAQs.

Die folgende Tabelle gilt für das Verknüpfen einer Firebase-App mit einer App in Google Play und laden AABs hoch.

Aktion in der Firebase-Konsole Erforderliche IAM-Berechtigung IAM-Rolle(n), die die erforderlichen Berechtigungen von Standardeinstellung 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 Verwaltung
AABs in App Distribution hochladen firebaseappdistro.releases.update Eine der folgenden Rollen: –

Hinweis

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

    Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur Projekt erstellen und Ihre App registrieren. Wenn Sie zusätzliche führen Sie alle Schritte in Fügen Sie Ihrem Android-Projekt Firebase hinzu.

  2. Damit Sie eine Firebase-Verknüpfung zu Google Play erstellen und AABs hochladen können, müssen folgende Voraussetzungen erfüllt sein: Ihre App die folgenden Anforderungen erfüllt:

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

    • Die App wird in Google Play in der App eingerichtet. Dashboard und in einem der Google Play-Tracks veröffentlicht (Interner Test, „Geschlossener Test“, „Offener Test“ oder „Produktion“).

    • Die Überprüfung der App in Google Play ist abgeschlossen und die App wird veröffentlicht. Ihre App ist veröffentlicht, wenn in der Spalte App-Status einer der folgenden Werte angezeigt wird: folgenden Status: Interne Tests (nicht Entwurf für interne Tests), Geschlossene Tests, offene Tests oder Produktion.

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

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

    2. Klicken Sie auf der Karte Google Play auf Verknüpfen.
      Wenn du bereits Verknüpfungen mit Google Play hast, klicke auf Verwalten stattdessen.

    3. Folge der Anleitung auf dem Bildschirm, um App Distribution zu aktivieren Integration und wählen Sie aus, welche Firebase-Android-Apps mit Google verknüpft werden sollen Spielen.

    Weitere Informationen über mit Google Play verknüpft sind.

Schritt 1: App erstellen

Wenn Sie eine Vorabveröffentlichung Ihrer App für Tester veröffentlichen möchten, AAB erstellen (besuchen Sie die Android Studio-Dokumentation .

Schritt 2: App an Tester vertreiben

Um Ihre App an Tester zur Verfügung zu stellen, laden Sie die Datei Ihrer App über die Firebase-Befehlszeile:

  1. Installieren Sie die Firebase-Befehlszeile oder aktualisieren Sie sie auf die neueste Version (Wir empfehlen, das eigenständige Binärprogramm für die für Ihr Betriebssystem spezifische Befehlszeile herunterzuladen.) Melden Sie sich an und prüfen Sie, ob Sie auf Ihre Projekte zugreifen können. verwenden.
  2. Wählen Sie auf der Seite App Distribution der Firebase-Konsole die App aus, die Sie vertreiben möchten, und klicken Sie dann auf Jetzt starten.

  3. Führen Sie den Befehl appdistribution:distribute aus, um Ihre Anwendung hochzuladen, und und an die Tester verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung:

    appdistribution:distribute-Optionen
    --app

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

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

    Ein Aktualisierungstoken, das bei der Authentifizierung Ihrer CI ausgegeben wird Umgebung mit der Firebase-Befehlszeile (Lesen Befehlszeile mit CI verwenden Systeme . 

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

    Versionshinweise für diesen Build.

    Sie können die Versionshinweise direkt angeben:

    --release-notes "Text of release notes"

    Alternativ können Sie den Pfad zu einer Klartextdatei 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 ein kommagetrennte Liste von E-Mail-Adressen:

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

    Die Testergruppen, die Sie einladen möchten (siehe Tester verwalten. Gruppen werden mithilfe von Gruppenaliassen angegeben, die Sie in der Firebase-Konsole nach.

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

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

    Alternativ können Sie den Pfad zu einer Nur-Text-Datei angeben, die ein kommagetrennte Liste von Gruppennamen:

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

    Ein Flag, das Sie verwenden können, um eine ausführliche Logausgabe auszugeben.
    --test-devices
    --test-devices-file

    Die folgenden Verteilungstypen sind Teil der Betafunktion für automatisierte Tester.

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

    Du kannst die Tester als eine durch Kommas getrennte Liste von E-Mail-Adressen angeben Adressen:

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

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

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

    Der Nutzername für die automatische Anmeldung, der bei automatisierten Tests verwendet werden soll.
    --test-password
    --test-password-file

    Das Passwort für die automatische Anmeldung, das bei automatisierten Tests 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 „Nutzername“ für die automatische Anmeldung, der bei automatisierten Tests verwendet wird
    --test-password-resource

    Ressourcenname für das Passwortfeld für die automatische Anmeldung, der bei automatisierten Tests verwendet wird
    --test-non-blocking

    Führen Sie automatisierte Tests asynchron aus. Rufen Sie die Firebase Console auf, um die Ergebnisse des automatischen Tests zu sehen.

    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. Mit diesen Links können Sie Binärprogramme verwalten und dafür sorgen, dass Tester und andere Entwickelnden die richtige Version haben:

    • firebase_console_uri – ein Link zum Firebase-Konsole mit einer einzelnen Veröffentlichung. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen.
    • testing_uri – ein Link zum Release im Tester Erfahrung (native Android-App) mit der Tester den Release Notizen machen und die App auf ihrem Gerät installieren. Der Tester benötigt um den Link zu nutzen.
    • binary_download_uri: ein signierter Link, der direkt das App-Binärprogramm herunterlädt und installiert (APK- oder AAB-Datei) . Der Link läuft nach einer Stunde ab.

    Tester und Gruppen verwalten

    Neben der Veröffentlichung von Releases appdistribution:testers:add und appdistribution:testers:remove, um neue Tester einzuladen oder zu entfernen vorhandenen Testern aus Ihrem Firebase-Projekt.

    Nach dem Hinzufügen eines Testers Ihrem Firebase-Projekt hinzugefügt haben, können Sie sie einzelnen Releases hinzufügen. Wenn Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Hinweis: Tester, die vor Kurzem entfernt wurden, können haben noch für einen bestimmten Zeitraum Zugriff auf Ihre Releases.

    Beispiel:

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

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

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

    Wenn Sie viele Tester haben, sollten Sie Gruppen verwenden: Sie können appdistribution:group:create und appdistribution:group:delete, um Gruppen in Firebase zu erstellen oder zu löschen Projekt arbeiten.

    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

Sobald Sie Ihren Build veröffentlicht haben, ist er 150 Tage (fünf Monate) lang im App Distribution-Dashboard der Firebase-Konsole verfügbar. Wenn der Build innerhalb von 30 Tagen abläuft, erscheint in beiden die Konsole und die Liste der Builds auf dem Testgerät.

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen zu und bestehende Tester erhalten E-Mail-Benachrichtigungen, kann jetzt getestet werden (siehe Einrichtungsleitfaden für Tester für die Installation des Tests App). Sie können den Status der einzelnen Tester verfolgen und sehen, ob sie die Einladung und ob die App in der Firebase-Konsole heruntergeladen wurde.

Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung innerhalb von 5 Tagen abläuft, erscheint ein entsprechender Hinweis in der Firebase-Konsole neben dem Tester eines Release. Eine Einladung kann erneuert, indem Sie es über das Dropdown-Menü in der Testerzeile erneut senden.

Nächste Schritte