View in English

Referenzmaterial

Bereitstellung mit Funktionen

Verwaltete Funktionen können nun direkt in Xcode 15 oder neuer aktiviert werden. Diese Funktionen können eine oder mehrere Berechtigungen erfordern und sind nun im Tab „Signing & Capabilities“ (Signaturen und Funktionen) in Xcode verfügbar. Nach der Aktivierung enthalten neue Bereitstellungsprofile für diese App-ID automatisch die zugehörigen Berechtigungen.

Beachten Sie Folgendes:

  1. Dieser neue Workflow unterstützt standardmäßig das automatische Signieren und Xcode Cloud-Workflows für Funktionen wie CarPlay und Multicast Networking.

  2. Für die Verwendung verwalteter Funktionen ist die Genehmigung von Apple erforderlich. Sobald die Genehmigung erteilt wurde, können Programmmitglieder mit Zugriff auf „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) Ihren Xcode-Zielen Funktionen hinzufügen.

  3. Gelegentlich können Berechtigungen nur für eine Teilmenge der Verteilungsoptionen wie die Entwicklung oder Ad-hoc zugewiesen werden. Sie können dies unter „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) im Abschnitt „Edit your App ID configuration“ (App-ID-Konfiguration bearbeiten) verifizieren.

  4. Viele Funktionen und Berechtigungen erfordern eine eindeutige App-ID und sind nicht für App Clips qualifiziert.

  5. Sie können zwar alle verwalteten Funktionen in Xcode aktivieren, werden aber aufgefordert, Ihre Datei mit den Berechtigungen manuell mit den richtigen Werten für einige verwaltete Funktionen zu aktualisieren.

Während Ihres nächsten Continuous Integration-Tests erkennt Xcode Cloud die neueste Konfiguration Ihrer App-ID und nimmt die aktivierten zusätzlichen Funktionen automatisch in das Bereitstellungsprofil auf. Dies ermöglicht das automatische Signieren für Funktionen wie CarPlay und Multicast Networking.

Bereitstellung in Xcode 15 oder neuer mit Funktionen

In Xcode 15 und neuer können Sie, sobald die Funktion Ihrer App-ID zugewiesen ist, Xcode so konfigurieren, dass das automatische Signieren unterstützt wird.

  1. Klicken Sie in Xcode 15 oder neuer auf den Tab „Signing & Capabilities“ (Signaturen und Funktionen).

  2. Aktivieren Sie das automatische Signieren in Xcode in Ihrem Xcode-Ziel.

  3. Klicken Sie auf den Tab „Capability“ (Funktion) und doppelklicken Sie dann auf die verwalteten Funktionen, die Sie für Ihre App-ID aktivieren möchten. Xcode fügt den aktivierten Berechtigungsschlüssel und das Wertpaar automatisch in die Datei mit den Berechtigungen Ihrer App ein. Xcode erstellt außerdem automatisch neue Bereitstellungsprofile mit den neuen Berechtigungen.

  4. Erstellen Sie die App auf Ihrem Gerät.

Bereitstellungsprofil mit verwalteten Funktionen erstellen – Manuelle Bereitstellung in Xcode

Verwaltete Funktionen funktionieren genauso wie die in „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) aktivierten öffentlichen Funktionen. Sobald Sie die Konfiguration Ihrer App-ID mit verwalteten Funktionen aktualisiert haben, enthalten berechtigte Bereitstellungsprofile automatisch die Berechtigungen. Es ist nicht erforderlich, dass Sie bei der Erstellung von Bereitstellungsprofilen eine Gruppe von Berechtigungen aus einem Menü auswählen. Beachten Sie jedoch, dass Sie möglicherweise noch immer die Option haben, während der Profilerstellung eine Gruppe von Berechtigungen auszuwählen, wenn Ihnen in der Vergangenheit verwaltete Funktionen zugewiesen wurden.

  1. Klicken Sie unter „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) auf „Profiles“ (Profile) in der Seitenleiste und klicken Sie dann oben links auf die Taste zum Hinzufügen (+).

  2. Wählen Sie den Typ für das Profil aus, das Sie erstellen möchten, und klicken Sie auf „Continue“ (Weiter).

  3. Wählen Sie einen Profiltyp und die App-ID des Projekts aus, für das die verwalteten Berechtigungen benötigt werden, und klicken Sie dann auf „Continue“ (Weiter)".

  4. Wählen Sie ein auf Ihrem Build-Computer vorhandenes Zertifikat aus und klicken Sie dann auf „Continue“ (Weiter)".

  5. Wählen Sie die Geräte aus, die Sie in dieses Profil aufnehmen möchten, und klicken Sie dann auf „Continue“ (Weiter).

  6. Bevor Sie dem Bereitstellungsprofil einen Namen geben, werden Sie möglicherweise aufgefordert, zusätzliche Berechtigungen auszuwählen. Diesen Schritt können Sie überspringen, wenn Sie die erforderlichen Features bei der Bearbeitung Ihrer App-ID bereits aktiviert haben.

  7. Bestätigen Sie, dass die richtige Vorlage ausgewählt ist, und klicken Sie auf „Continue“ (Weiter).

  8. Geben Sie Ihrem Bereitstellungsprofil einen Namen und klicken Sie dann auf „Generate“ (Generieren).

Überprüfen, ob verwaltete Funktionen in einem Bereitstellungsprofil enthalten sind – Manuelle Bereitstellung in Xcode

Sobald Sie die Konfiguration Ihrer App-ID aktualisiert und ein Bereitstellungsprofil erstellt haben, sind die neuen Funktionen automatisch enthalten.

  1. Klicken Sie unter „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) auf „Profiles“ (Profile) in der Seitenleiste.

  2. Wählen Sie das Bereitstellungsprofil aus, das mit der App verknüpft ist, für die die verwalteten Funktionen aktiviert sind.

  3. Falls das Bereitstellungsprofil ungültig ist, klicken Sie auf „Edit“ (Bearbeiten) und sichern Sie alle Änderungen, um die Konfiguration zu aktualisieren.

  4. Überprüfen Sie im Abschnitt „Enabled Capabilities“ (Aktivierte Funktionen), dass alle verwalteten Funktionen für die App-ID aktiviert wurden. Sie können das Bereitstellungsprofil auch in Xcode mit der Schnellansicht des Bereitstellungsprofils oder im Terminal mit command security cms -D -i <Pfad zum Bereitstellungsprofil> anzeigen.

Migrieren von zusätzlichen Berechtigungen für Funktionen

Zusätzliche Berechtigungen werden während der Erstellung von Bereitstellungsprofilen auf der Entwicklerwebsite angezeigt. Bei jedem Erstellen eines Profils müssen Sie die zusätzlichen Berechtigungen aus der zugewiesenen Liste auswählen. Möglicherweise müssen diese erneut als Funktionen zugewiesen werden, die für Ihre App-ID aktiviert werden können. Wenn das Feature für eine App-ID aktiviert ist, wird das Bereitstellen und Signieren von Apps mit in der Cloud verwalteten Zertifikaten, z. B. in Xcode Cloud, unterstützt. Prüfen Sie, ob zusätzliche Berechtigungen eine Migration erfordern, indem Sie zu „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) navigieren, eine App-ID auswählen und auf den Tab „Additional Capabilities“ (Zusätzliche Funktionen) klicken.

Fordern Sie die Migration zusätzlicher Berechtigungen an, wenn zuvor zugewiesene Berechtigungen nicht angezeigt werden.

Erforderliche Rolle: Accountinhaber:in