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 Befehlszeilentool können Sie Tester und Release-Notes für einen Build angeben und den Build dann entsprechend verteilen.

Hinweis

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

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie jedoch in Zukunft zusätzliche Produkte verwenden möchten, müssen Sie alle Schritte auf der oben verlinkten Seite ausführen.

Schritt 1: App erstellen

Wenn Sie bereit sind, eine Vorabversion Ihrer App an Tester zu verteilen, erstellen Sie Ihr APK wie gewohnt. Sie müssen das APK mit Ihrem Debug-Schlüssel oder App-Signaturschlüssel signieren.

Schritt 2: App an Tester verteilen

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

  1. Installieren Sie die Firebase CLI 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.
  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 App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:

    appdistribution:distribute options
    --app

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

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

    Ein Aktualisierungstoken, das ausgegeben wird, wenn Sie Ihre CI-Umgebung mit der Firebase CLI authentifizieren. Weitere Informationen finden Sie unter CLI 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 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"

    Sie können auch 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 Gruppenaliassen 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"

    Alternativ können Sie 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 einfügen können, um eine ausführliche Logausgabe zu drucken.
    --test-devices
    --test-devices-file

    Die folgenden Verteilungstypen sind Teil der Betafunktion „Automatischer 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 bei automatischen Tests.
    --test-password
    --test-password-file

    Das Passwort für die automatische Anmeldung bei automatisierten Tests.

    Sie können auch 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 bei automatisierten Tests.
    --test-password-resource

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

    Automatisierte Tests asynchron ausführen. 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. Über diese Links können Sie 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 Testeroberfläche (native Android-App), über den Tester Release-Notes 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 App-Binärdatei (APK- oder AAB-Datei) direkt heruntergeladen und installiert wird. Der Link läuft nach einer Stunde ab.

    Tester und Gruppen verwalten

    Mit appdistribution:testers:add und appdistribution:testers:remove können Sie nicht nur Releases verteilen, sondern auch neue Tester einladen oder vorhandene Tester aus Ihrem Firebase-Projekt entfernen.

    Nachdem ein Tester Ihrem Firebase-Projekt hinzugefügt wurde, können Sie ihn einzelnen Releases hinzufügen. Wenn Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Tester, die vor Kurzem entfernt wurden, können noch für eine gewisse Zeit auf Ihre Releases zugreifen.

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

Sobald Sie Ihren Build veröffentlicht haben, ist er 150 Tage (fünf Monate) lang im App Distribution-Dashboard der Firebase-Konsole verfügbar. 30 Tage vor Ablauf des Builds wird sowohl in der Konsole als auch in der Liste der Builds auf dem Testgerät des Testers eine entsprechende Benachrichtigung angezeigt.

Tester, die nicht zum Testen der App eingeladen wurden, erhalten eine E-Mail-Einladung zum Einstieg. Bestehende Tester werden per E-Mail benachrichtigt, dass ein neuer Build zum Testen bereit ist. Eine Anleitung zum Installieren der Test-App finden Sie im Leitfaden zur Einrichtung von Testern. In der Firebase-Konsole können Sie den Status der einzelnen Tester prüfen, 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-Konsole neben dem Tester in einer Version eine entsprechende Benachrichtigung angezeigt. Eine Einladung kann verlängert werden, indem Sie sie über das Drop-down-Menü in der Zeile des Testers noch einmal senden.

Nächste Schritte