Zusätzliche iOS-Geräte registrieren

Wenn Sie Ad-hoc-iOS-Builds mit 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 Enterprise-Profil signiert ist. Ein Gerät kann einen Ad-hoc-Build nur installieren, wenn die eindeutige Geräte-ID (UDID) des Geräts im Bereitstellungsprofil des Builds enthalten ist.

Wenn ein Tester eine Einladung zum Testen deiner App annimmt, fordert App Distribution die Erlaubnis an, die Gerätekennung des Testers an dich, den Entwickler, weiterzugeben. Bevor ein Ad-hoc-Build heruntergeladen werden kann, werden die Tester von App Distribution aufgefordert, ihr 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 oder programmatisch mit fastlane exportieren.

UDIDs manuell exportieren

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

      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 anschließend mit der Option Mehrere Geräte registrieren in Ihr Apple-Entwicklerkonto. Weitere Informationen finden Sie unter App auf registrierten Geräten bereitstellen.

      Beachte, dass du mit deinem Apple-Entwicklerkonto möglicherweise nur eine begrenzte Anzahl von Geräten pro Jahr importieren kannst.

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

      Registrieren Sie auf der Seite Add Devices (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 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 nicht die Build-Nummer oder Version.
  4. Verteilen Sie Ihre App über die Firebase-Konsole oder die Befehlszeile neu. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keinen neuen Release und benachrichtigt die Tester nicht. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer neu registrierter Geräte E‑Mail-Benachrichtigungen.

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. Verwenden Sie dazu die Option Register Multiple Devices (Mehrere Geräte registrieren). 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 {: .external}.

  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 nicht die Build-Nummer oder Version.

  5. App noch einmal bereitstellen: Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, erstellt App Distribution keinen neuen Release und benachrichtigt die Tester nicht. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer neu registrierter Geräte E‑Mail-Benachrichtigungen.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

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

Wenn Sie App Distribution-Benachrichtigungen über diesen Standardmechanismus erhalten möchten, 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, das die erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen hat, eine E-Mail, wenn ein neues iOS-Gerät registriert wird.

Benachrichtigungen für Ihr eigenes Konto aktivieren oder deaktivieren

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

So aktivieren oder deaktivieren Sie App Distribution-Warnungen:

  1. Rufen Sie in der Firebase-Konsole rechts oben Firebase-Benachrichtigungen auf.
  2. Gehen Sie dann zu 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 mit 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 sie mit dem aktualisierten Bereitstellungsprofil neu verteilt.

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

  1. Richten Sie Cloud Functions for Firebase ein. 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 zu App Distribution-Benachrichtigungen.

Nächste Schritte