Мы объединяем наши 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 будут по-прежнему работать. Однако мы рекомендуем перевести ваше приложение на использование API Swift из основного модуля, чтобы гарантировать получение исправлений и возможность воспользоваться изменениями и новыми функциями.
Важные даты для этих изменений
В октябре 2023 года
Расширения Swift SDK были объединены с основными SDK, а затем объявлены устаревшими в пользу основных SDK. См. примечания к выпуску версии 10.17.0, в которых сообщается об этом изменении.
Теперь вы можете использовать API расширения SDK Swift непосредственно из основных модулей SDK. Использование расширений SDK по-прежнему возможно до следующего крупного релиза, но при использовании будет выдаваться предупреждение об устаревании.
Уже в феврале 2024 года.
Мы прекратим выпуск новых версий расширений Swift и удалим расширения Swift из Package.swift в Firebase. Более старые версии продолжат функционировать, но не будут получать обновления.
Как перейти на использование API, разработанных специально для Swift, из основного модуля.
Если вы в настоящее время не используете SDK расширений Swift, никаких действий не требуется. Если вы используете SDK расширений Swift, внесите следующие изменения в свой проект.
Изменения в рабочем пространстве
Swift Package Manager
После обновления Firebase до версии 10.17.0 и выше перейдите в раздел «Фреймворки, библиотеки и встроенный контент» на вкладке «Общие» в настройках целевого приложения и удалите SDK расширения Swift (например, FirebaseFirestoreSwift ).
CocoaPods
После обновления Firebase до версии 10.17.0+ перейдите в свой Podfile и удалите строку, соответствующую зависимости вашего проекта, добавив раздел frameworks для вашей цели, а также удалите расширение 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.