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

Как перейти на использование API расширений Swift в основных модулях

Мы объединяем SDK расширений Swift с основными SDK, чтобы сделать API Swift-native более доступными и расширить возможности поддержки новых функций языка Swift в будущем. Ниже описаны изменения, которые мы вносим, и их ожидаемое влияние на ваши проекты.

Что изменится

Начиная с Firebase для 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 и удалим их из файла Package.swift Firebase. Более старые версии продолжат работать, но не будут получать обновления.

Как перейти на использование API Swift-native из основного модуля

Если вы не используете SDK расширений Swift, никаких действий не требуется. Если вы используете SDK расширения Swift, внесите в проект следующие изменения:

Изменения в рабочей области

Swift Package Manager

Обновив Firebase до версии 10.17.0 или более поздней, перейдите в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) на вкладке General (Общие) в настройках целевого объекта и удалите SDK расширения Swift (например, FirebaseFirestoreSwift).

CocoaPods

Обновив Firebase до версии 10.17.0 или более поздней, перейдите к Podfile и удалите строку, соответствующую зависимости проекта от добавления раздела фреймворков для целевого объекта, а также удалите SDK расширения Swift (например, pod FirebaseFirestoreSwift). Затем повторно выполните команду pod install.

Распространение ZIP-архивов и Carthage

После обновления Firebase до версии 10.17.0 или более поздней удалите из проекта все расширения Swift xcframeworks, например FirebaseFirestoreSwift.xcframework.

Изменения в исходном коде

Для всех ранее использовавшихся SDK расширений Swift выполните следующие действия:

Удалите все операторы импорта, ссылающиеся на SDK расширения Swift. Если основной SDK не был импортирован отдельно, вам нужно будет заменить импорт расширения Swift импортом основного SDK, удалив Swift в конце строки.
Если вы использовали явное пространство имен модулей Swift для ссылки на любые типы SDK расширения Swift, вам нужно будет заменить их соответствующим основным SDK. Например, FirebaseFirestoreSwift.QueryPredicate нужно переименовать в FirebaseFirestore.QueryPredicate.