Facebook-SDK für iOS

Facebook-SDK für iOS – Upgrade-Leitfaden

Es ist wichtig, deine Projekte auf die neueste Version des Facebook-SDK zu aktualisieren. Dieses Thema zeigt dir die erforderlichen Schritte.

Ab Frühjahr 2024 verlangt Apple für die Aufnahme in den App Store, dass neue oder aktualisierte Apps, die häufig verwendete SDKs verwenden, Datenschutzmanifeste zu integrieren. Apps, die SDKs von Drittanbietern verwenden, die als häufig verwendete SDKs gelten und keine Datenschutzmanifeste enthalten, können nicht im App Store aktualisiert werden, was den App-Entwicklungszyklus und die geschäftlichen Anforderungen der Werbetreibenden negativ beeinflussen kann.

Um nahtloses Tracking von In-App-Käufen sicherzustellen, aktualisiere dein Facebook-SDK auf die neueste Version (v18.0.0 oder höher für iOS, v18.0.0 oder höher für Android). Dann kannst du die neuesten API-Änderungen nutzen und die In-App-Käufe deiner App genau tracken.

Änderungen in der aktuellen Version prüfen

Vor dem Upgrade auf eine neue Version des Facebook-SDK solltest du das Änderungsprotokoll auf GitHub durchlesen. So findest du heraus, welche Änderungen du wegen eines Upgrades in deinem Code vornehmen musst.

Hinweis: Ab Version 9.0.0 wurde die Option autoInitEnabled vom SDK entfernt. Du musst das SDK explizit mit der Methode initializeSDK oder implizit über den Aufruf in applicationDidFinishLaunching initialisieren. Weitere Informationen findest du im Abschnitt 9.0.0 des Änderungsprotokolls.

Upgrade mit Swift Package Manager (SPM)

Führe die folgenden Schritte aus, wenn deine App SPM für die Integration mit dem Facebook-SDK für iOS nutzt.

Beachte, dass du im Schnellstart des vorangegangenen Links aufgefordert wirst, Auf nächste Hauptversion für die Option Version auszuwählen. Damit wird das Tool nicht automatisch über die angegebene Hauptversion hinaus aktualisiert. (Wenn du 8.x.x auswählst, wird kein Update auf die Hauptversion 9.x.x vorgenommen.) So kannst du Updates auf eine Version, die mit dem momentan verwendeten Paket inkompatibel ist, verhindern.

Inkrementelles Update

Bei einem inkrementellen Versionsupdate (Nebenversion oder Patch-Version wird erhöht)

Klicke in Xcode auf Datei > Swift-Pakete > Update auf neueste Paketversionen.

Hier siehst du eine Beispielabbildung:

Update der Hauptversion

Lies unbedingt die Änderungsprotokolle, bevor du die Hauptversion aktualisierst. Wenn das Versionsupdate eine Änderung der Hauptversion ist, musst du möglicherweise die Paketeinstellungen ändern.

  1. Gehe zu den Projekteinstellungen und klicke auf den Tab Swift-Pakete. Hier siehst du eine Beispielabbildung:

  2. Wähle das Facebook-Paket aus, um dessen Einstellungen anzuzeigen. Gib als Version die gewünschte Hauptversion an (in diesem Beispiel 9.0.0) und klicke auf Fertig.

  3. Aktualisiere das Paket jetzt. Klicke in Xcode auf Datei > Swift-Pakete > Update auf neueste Paketversionen. Hier siehst du eine Beispielabbildung:

    4. Beachte, dass du die Zielversion wieder zurücksetzen kannst, indem du das Hauptversionsziel in den Projekteinstellungen änderst und Update auf neueste Paketversionen erneut ausführst.

Upgrade mit CocoaPods

Führe die folgenden Schritte aus, wenn deine App CocoaPods für die Integration in das Facebook-SDK für iOS nutzt.

  1. Prüfe, ob Pods veraltet sind. Mit dem folgenden Befehl listest du alle veralteten Pods auf.

    pod outdated

  2. Aktualisiere die veralteten Pods mit dem folgenden Befehl.

    pod update  [NAME DES PODS]

CocoaPods sucht nach einer aktualisierten Version des mit [PODNAME] angegebenen Pods und aktualisiert den Pod auf die neueste Version unter Berücksichtigung eventueller Versionseinschränkungen in deiner Pod-Datei. Wenn Versionseinschränkungen gelten, musst du diese möglicherweise ändern, um die Hauptversion zu aktualisieren.

Erneut kompilieren und Probleme beheben

Kompiliere die Ziel-SDKs nach dem Upgrade erneut, und behebe eventuelle Probleme, wenn du mit dem Upgrade der Ziel-SDKs fertig bist. In der Regel sollten Probleme nur bei einem Upgrade auf eine neue Hauptversion auftreten.

Lese daher unbedingt das Änderungsprotokoll auf GitHub und mach dich mit möglichen Kompilierungsproblemen vertraut.

Upgrade auf neue Graph API-Version durchführen

Wenn du die auf eine neue Version der Graph API aktualisieren möchtest, kannst du mit dem Upgrade-Tool feststellen, welche Änderungen du an deiner App vornehmen musst. Du kannst dir auch das Graph API-Änderungsprotokoll durchlesen.