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, fordert App Distribution die Berechtigung an, die Geräte-ID 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 ü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 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: Erfassen Sie die UDIDs und geben Sie sie per E-Mail ein.

      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 über die Firebase Console oder die Befehlszeile neu. 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 Tester-UDIDs als CSV-Datei von Fastlane. Erstellen und betreiben Sie beispielsweise eine neue download_udids-Spur:

    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 Apple-Dokumentation. 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öffentliche deine App neu. Wenn du die Version, die Build-Nummer oder den Code deiner App nicht änderst, 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 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/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. 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 die UDID eines neuen iOS-Geräts dem 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. Richten Sie Cloud Functions for Firebase ein. Dieser umfasst 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 darin 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