Zusätzliche iOS-Geräte registrieren

Wenn Sie Ad-hoc-iOS-Builds über App Distribution 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 Unternehmensprofil signiert ist. Auf einem Gerät kann nur ein Ad-hoc-Build installiert werden, wenn die eindeutige Geräte-ID (UDID) des Geräts im Bereitstellungsprofil des Builds enthalten ist.

Wenn ein Tester eine Einladung zum Testen Ihrer App annimmt, fordert App Distribution die Berechtigung an, die Geräte-ID des Testers mit Ihnen, dem Entwickler, zu teilen. Bevor ein Ad-hoc-Build heruntergeladen werden kann, fordert App Distribution den Tester auf, sein Gerät zu registrieren. Wenn der Tester sein Gerät registriert, erfasst App Distribution die UDID des Geräts und benachrichtigt Sie per E-Mail darüber.

Wenn Sie eine E‑Mail mit einer UDID erhalten, aktualisieren Sie Ihr Bereitstellungsprofil mit der UDID und stellen Sie Ihren Testern einen neuen Build zur Verfügung. Sie können UDIDs manuell über die Firebase-Konsole oder die Firebase CLI exportieren oder programmatisch über fastlane.

UDIDs manuell exportieren

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

      Wählen Sie auf dem Tab Tester und Gruppen des App Distribution-Dashboards die Option Alle Tester aus und klicken Sie dann auf Apple-UDIDs exportieren, um eine CSV-Datei herunterzuladen. Importieren Sie die Datei dann mit der Option Register Multiple Devices in Ihr Apple-Entwicklerkonto. Weitere Informationen finden Sie unter Apps auf registrierten Geräten bereitstellen.

      Hinweis: Mit Ihrem Apple-Entwicklerkonto können Sie möglicherweise nur eine begrenzte Anzahl von Geräten pro Jahr importieren.

    • Option 2 : UDIDs per E‑Mail erfassen und eingeben

      Registrieren Sie auf der Seite Geräte hinzufügen des Apple Developer-Portals 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 verwenden Sie es, um Ihre App neu zu erstellen. Wenn Sie die App nur neu erstellen, um die registrierten Geräte zu aktualisieren, aktualisieren Sie die Build-Nummer oder die Version nicht.
  4. Verteilen Sie Ihre App noch einmal über die Firebase-Konsole oder die Befehlszeile. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keinen neuen Release und Tester werden nicht benachrichtigt. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer neu registrierter Geräte Benachrichtigungs-E‑Mails.

UDIDs programmatisch mit fastlane exportieren

  1. Exportieren Sie alle UDIDs Ihrer Testgeräte als CSV-Datei aus fastlane. Erstellen und führen Sie beispielsweise eine neue download_udids-Lane 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) in Ihr Apple-Entwicklerkonto über die Option Register Multiple Devices (Mehrere Geräte registrieren). Weitere Informationen Hinweis: Mit Ihrem Apple-Entwicklerkonto können Sie möglicherweise nur eine begrenzte Anzahl von Geräten pro Jahr importieren.

  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 die App nur neu erstellen, um die registrierten Geräte zu aktualisieren, aktualisieren Sie die Build-Nummer oder Version nicht.

  5. App neu verteilen: Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution kein neues Release und Tester werden nicht benachrichtigt. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer neu registrierter Geräte Benachrichtigungs-E-Mails.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

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

Damit Sie App Distribution-Benachrichtigungen über diesen Standardmechanismus erhalten, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Projektinhaber oder -bearbeiter.

Standardmäßig erhält jedes Projektmitglied (mit den erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen) eine E-Mail, wenn ein neues iOS-Gerät registriert wird.

Benachrichtigungen für das eigene Konto aktivieren/deaktivieren

Sie können App Distribution-Benachrichtigungen für Ihr eigenes Konto aktivieren oder deaktivieren, ohne andere Projektmitglieder zu beeinträchtigen. Sie benötigen weiterhin die erforderlichen Berechtigungen, um Benachrichtigungen zu erhalten.

So aktivieren oder deaktivieren Sie App Distribution-Benachrichtigungen:

  1. Rufen Sie in der FirebaseConsole rechts oben Firebase-Benachrichtigungen auf.
  2. Gehen Sie dann zu den Einstellungen und legen Sie Ihre Kontoeinstellung für App Distribution-Benachrichtigungen fest.

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

Sie können App Distribution-Benachrichtigungen auch über Cloud Functions for Firebase an den bevorzugten Benachrichtigungskanal Ihres Teams senden. Sie können beispielsweise eine Funktion schreiben, die ein Benachrichtigungsereignis für die Registrierung eines neuen iOS-Geräts erfasst und die Benachrichtigungsinformationen 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.

So richten Sie erweiterte Benachrichtigungsfunktionen mit Cloud Functions for Firebase ein:

  1. Cloud Functions for Firebase einrichten. Dazu gehören die folgenden Aufgaben:

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

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

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

Nächste Schritte