改用在主要模組中使用 Swift 擴充功能 API

我們即將合併 Swift 擴充功能 SDK 至主要 SDK, Swift 原生 API 的服務範圍更多,且更能提供支援 新的 Swift 語言功能。即將進行的變更及其 預期的專案預期影響如下。

異動內容

自 Apple for Apple SDK 10.17.0 起,Swift 擴充功能 SDK 將 已合併至相應的主要 SDK例如所有 API 來自 FirebaseFirestoreSwift 模組已新增至 FirebaseFirestore 這樣就不必再匯入 FirebaseFirestoreSwift 模組 這些 API

所有 Swift 擴充功能現在都是主要模組的一部分,因此擴充功能 SDK 已不適用且已淘汰包括或使用 Swift 擴充功能 SDK 將發出編譯器警告。最快從 2024 年 2 月開始 我們將全面停止推出 Swift 擴充功能

★ 注意:Swift 擴充功能目前或先前發布的版本 仍可正常運作不過,建議您遷移應用程式,改為使用 來自主模組的 Swift API,確保您能繼續收到修正內容,並能 並運用各種改變和新功能

這項異動的重要日期

2023 年 10 月

Swift 擴充功能 SDK 已合併至主要 SDK 並改用主要 SDK請參閱 10.17.0 版的版本資訊 宣布這項變更

您現在可以直接從主要 SDK 模組使用 Swift 擴充功能 SDK API。 在下一個主要版本之前,你仍可使用擴充功能 SDK 發布新版本,但使用時將會提出淘汰警告

最早從 2024 年 2 月開始

我們將停止發布新版 Swift 擴充功能,並移除 Firebase 提供的 Swift 擴充功能。Package.swift較舊版本將繼續 但不會收到更新。

如何從主模組改用 Swift 原生 API

如果您目前並未使用 Swift 擴充功能 SDK,則無須採取任何行動。如果 如果您使用 Swift 擴充功能 SDK,請在專案中進行以下變更。

工作區變更

Swift 套件管理工具

將 Firebase 更新至 10.17.0 以上版本後,前往架構 目標資產的 [一般] 標籤中的 [程式庫] 與 [嵌入的內容] 部分 ,然後移除 Swift 擴充功能 SDK (例如 FirebaseFirestoreSwift)。

CocoaPods

將 Firebase 更新為 10.17.0 以上版本後,請前往 Podfile 並移除 您專案依附元件的對應行列:新增架構 部分,並移除 Swift 擴充功能 SDK (例如 Pod FirebaseFirestoreSwift)。接著,請重新執行 pod install 指令。

Zip 配送與 Carthage

將 Firebase 更新至 10.17.0 以上版本後,請移除所有 Swift 擴充功能 專案中的 xcframeworks (例如 FirebaseFirestoreSwift.xcframework)。

原始碼變更

針對您先前使用的所有 Swift 擴充功能 SDK,請執行下列操作: 動作:

  1. 刪除任何參照 Swift 擴充功能 SDK 的匯入陳述式。如果 主要 SDK 沒有單獨匯入,請更換 Swift 使用主要 SDK 匯入功能匯入擴充功能,方法是刪除位於Swift 特定的行尾
  2. 如果您使用 Swift 的明確模組命名空間參照任何 Swift 擴充功能 SDK 類型,您需要將這些項目替換成相應的 main 將機器學習工作流程自動化舉例來說,FirebaseFirestoreSwift.QueryPredicate 需要 已重新命名為 FirebaseFirestore.QueryPredicate