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

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

Sie können Builds mithilfe 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.

Bevor Sie beginnen

Wenn Sie nicht bereits haben, fügen Sie Firebase zu Ihrem Apple - 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 ein signiertes Verteilungsarchiv. Sie können Ihren normalen Build-Prozess verwenden, solange Sie die folgenden Anforderungen erfüllen:

  • Um Ihre App über Ihr Entwicklungsteam hinaus zu verteilen, müssen Sie entweder ein Ad-hoc- oder Ihr Enterprise-Vertriebsprofil verwenden.
  • Wenn Ihr App Game Center verwendet, APNs (und durch Erweiterung, Cloud Messaging ) oder iCloud, stellen Sie sicher , dass Ihr Provisioning - Profil verwendet eine explizite ID App und keine Wildcard - ID.
  • Wenn Sie ein Ad-hoc-Verteilungsprofil verwenden, geben Sie die eindeutigen Geräte-IDs (UDIDs) der Geräte Ihrer Tester an. Wenn sich neue iOS-Tester für Ihr Testprogramm anmelden, müssen Sie das Bereitstellungsprofil mit den UDIDs ihrer Geräte aktualisieren. Siehe Register zusätzliche Tester Geräte .
  • Wenn Sie Code Änderungen seit dem letzten Build gemacht haben (das heißt, neu erstellen Sie nicht nur die registrierten Geräte zu aktualisieren), aktualisieren Sie das Build - Ziel des Benutzer sichtbare Versionsnummer (Version) und einzigartige Build - Nummer (Build).

Wenn der Build abgeschlossen ist, werden eine IPA-Datei und einige Protokolldateien in dem von Ihnen angegebenen Ordner gespeichert. In den folgenden Schritten verteilen Sie die IPA-Datei an Ihre Tester.

Schritt 2. Verteilen Sie Ihre App an Tester

Um Ihre App an Tester zu verteilen, laden Sie die IPA-Datei ü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:ios: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.ipa  \
        --app 1:1234567890:ios: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.

Schritt 3. Weitere Geräte registrieren

Wenn Tester eine Einladung zum Testen eines nicht mit einem Enterprise-Profil signierten Builds annehmen, werden sie um Erlaubnis gebeten, die Kennung ihres Geräts mit Ihnen zu teilen. Wenn sie zustimmen, erfasst App Distribution die UDID vom Gerät und benachrichtigt Sie per E-Mail über die UDID.

Wenn Sie eine dieser E-Mails erhalten, aktualisieren Sie Ihr Bereitstellungsprofil mit der UDID und verteilen Sie einen neuen Build an Ihre Tester, indem Sie die folgenden Schritte ausführen:

  1. Fügen Sie die Geräte Ihrem Apple-Entwicklerportal hinzu.
    • Option 1: Importieren Sie die Geräte UDIDs als CSV - Datei.

      In dem Tester & Registerkarte Gruppen des Verteilungs - Dashboard - App, wählen Sie Alle Tester, klicken Sie dann auf Export von Apple UDIDs eine CSV - Datei zum Download bereit . Als nächstes importieren Sie die Datei in Ihrem Konto Apple - Entwickler das Register mehrere Geräte - Option. Wenden Sie sich an Apples Dokumentation mehr zu erfahren.

      Beachten Sie, dass Sie mit Ihrem Apple-Entwicklerkonto möglicherweise nur eine begrenzte Anzahl von Geräten pro Jahr importieren können.

    • Option 2: Sammeln und geben Sie die UDIDs per E - Mail.

      Auf der Add Devices Seite des Apple - Entwicklerportal, registrieren die neue UDID in der E - Mail angegeben Sie erhalten haben .

  2. Fügen Sie die registrierten Geräte zu Ihrem Provisioning - Profil .
  3. Laden Sie das Bereitstellungsprofil herunter und verwenden Sie es, um Ihre App neu zu erstellen. Wenn Sie nur neu erstellen, um die registrierten Geräte zu aktualisieren, aktualisieren Sie nicht die Build-Nummer oder -Version.
  4. Re verteilen Ihre App von der Firebase Konsole oder CLI. Wenn Sie bereits einen Build mit derselben Build-Nummer und -Version verteilt haben, erhalten nur Benutzer neu registrierter Geräte Benachrichtigungs-E-Mails.