Zusätzliche iOS-Geräte registrieren

Wenn Sie Ad-hoc-iOS-Builds mit 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 Enterprise-Profil signiert wurde. Auf einem Gerät kann nur ein Ad-hoc-Build installiert werden, wenn die eindeutige Geräte-ID (Unique Device Identifier, 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äte-ID des Testers mit Ihnen als Entwickler zu teilen. Bevor App Distribution einen Ad-hoc-Build herunterlädt, bittet er den Tester, sein Gerät zu registrieren. Wenn der Tester sein Gerät registriert, erhebt 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 Console oder die Firebase CLI oder programmatisch über fastlane exportieren.

UDIDs manuell exportieren

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

      Wählen Sie auf dem Tab Tester und Gruppen des Dashboards App Distribution 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 Mehrere Geräte registrieren in Ihr Apple-Entwicklerkonto. Weitere Informationen finden Sie unter App auf registrierten Geräten bereitstellen.

      Möglicherweise können Sie mit Ihrem Apple-Entwicklerkonto 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 -Version nicht.
  4. Verteilen Sie Ihre App noch einmal über die Firebase Console oder die Befehlszeile. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, wird von App Distribution kein neuer Release erstellt und Tester werden nicht benachrichtigt. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer von neu registrierten Geräten Benachrichtigungs-E-Mails.

UDIDs programmatisch mit fastlane exportieren

  1. Exportieren Sie alle UDIDs Ihrer Testergeräte aus fastlane als CSV-Datei. So erstellen und führen Sie beispielsweise eine neue download_udids-Leiter 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 UDIDs mit der Option Mehrere Geräte registrieren in Ihr Apple-Entwicklerkonto. Weitere Informationen finden Sie in der Dokumentation von Apple. Möglicherweise können Sie mit Ihrem Apple-Entwicklerkonto 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 zum Aktualisieren der registrierten Geräte neu erstellen, aktualisieren Sie die Build-Nummer oder -Version nicht.

  5. Veröffentlichen Sie Ihre App noch einmal. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, wird in App Distribution kein neuer Release erstellt und Tester werden nicht benachrichtigt. Wenn Sie bereits einen Build mit derselben Build-Nummer und Version verteilt haben, erhalten nur Nutzer von neu registrierten Geräten Benachrichtigungs-E-Mails.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

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, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Inhaber oder Bearbeiter des Projekts.

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/deaktivieren

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

So aktivieren oder deaktivieren Sie App Distribution-Benachrichtigungen:

  1. Klicken Sie in der Firebase Console oben rechts auf Firebase-Benachrichtigungen.
  2. Rufe dann Einstellungen auf und lege deine Kontoeinstellungen 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 in einem Drittanbieterdienst wie Discord, Slack oder Jira postet.

Wenn Sie das Onboarding neuer iOS-Tester vollständig automatisieren möchten, können Sie eine Funktion schreiben, die dem Bereitstellungsprofil Ihrer App die UDID eines neuen iOS-Geräts 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 für Firebase einrichten, einschließlich der 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. Erstellen und bereitstellen einer Funktion, die ein Benachrichtigungsereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht in Discord postet).

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

Nächste Schritte