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