Zusätzliche iOS-Geräte registrieren

Wenn du Ad-hoc-iOS-Builds mit App Distribution verteilen möchtest, musst du dieser Anleitung, um die Geräte. Ein Ad-hoc erstellen 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 (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-Entwicklerportal 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 für registrierte Geräte vertreiben

      Möglicherweise können Sie mit Ihrem Apple-Entwicklerkonto nur eine begrenzte Anzahl von Geräten pro Jahr importieren.

    • 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 zu Ihrem Bereitstellungsprofil
  3. Laden Sie das Bereitstellungsprofil herunter und erstellen Sie damit Ihre Anwendung neu. Wenn Sie werden nur neu erstellt, um die registrierten Geräte zu aktualisieren. Aktualisieren Sie den Build nicht. Nummer oder Version.
  4. App über die Firebase-Konsole neu vertreiben oder Befehlszeile. Wenn Sie Ihre Version, Build-Nummer oder App-Code nicht ändern, App Distribution erstellt keinen neuen Release und benachrichtigt 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.

UDIDs programmatisch mit fastlane exportieren

  1. Exportieren Sie alle Tester-UDIDs als CSV-Datei von Fastlane. Für 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 UDID(s) in Ihr Apple-Entwicklerkonto. mit der Option Mehrere Geräte registrieren. Weitere Informationen finden Sie in der Apple-Dokumentation. Über Ihr Apple-Entwicklerkonto können Sie möglicherweise nur ein eine begrenzte Anzahl von Geräten pro Jahr nutzen.

  3. Fügen Sie die registrierten Geräte Ihrem Bereitstellungsprofil hinzu.

  4. Laden Sie das Bereitstellungsprofil herunter und erstellen Sie damit Ihre Anwendung neu. Wenn Sie der Neuerstellung nur zum Zweck der Aktualisierung der registrierten Geräte erforderlich ist, die Build-Nummer oder -Version aktualisieren.

  5. Verteilen Sie Ihre App. Wenn Sie die Version, die Build-Nummer oder den App-Code, App Distribution erstellt keinen neuen Release und benachrichtigt 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 ein neues iOS-Gerät senden Registrierungen per E-Mail.

Um App Distribution-Benachrichtigungen über diesen Standardmechanismus zu erhalten, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten die erforderliche Standardberechtigung: Firebase Administrator oder Projektinhaber oder Bearbeiter:

Standardmäßig kann jedes Projektmitglied (mit den erforderlichen Berechtigungen Warnungen) erhalten 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. Gehen Sie in der Firebase-Konsole rechts oben zu Firebase Benachrichtigungen.
  2. Rufe dann auf Einstellungen und lege deine Kontoeinstellung für App Distribution fest. Warnungen.

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

Sie können auch App Distribution-Benachrichtigungen an die bevorzugte Benachrichtigung Ihres Teams senden. Kanal mit Cloud Functions for Firebase. Sie können z. B. eine Funktion schreiben, die ein Benachrichtigungsereignis für die Registrierung eines neuen iOS-Geräts erfasst und an einen Drittanbieterdienst wie Discord, Slack oder Jira senden.

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. Richten Sie Cloud Functions for Firebase ein. 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 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