Zusätzliche iOS-Geräte registrieren

Wenn Sie Ad-hoc-iOS-Builds über App Distribution verteilen möchten, müssen Sie die Geräte Ihrer Tester gemäß dieser Anleitung 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, App Distribution wird er um die Erlaubnis gebeten, die Geräte-ID des Testers an Sie, den Entwickler, weiterzugeben. 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 verteilen Sie einen neuen Build an Ihre Tester. Sie können UDIDs manuell über die Firebase-Konsole oder die Firebase CLI exportieren oder UDIDs programmatisch mit fastlane exportieren.

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 App 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 Add Devices (Geräte hinzufügen) im Apple-Entwicklerportal 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 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, wird App Distribution keine neue Version erstellt 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 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) 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 {: .external} 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 keine Neuveröffentlichung 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 folgende Rolle enthält 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 Ihr eigenes Konto aktivieren oder deaktivieren

Für Ihr eigenes Konto können Sie App Distribution-Benachrichtigungen aktivieren oder deaktivieren, ohne dass sich dies auf andere Projektmitglieder auswirkt. Sie benötigen weiterhin die erforderlichen Berechtigungen, um Benachrichtigungen zu erhalten.

So aktivieren oder deaktivieren Sie App Distribution-Benachrichtigungen:

  1. Rufen Sie in der Firebase Console rechts oben Firebase-Benachrichtigungen auf.
  2. Rufen Sie dann die Einstellungen auf 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.

Wenn Sie das Onboarding neuer iOS-Tester vollständig automatisieren möchten, 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-CLI.

  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 zu App Distribution-Benachrichtigungen.

Nächste Schritte