Руководство по обновлению Facebook SDK для iOS

Существующие проекты следует перевести на самую новую версию Facebook SDK. Соответствующие инструкции вы найдете в этой статье.

Знакомство с изменениями в последней версии

Прежде чем переходить на новую версию Facebook SDK, ознакомьтесь с журналом изменений на GitHub. Так вы поймете, какие именно изменения необходимо внести в программный код при обновлении.

Примечание. Если выполняется обновление до версии 9.0.0 или более поздней, вариант autoInitEnabled был удален из SDK. Вам необходимо явным образом инициализировать SDK с использованием метода initializeSDK или инициализировать неявно, вызвав его в applicationDidFinishLaunching. Дополнительную информацию см. в пункте 9.0.0 журнала изменений.

Обновление с использованием Swift Package Manager (SPM)

Если Facebook SDK для iOS интегрирован в ваше приложение с помощью Swift Package Manager, следуйте этим инструкциям.

Обратите внимание, что в кратком руководстве по предыдущей ссылке предлагается выбрать для параметра Version (Версия) вариант Up to Next Major Version (До следующей главной версии). Это означает, что обновление будет выполнено строго до указанной главной версии (т. е., например, до 8.x.x., даже если доступна версия 9.x.x). Это позволяет избежать обновления до версии, несовместимой с текущим пакетом.

Дополнительное обновление

Для случаев, когда обновление версии является дополнительным (увеличивается дополнительный номер версии или номер исправления)

В Xcode нажмите File > Swift Packages > Update to Latest Package Versions (Файл > Пакеты Swift > Обновить до последних версий пакетов).

Пример:

Обновление главной версии

Прежде чем выполнять обновление до главной версии, обязательно ознакомьтесь с журналом изменений. Если в обновлении изменен главный номер версии, может потребоваться корректировка настроек пакета.

Перейдите в настройки проекта и откройте вкладку Пакеты Swift. Пример:

Выберите пакет Facebook, чтобы посмотреть его настройки. Задайте в параметре Version (Версия) номер главной версии, до которой вы хотите выполнить обновление (в данном примере это 9.0.0), и нажмите Done (Готово).

Затем выполните обновление пакета. В Xcode нажмите File > Swift Packages > Update to Latest Package Versions (Файл > Пакеты Swift > Обновить до последних версий пакетов). Пример:

обновления до последних версий пакетов

Обновление с использованием CocoaPods

Если Facebook SDK для iOS интегрирован в ваше приложение с использованием CocoaPods, следуйте этим инструкциям.

Проверьте, не устарели ли модули. Следующая команда возвращает список устаревших модулей.
```
pod outdated
```
Обновите устаревшие модули. Для этого выполните следующую команду.
```
pod update  [PODNAME]
```

Обратите внимание: CocoaPods попытается найти обновленную версию модуля, указанную в параметре [PODNAME], и обновит этот модуль до последней возможной версии с учетом ограничений, заданных в файле Podfile. Если у вас есть какие-либо ограничения на версии, при переходе с одной главной версии на другую могут потребоваться изменения соответствующих параметров.

Повторная компиляция и устранение проблем

После обновления нужных пакетов SDK выполните повторную компиляцию и устраните возникшие проблемы. Как правило, проблемы возникают только при переходе на новую главную версию.

Чтобы узнать, какие проблемы могут возникнуть, и правильно выполнить компиляцию, ознакомьтесь с журналом изменений на GitHub.

Обновление до новой версии API Graph

Если вы хотите перейти на новую версию API Graph, воспользуйтесь инструментом обновления, чтобы понять, какие изменения нужно внести в приложение. Вы также можете ознакомиться с журналом изменений API Graph.