Перейдите на использование API-интерфейсов расширения Swift в основных модулях.

Мы объединяем наши 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, которые вы использовали ранее, выполните следующие действия:

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