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

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

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

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

Начиная с версии 10.17.0 Firebase для Apple SDK, Swift extension SDK были объединены с соответствующими основными SDK. Например, все API из модуля FirebaseFirestoreSwift были добавлены в FirebaseFirestore, поэтому вам больше не нужно импортировать модуль FirebaseFirestoreSwift, чтобы получить доступ к этим API.

Поскольку все расширения Swift теперь являются частью основных модулей, SDK расширений больше не нужны и их поддержка прекращена. Если вы включите или используете расширения Swift SDK, компилятор выдаст предупреждение. В феврале 2024 года мы перестанем выпускать расширения Swift.

★ Примечание. Все текущие и предыдущие версии расширений Swift будут по-прежнему работать. Однако мы рекомендуем перенести приложение на Swift API из основного модуля, чтобы получать исправления и пользоваться новыми функциями.

Важные даты

В октябре 2023 г.

SDK для расширений Swift были объединены с основными SDK и затем объявлены устаревшими. Подробнее об этом изменении рассказывается в примечаниях к выпуску версии 10.17.0.

Теперь вы можете использовать API Swift Extension SDK непосредственно из основных модулей SDK. Использовать SDK расширений можно будет до выхода следующей основной версии, но при этом будет показываться предупреждение об устаревании.

Не ранее февраля 2024 г.

Мы прекратим выпускать новые версии расширений Swift и удалим их из Package.swift Firebase. Старые версии продолжат работать, но не будут получать обновления.

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

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

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

Swift Package Manager

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

CocoaPods

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

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

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

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

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

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