Мы объединяем наши пакеты SDK для расширения Swift с основными пакетами SDK, чтобы сделать API Swift более доступными и расширить возможности поддержки новых функций языка Swift в будущем. Вносимые нами изменения и их ожидаемое влияние на ваши проекты описаны ниже.
Что меняется?
Начиная с Firebase for Apple SDK 10.17.0, пакеты расширения Swift SDK объединены с соответствующими основными SDK. Например, все API из модуля FirebaseFirestoreSwift добавлены в FirebaseFirestore , поэтому вам больше не нужно импортировать модуль FirebaseFirestoreSwift для доступа к этим API.
Поскольку все расширения Swift теперь являются частью основных модулей, SDK расширений больше не требуются и считаются устаревшими. Включение или использование SDK расширений Swift вызовет предупреждение компилятора, и уже в феврале 2024 года мы полностью прекратим выпуск расширений Swift.
★ Примечание: все текущие или ранее выпущенные версии расширений Swift продолжат работать. Тем не менее, мы рекомендуем вам перенести приложение на использование API Swift из основного модуля, чтобы вы могли продолжать получать исправления и использовать изменения и новые функции.
Важные даты для этого изменения
В октябре 2023 года
Пакеты SDK для расширения Swift были объединены с основными SDK, а затем объявлены устаревшими в пользу основных SDK. См. примечания к выпуску версии 10.17.0, где анонсируется это изменение.
Теперь вы можете использовать API расширений SDK Swift непосредственно из основных модулей SDK. Использование расширений SDK будет возможно до выхода следующей основной версии, но при использовании будет выдаваться предупреждение об устаревании.
Уже в феврале 2024 года
Мы прекратим выпуск новых версий расширений Swift и удалим их из Package.swift Firebase. Старые версии продолжат работать, но не будут получать обновления.
Как перейти на использование собственных API Swift из основного модуля
Если вы в настоящее время не используете SDK расширений Swift, никаких действий не требуется. Если вы используете SDK расширений Swift, внесите следующие изменения в свой проект.
Изменения рабочего пространства
Менеджер пакетов Swift
После обновления Firebase до версии 10.17.0+ перейдите в раздел «Фреймворки, библиотеки и встроенное содержимое» на вкладке «Общие» настроек вашей целевой платформы и удалите SDK расширения Swift (например, FirebaseFirestoreSwift ).
CocoaPods
После обновления Firebase до версии 10.17.0+ перейдите в Podfile и удалите строку, соответствующую зависимости вашего проекта от добавления раздела фреймворков для вашей целевой платформы, а также удалите SDK расширения Swift (например, pod FirebaseFirestoreSwift ). Затем повторно выполните команду pod install .
Распределение почтовых индексов и Карфаген
После обновления Firebase до версии 10.17.0+ удалите все расширения Swift xcframeworks в вашем проекте (например, FirebaseFirestoreSwift.xcframework ).
Изменения исходного кода
Для всех ранее использованных вами пакетов SDK расширений Swift выполните следующие действия:
- Удалите все операторы импорта, ссылающиеся на SDK расширений Swift. Если основной SDK не был импортирован отдельно, вам потребуется заменить импорт расширения Swift импортом основного SDK, удалив
Swiftв конце строки. - Если вы использовали явное модульное пространство имён Swift для ссылки на какие-либо типы SDK расширений Swift, вам потребуется заменить их соответствующими типами основного SDK. Например,
FirebaseFirestoreSwift.QueryPredicateнеобходимо переименовать вFirebaseFirestore.QueryPredicate.