iOS-Apps mithilfe der Firebase CLI an Tester bereitstellen

Sie können Builds mit der Firebase CLI an Tester verteilen. Mit dem CLI-Tool können Sie Tester und Versionshinweise für einen Build angeben und den Build entsprechend verteilen.

Hinweis

  1. Falls noch nicht geschehen, fügen Sie Ihrem Apple Projekt Firebase hinzu.

    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, führen Sie alle Schritte auf der oben verlinkten Seite aus.

  2. Öffnen Sie die App Distribution Seite der Firebase Konsole. Wählen Sie bei Aufforderung Ihr Firebase-Projekt aus, wählen Sie Ihre App mit der App-Auswahl aus und klicken Sie auf Jetzt starten.

Schritt 1: App an Tester verteilen

So verteilen Sie Ihre App an Tester: Laden Sie die IPA-Datei mit der Firebase CLI hoch:

  1. Installieren Sie die neueste Version der Firebase CLI oder aktualisieren Sie sie darauf. Wir empfehlen, die eigenständige Binärdatei für die CLI herunterzuladen, die für Ihr Betriebssystem spezifisch ist. Melden Sie sich an und prüfen Sie, ob Sie auf Ihre Projekte zugreifen können. authentifizieren.

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

    Optionen für „appdistribution:distribute“
    --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:ios: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 direkt angeben:

    --release-notes "Text of release notes"

    Oder Sie geben 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 geben den Pfad zu einer Nur-Text-Datei an, 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 Gruppenaliasen angegeben, die Sie in der Firebase Console nachschlagen können.

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

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

    Oder Sie geben den Pfad zu einer Nur-Text-Datei an, 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 Testgeräte, auf denen Sie Tests des App Testing-Agents ausführen möchten.

    Sie können die Testgeräte als durch Semikolons getrennte Liste von Gerätespezifikationen angeben:

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

    Oder Sie geben den Pfad zu einer Nur-Text-Datei an, 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 Tests des App Testing-Agents verwendet werden soll.
    --test-password
    --test-password-file

    Das Passwort für die automatische Anmeldung, das bei Tests des App Testing-Agents verwendet werden soll.

    Oder Sie geben den Pfad zu einer Nur-Text-Datei an, die ein Passwort enthält:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Der Ressourcenname für das Feld „Nutzername“ für die automatische Anmeldung, der bei Tests des App Testing-Agents verwendet werden soll.
    --test-password-resource

    Der Ressourcenname für das Feld „Passwort“ für die automatische Anmeldung, der bei Tests des App Testing-Agents verwendet werden soll.
    --test-non-blocking

    Wenn diese Option beim Ausführen von Tests des App Testing-Agents festgelegt ist, werden die Tests mit dem Befehl gestartet und dann sofort zurückgegeben, ohne auf den Abschluss zu warten. Die Testergebnisse finden Sie in der Firebase Console. Wenn dieses Flag nicht festgelegt ist, wird der Befehl blockiert, bis die Tests abgeschlossen sind. Wenn einer der Tests fehlschlägt, wird er mit einem Fehlercode beendet.

    Beispiel:

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

    Die Firebase CLI gibt nach dem Hochladen des Releases die folgenden Links aus: Mit diesen Links können Sie Binärdateien verwalten und dafür sorgen, dass Tester und andere Entwickler den richtigen Release haben:

    • firebase_console_uri : Ein Link zur Firebase Console, auf 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 Testerumgebung (iOS-Webclip), über den Tester Versionshinweise ansehen 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 (IPA-Datei) direkt heruntergeladen und installiert wird. Der Link läuft nach einer Stunde ab.

    Tester und Gruppen verwalten

    Neben dem Verteilen von Releases können Sie mit appdistribution:testers:add und appdistribution:testers:remove auch neue Tester einladen oder vorhandene Tester aus Ihrem Firebase-Projekt entfernen.

    Sobald 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 jedoch noch eine Weile 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

    Die 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 appdistribution:testers:add und appdistribution:testers:remove Befehle 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 verteilen, ist er 150 Tage (fünf Monate) im App Distribution Dashboard der Firebase Console verfügbar. Wenn der Build in 30 Tagen abläuft, wird sowohl in der Console als auch in der Liste der Builds des Testers auf seinem Testgerät eine Ablaufbenachrichtigung angezeigt.

Tester, die noch nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen, um loszulegen. Bestehende Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist. Informationen zum Installieren der Test App finden Sie unter Als Tester einrichten. In der Firebase Console können Sie den Status jedes Testers prüfen: ob er die Einladung angenommen und die App heruntergeladen hat.

Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung in fünf Tagen abläuft, wird in der Firebase Konsole neben dem Tester in einem Release eine Ablaufbenachrichtigung angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Drop-down-Menü in der Testerzeile noch einmal senden.

Nächste Schritte