Facebook-SDK für iOS – Upgrade-Leitfaden

Ä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 des 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 das Aufrufen von 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:
   

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  [PODNAME]
   

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 mache 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.