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

In dieser Anleitung wird beschrieben, wie Sie APKs mithilfe der Firebase-Befehlszeilenschnittstelle an Tester verteilen. Mit dem CLI-Tool können Sie Tester und Versionshinweise für einen Build angeben und den Build dann entsprechend verteilen.

Bevor Sie beginnen

Fügen Sie Ihrem Android-Projekt Firebase hinzu, falls Sie dies noch nicht getan haben .

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie sich jedoch entscheiden, in Zukunft weitere Produkte zu verwenden, führen Sie unbedingt alle Schritte auf der oben verlinkten Seite durch.

Schritt 1. Erstellen Sie Ihre App

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

Schritt 2. Verteilen Sie Ihre App an Tester

Um Ihre App an Tester zu verteilen, laden Sie die Datei Ihrer App über die Firebase-Befehlszeilenschnittstelle hoch:

  1. Installieren oder aktualisieren Sie auf die neueste Version der Firebase CLI (wir empfehlen, die eigenständige Binärdatei für die für Ihr Betriebssystem spezifische CLI herunterzuladen). Stellen Sie sicher, dass Sie sich anmelden und testen, 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 aus, um Ihre App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:

    appdistribution:Verteilungsoptionen
    --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 kommagetrennte Liste von E-Mail-Adressen angeben:

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

    Oder Sie können den Pfad zu einer einfachen Textdatei 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 kommagetrennte Liste angeben:

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

    Oder Sie können den Pfad zu einer einfachen Textdatei 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 Protokollausgabe zu drucken.

    Zum Beispiel:

    firebase appdistribution:distribute test.apk  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    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 einzelnen Releases hinzufügen. Sobald Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Beachten Sie, dass kürzlich entfernte Tester noch für ein gewisses Zeitfenster 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 .

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

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen, um loszulegen, und bestehende Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist (Lesen Sie die Einrichtungsanleitung für Tester, um Anweisungen zum Installieren der Test-App zu erhalten). 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, um 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 für eine Version ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Tester-Zeile erneut senden.