我們正在將 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,請執行以下操作:
- 刪除引用 Swift 擴充 SDK 的任何導入語句。如果未單獨匯入主 SDK,則需要刪除行末端的
Swift
,將 Swift 擴充功能匯入替換為主 SDK 匯入。 - 如果您使用 Swift 的明確模組命名空間來引用任何 Swift 擴充 SDK 類型,則需要將其替換為相應的主 SDK。例如,
FirebaseFirestoreSwift.QueryPredicate
需要重新命名為FirebaseFirestore.QueryPredicate
。