Android-Apps mit der Firebase CLI an Tester verteilen


In diesem Leitfaden wird beschrieben, wie Sie APKs mit der Firebase-Befehlszeile an Tester verteilen. Mit dem CLI-Tool können Sie Tester und Versionshinweise für einen Build und verteilt den Build entsprechend.

Hinweis

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

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur Projekt erstellen und Ihre App registrieren. Sollten Sie sich jedoch für die Verwendung zusätzlicher zu erhalten, sollten Sie alle Schritte auf der Seite wie oben verlinkt.

Schritt 1: App erstellen

Wenn Sie eine Vorabveröffentlichung Ihrer App für Tester veröffentlichen möchten, Erstellen Sie Ihr APK wie gewohnt. Du musst die APK-Datei mit deinem Debug-Code signieren App-Signaturschlüssel oder App-Signaturschlüssel.

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 testen Sie, ob Sie auf Ihr Projekten. verwenden.
  2. Auf der App Distribution-Seite der Firebase-Konsole wählen Sie die App aus, die Sie bereitstellen möchten, und klicken Sie dann auf Jetzt starten.

  3. 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:

    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.

    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"

    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 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, das bei automatisierten Tests verwendet werden soll.
    --test-non-blocking

    Führen Sie automatisierte Tests asynchron aus. Die Ergebnisse des automatischen Tests finden Sie in der Firebase Console.

    Beispiel:

    firebase appdistribution:distribute test.apk  \
    --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