Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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

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 dies noch nicht getan haben, fügen Sie Firebase zu Ihrem iOS-Projekt hinzu .

Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie sich jedoch für die Verwendung zusätzlicher Produkte in der Zukunft entscheiden, müssen Sie alle Schritte auf der oben verlinkten Seite ausführen.

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 Erstellungsprozess 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 Unternehmensverteilungsprofil verwenden.
  • Wenn Ihre App Game Center, APNs (und damit auch Cloud Messaging ) oder iCloud verwendet, stellen Sie sicher, dass Ihr Bereitstellungsprofil eine explizite App-ID und keine Platzhalter-ID verwendet.
  • 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 Registrieren zusätzlicher Testergeräte .
  • Wenn Sie seit dem letzten Build Codeänderungen vorgenommen haben (dh, Sie werden nicht nur neu erstellt, um die registrierten Geräte zu aktualisieren), aktualisieren Sie die vom Benutzer sichtbare Versionsnummer ( Version ) und die eindeutige Build-Nummer ( Build ) des Build-Ziels.

Nach Abschluss des Builds 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

Laden Sie die IPA-Datei mithilfe der Firebase-CLI hoch, um Ihre App an Tester zu verteilen:

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

    Verteilung: Optionen verteilen
    --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:ios: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 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 angegeben Gruppen-Aliase , 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"

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

Sobald Sie Ihren Build verteilt haben, wird er 150 Tage (fünf Monate) lang im App Distribution-Dashboard der Firebase-Konsole verfügbar sein. Wenn der Build 30 Tage nach Ablauf abläuft, wird sowohl in der Konsole als auch in der Liste der Builds Ihres Testers auf dem Testgerät eine Ablaufbenachrichtigung angezeigt.

Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen, um loszulegen, und vorhandene Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist (Anweisungen zum Installieren der Test-App finden Sie in der Anleitung zum Einrichten des Testers ). Sie können den Status jedes Testers in der Firebase-Konsole überwachen, ob er die Einladung angenommen und die App heruntergeladen hat.

Schritt 3 . Registrieren Sie zusätzliche Geräte

Wenn Tester eine Einladung zum Testen eines Builds annehmen, der nicht mit einem Enterprise-Profil signiert ist, werden sie um Erlaubnis gebeten, die Kennung ihres Geräts mit Ihnen zu teilen. Wenn sie zustimmen, sammelt 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.

      Wählen Sie auf der Registerkarte Tester und Gruppen des App Distribution-Dashboards Alle Tester aus und klicken Sie auf (Tester verwalten)> Apple-UDIDs exportieren , um eine CSV-Datei herunterzuladen. Importieren Sie anschließend die Datei mit der Option Mehrere Geräte registrieren in Ihr Apple-Entwicklerkonto . Weitere Informationen finden Sie in der Apple-Dokumentation .

      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 Sie die UDIDs und geben Sie sie per E-Mail ein.

      Registrieren Sie auf der Seite Geräte hinzufügen des Apple-Entwicklerportals die neue UDID, die in der E-Mail angegeben ist, die Sie erhalten haben.

  2. Fügen Sie die registrierten Geräte Ihrem Bereitstellungsprofil hinzu .
  3. Laden Sie das Bereitstellungsprofil herunter und erstellen Sie damit Ihre App neu. Wenn Sie nur neu erstellen, um die registrierten Geräte zu aktualisieren, aktualisieren Sie nicht die Build-Nummer oder -Version.
  4. Verteilen Sie Ihre App erneut über die Firebase-Konsole oder die CLI. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Benutzer neu registrierter Geräte Benachrichtigungs-E-Mails.