Catch up on highlights from Firebase at Google I/O 2023. Learn more

Registrieren Sie zusätzliche iOS-Geräte

Wenn Sie Ad-hoc-iOS-Builds mithilfe von App Distribution verteilen möchten, müssen Sie diese Anleitung befolgen, um die Geräte Ihrer Tester zu registrieren. Ein Ad-hoc-Build ist ein Build, der nicht mit einem Enterprise-Profil signiert ist. Ein Gerät kann einen Ad-hoc-Build nur installieren, wenn die eindeutige Gerätekennung (UDID) des Geräts im Bereitstellungsprofil des Builds enthalten ist.

Wenn ein Tester eine Einladung zum Testen Ihrer App annimmt, fordert App Distribution die Erlaubnis an, die Gerätekennung des Testers mit Ihnen, dem Entwickler, zu teilen. Vor dem Herunterladen eines Ad-hoc-Builds fordert App Distribution den Tester auf, sein Gerät zu registrieren. Wenn der Tester sein Gerät registriert, erfasst App Distribution die UDID vom Gerät und benachrichtigt Sie per E-Mail über die UDID.

Wenn Sie eine E-Mail mit einer UDID erhalten, aktualisieren Sie Ihr Bereitstellungsprofil mit der UDID und verteilen Sie einen neuen Build an Ihre Tester. Sie können UDIDs manuell über die Firebase-Konsole oder die Firebase-CLI exportieren, oder Sie können UDIDs programmgesteuert mit Fastlane exportieren.

UDIDs manuell exportieren

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

      Wählen Sie auf der Registerkarte „Tester & Gruppen“ des App-Verteilungs-Dashboards „Alle Tester“ aus und klicken Sie dann auf „Apple-UDIDs exportieren“ , um eine CSV-Datei herunterzuladen. Importieren Sie als Nächstes die Datei mit der Option „Mehrere Geräte registrieren“ in Ihr Apple-Entwicklerkonto . Weitere Informationen finden Sie unter Verteilen Ihrer App an registrierte Geräte .

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

    • Option 2: UDIDs per E-Mail sammeln und eingeben.

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

  2. Fügen Sie die registrierten Geräte Ihrem Bereitstellungsprofil hinzu .
  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. Verteilen Sie Ihre App erneut über die Firebase-Konsole oder die CLI . Wenn Sie Ihre Version, Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keine neue Version und benachrichtigt Tester nicht. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Benutzer neu registrierter Geräte Benachrichtigungs-E-Mails.

Exportieren Sie UDIDs programmgesteuert mit Fastlane

  1. Exportieren Sie alle UDIDs Ihrer Testgeräte als CSV-Datei aus Fastlane. Erstellen Sie beispielsweise eine neue download_udids Lane und führen Sie sie aus:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Importieren Sie die UDID(s) mithilfe 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.

  3. Fügen Sie die registrierten Geräte Ihrem Bereitstellungsprofil hinzu .

  4. Laden Sie das Bereitstellungsprofil herunter und verwenden Sie es, um Ihre App neu zu erstellen. Wenn Sie nur zum Zwecke der Aktualisierung der registrierten Geräte neu erstellen, aktualisieren Sie nicht die Build-Nummer oder Version.

  5. Verteilen Sie Ihre App erneut . Wenn Sie Ihre Version, Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keine neue Version und benachrichtigt Tester nicht. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Benutzer neu registrierter Geräte Benachrichtigungs-E-Mails.

Meldungen erhalten

Erhalten Sie Standardbenachrichtigungen

Standardmäßig kann Firebase App Distribution-Warnungen für neue Registrierungen von iOS-Geräten per E-Mail senden.

Um App Distribution-Warnungen über diesen Standardmechanismus zu erhalten, müssen Sie über die Berechtigung firebase.projects.update verfügen. Die folgenden Rollen beinhalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Projektinhaber oder Bearbeiter .

Standardmäßig erhält jedes Projektmitglied (das über die erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen verfügt) eine E-Mail, wenn ein neues iOS-Gerät registriert wird.

Benachrichtigungen für Ihr eigenes Konto ein-/ausschalten

Für Ihr eigenes Konto können Sie App-Verteilungsbenachrichtigungen aktivieren/deaktivieren, ohne andere Projektmitglieder zu beeinträchtigen. Beachten Sie, dass Sie immer noch die erforderlichen Berechtigungen benötigen, um Benachrichtigungen zu erhalten.

Führen Sie die folgenden Schritte aus, um App-Verteilungswarnungen ein- oder auszuschalten:

  1. Gehen Sie in der Firebase-Konsole oben rechts zu Firebase-Warnungen .
  2. Gehen Sie dann zu Einstellungen und legen Sie Ihre Kontoeinstellungen für App-Verteilungsbenachrichtigungen fest.

Richten Sie erweiterte Benachrichtigungen für Dienste von Drittanbietern ein

Mit Cloud Functions for Firebase können Sie App-Verteilungswarnungen auch an den bevorzugten Benachrichtigungskanal Ihres Teams senden. Sie können beispielsweise eine Funktion schreiben, die ein Warnereignis für die Registrierung eines neuen iOS-Geräts erfasst und die Warninformationen an einen Drittanbieterdienst wie Discord, Slack oder Jira sendet.

Um das Onboarding neuer iOS-Tester vollständig zu automatisieren, können Sie eine Funktion schreiben, die die UDID eines neuen iOS-Geräts zum Bereitstellungsprofil Ihrer App hinzufügt, die App neu erstellt und die App mit dem aktualisierten Bereitstellungsprofil neu verteilt.

Führen Sie die folgenden Schritte aus, um erweiterte Benachrichtigungsfunktionen mit Cloud Functions for Firebase einzurichten:

  1. Richten Sie Cloud Functions for Firebase ein , was die folgenden Aufgaben umfasst:

    1. Richten Sie eine Entwicklungsumgebung für Node.js oder Python ein.
    2. Installieren Sie die Firebase-Befehlszeilenschnittstelle und melden Sie sich an.
    3. Initialisieren Sie Cloud Functions for Firebase mit der Firebase-CLI.

  2. Schreiben und stellen Sie eine Funktion bereit , die ein Warnungsereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Warnungsinformationen in einer Nachricht auf Discord postet).

Informationen zu allen Alarmereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für App-Verteilungsalarme .

Nächste Schritte