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 Unternehmensprofil signiert ist. Ein Gerät kann nur ein Ad-hoc-Build installieren, 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 an Sie als Entwickler weiterzugeben. 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 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 Console oder die Firebase CLI exportieren oder programmatisch mit „fastlane“.

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 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 Mehrere Geräte registrieren in Ihr Apple Developer-Konto. Weitere Informationen finden Sie unter App auf registrierten Geräten verteilen.

      Beachten Sie, dass Sie in Ihrem Apple Developer-Konto möglicherweise nur eine begrenzte Anzahl von Geräten pro Jahr importieren können.

    • Option 2: Erfassen und geben Sie die UDIDs 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.

  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 Console oder die CLI. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, App Distribution erstellt kein neues 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 Benachrichtigungs E‑Mails.

UDIDs programmatisch mit „fastlane“ exportieren

  1. Exportieren Sie alle UDIDs Ihrer Testergeräte als CSV-Datei aus „fastlane“. Erstellen und führen Sie beispielsweise einen neuen 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) mit der Option Mehrere Geräte registrieren in Ihr Apple Developer-Konto. Weitere Informationen finden Sie in der Dokumentation von Apple. Beachten Sie, dass Sie in Ihrem Apple Developer-Konto 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.

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

  5. Verteilen Sie Ihre App noch einmal. Wenn Sie die Version, die Build-Nummer oder den Code Ihrer App nicht ändern, App Distribution erstellt kein neues 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 Benachrichtigungs-E‑Mails.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

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

Wenn Sie App Distribution Benachrichtigungen über diesen Standardmechanismus erhalten möchten, benötigen Sie die firebase.projects.update Berechtigung. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase Administrator, 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/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 jedoch 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 die Firebase alerts 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 auch App Distribution Benachrichtigungen ü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 dem Bereitstellungsprofil Ihrer App hinzufügt, die App neu erstellt und sie mit dem aktualisierten Bereitstellungsprofil noch einmal verteilt.

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

  1. Richten Sie Cloud Functions für 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 CLI 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 aus App Distribution erfasst und die Ereignis nutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord postet).

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

Nächste Schritte