Catch up on everthing we announced at this year's Firebase Summit. Learn more

Verteilen von Android-Apps an Tester mithilfe der Firebase-CLI

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

Bevor Sie beginnen

Wenn Sie nicht bereits haben, fügen Sie Firebase zu dem Android - Projekt .

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 zusätzliche Produkte zu verwenden, führen Sie alle Schritte auf der oben verlinkten Seite aus.

Schritt 1. Erstellen Sie Ihre App

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. Verteilen Sie Ihre App an Tester

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

  1. Installation oder Aktualisierung auf die neueste Version des Firebase CLI (wir empfehlen die Standalone - Binärdatei für die CLI spezifisch für Ihr Betriebssystem Download). Achten Sie darauf , melden Sie sich an und testen Sie, dass Sie Ihre Projekte zugreifen können.
  2. In der App Verteilung Seite der Firebase - Konsole, wählen Sie die App , die Sie verteilen möchten, dann klicken Sie es ein .
  3. Führen Sie das appdistribution:distribute Befehl App hochladen und verteilen sie an Tester. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:

    appdistribution:Optionen verteilen
    --app

    Erforderlich: Ihre App Firebase App - ID. Sie können die App - ID in der Firebase - Konsole im finden Seite Allgemeine Einstellungen .

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

    Ein Aktualisierungs - Token , dass gedruckt wird , wenn Sie Ihre CI - Umgebung mit dem Firebase CLI (lesen Sie authentifizieren Verwenden der CLI mit CI - Systeme für weitere Informationen).

    --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 durch Kommas getrennte Liste von E-Mail-Adressen angeben:

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

    Oder Sie können 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 Tester Gruppen , 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 durch Kommas getrennte Liste angeben:

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

    Oder Sie können 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 einschließen 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 Veröffentlichungen, können Sie auch appdistribution:testers:add und appdistribution:testers:remove neue Tester einladen oder bestehende Tester von Ihrem Projekt Firebase 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 Tester, die kürzlich entfernt wurden, weiterhin Zugriff auf Ihre Releases für ein bestimmtes Zeitfenster 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 auch Tester mit angeben --file /path/to/testers.txt .

Sobald Sie Ihren Build verteilt haben, steht er 150 Tage (fünf Monate) im App-Verteilungs-Dashboard der Firebase-Konsole zur Verfügung. Wenn der Build 30 Tage vor dem Ablaufen liegt, wird sowohl in der Konsole als auch in der Build-Liste Ihres Testers auf seinem Testgerät eine Ablaufbenachrichtigung angezeigt.

Tester , die nicht eingeladen haben , um die Anwendung zu testen , erhalten E - Mail - Einladungen , um loszulegen, und bestehende Tester erhalten E - Mail - Benachrichtigungen , dass eine neue Build - Test (lesen Sie die bereit ist , Tester Set up Anleitung für Anweisungen, wie die Test - App installieren). Sie können den Status jedes Testers in der Firebase-Konsole überwachen – ob er die Einladung angenommen hat und ob er die App heruntergeladen hat.

Tester haben 30 Tage Zeit, um eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung 5 Tage vor Ablauf abläuft, wird in der Firebase-Konsole neben dem Tester bei einer Version eine Ablaufbenachrichtigung angezeigt. Eine Einladung kann erneuert werden, indem sie über das Dropdown-Menü in der Testerzeile erneut gesendet wird.