遷移到在主模組中使用 Swift 擴充 API

我們正在將 Swift 擴充 SDK 合併到主 SDK 中,以使 Swift 原生 API 得到更廣泛的使用,並提高我們未來支援新 Swift 語言功能的能力。我們正在做出的更改及其對您的專案的預期影響記錄如下。

有什麼變化?

從 Firebase for Apple SDK 10.17.0 開始,Swift 擴充 SDK 已合併到對應的主 SDK 中。例如, FirebaseFirestoreSwift模組中的所有 API 都已新增至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 的Package.swift中刪除 Swift 擴充功能。舊版本將繼續運行,但不會收到更新。

如何從主模組遷移到使用 Swift 原生 API

如果您目前不使用 Swift 擴充 SDK,則無需執行任何操作。如果您確實使用 Swift 擴充 SDK,請在專案中進行以下變更。

工作空間變化

斯威夫特套件管理器

將 Firebase 更新至版本 10.17.0+ 後,導覽至目標設定的「常規」標籤中的「框架、庫和嵌入內容」部分,然後刪除 Swift 擴充 SDK(例如FirebaseFirestoreSwift )。

可可豆莢

將 Firebase 更新至版本 10.17.0+ 後,導覽至您的 Podfile 並刪除與專案對新增目標框架部分的依賴項相對應的行,並刪除 Swift 擴充 SDK(例如 pod FirebaseFirestoreSwift )。然後,重新執行pod install指令。

郵遞區號分佈和迦太基

將 Firebase 更新到版本 10.17.0+ 後,刪除專案中的任何 Swift 擴充xcframeworks (例如FirebaseFirestoreSwift.xcframework )。

原始碼更改

對於您之前使用的所有 Swift 擴充 SDK,請執行以下操作:

  1. 刪除引用 Swift 擴充 SDK 的任何導入語句。如果未單獨匯入主 SDK,則需要刪除行末端的Swift ,將 Swift 擴充功能匯入替換為主 SDK 匯入。
  2. 如果您使用 Swift 的明確模組命名空間來引用任何 Swift 擴充 SDK 類型,則需要將其替換為相應的主 SDK。例如, FirebaseFirestoreSwift.QueryPredicate需要重新命名為FirebaseFirestore.QueryPredicate