Registrieren Sie zusätzliche iOS-Geräte

Wenn Sie Ad-hoc-iOS-Builds mithilfe der App-Verteilung verteilen möchten, müssen Sie dieser Anleitung folgen, 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, bittet App Distribution um Erlaubnis, 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 mit der Firebase-Konsole oder der Firebase-CLI exportieren oder UDIDs programmgesteuert mit Fastlane exportieren.

UDIDs manuell exportieren

  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-Verteilungs-Dashboards „Alle Tester“ aus und klicken Sie dann auf „Apple-UDIDs exportieren“ , um eine CSV-Datei herunterzuladen. Als nächstes importieren Sie 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: Erfassen und geben Sie die UDIDs 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 die registrierten Geräte neu erstellen, aktualisieren Sie nicht die Build-Nummer oder Version.
  4. Verteilen Sie Ihre App über die Firebase-Konsole oder CLI neu. Wenn Sie Ihre Version, Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keine neue Version und benachrichtigt die 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 Testergeräte als CSV-Datei aus fastlane. Erstellen Sie beispielsweise eine neue download_udids -Spur 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) mit der Option „Mehrere Geräte registrieren“ in Ihr Apple-Entwicklerkonto . Weitere Informationen finden Sie in der Dokumentation von Apple . 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 erstellen Sie damit Ihre App neu. Wenn Sie die Neuerstellung nur zum Zweck der Aktualisierung der registrierten Geräte durchführen, 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 die 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 Standardwarnungen

Standardmäßig kann Firebase App Distribution-Benachrichtigungen für neue iOS-Geräteregistrierungen per E-Mail senden.

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

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

Aktivieren/deaktivieren Sie Benachrichtigungen für Ihr eigenes Konto

Für Ihr eigenes Konto können Sie App-Verteilungswarnungen aktivieren/deaktivieren, ohne dass dies Auswirkungen auf andere Projektmitglieder hat. Beachten Sie, dass Sie weiterhin die erforderlichen Berechtigungen benötigen, um Benachrichtigungen zu erhalten.

Gehen Sie folgendermaßen vor, um App-Verteilungswarnungen zu aktivieren oder zu deaktivieren:

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

Richten Sie erweiterte Benachrichtigungen für Drittanbieterdienste ein

Mit Cloud Functions für Firebase können Sie App Distribution-Benachrichtigungen 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 senden.

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 mithilfe von Cloud Functions für Firebase einzurichten:

  1. Richten Sie Cloud Functions für Firebase ein , was die folgenden Aufgaben umfasst:

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

  2. Schreiben und implementieren Sie eine Funktion , die ein Warnereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Warninformationen in einer Nachricht auf Discord veröffentlicht).

Weitere Informationen zu allen Warnereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für App Distribution-Warnungen .

Nächste Schritte