Swift ネイティブ API をより幅広く利用できるようにし、将来的に新しい Swift 言語機能をサポートする能力を高めるため、Swift 拡張機能 SDK をメイン SDK に統合します。変更の内容と、想定されるお客様のプロジェクトへの影響は以下のとおりです。
変更点
Firebase for Apple SDK 10.17.0 以降、Swift 拡張機能 SDK は対応するメイン SDK に統合されていますたとえば、FirebaseFirestoreSwift モジュールのすべての API が FirebaseFirestore に追加されたため、これらの API にアクセスするために FirebaseFirestoreSwift モジュールのインポートは不要になりました。
すべての Swift 拡張機能がメイン モジュールに組み込まれているため、拡張機能 SDK は不必要になり、非推奨になりました。Swift 拡張機能 SDK を含めたり使用したりすると、コンパイラ警告が表示され、早ければ 2024 年 2 月には Swift 拡張機能のリリースは完全に停止されます。
★ 注: 現在または以前にリリースされたバージョンの Swift 拡張機能は引き続き機能します。ただし、引き続き修正を受け取り、変更と新機能を活用できるようにするために、メイン モジュールから Swift API を使用するようにアプリを移行することをおすすめします。
この変更の重要な日程
2023 年 10 月
Swift 拡張機能 SDK はメイン SDK に統合されて非推奨となり、メイン SDK に置き換えられます。この変更については、バージョン 10.17.0 のリリースノートをご覧ください。
Swift 拡張機能 SDK API はメイン SDK モジュールから直接使用できるようになりました。次のメジャー バージョンがリリースまで、拡張機能 SDK は引き続き使用できますが、使用時に非推奨警告が表示されます。
2024 年 2 月移行
Google は、Swift 拡張機能の新バージョンのリリースを停止し、Swift 拡張機能を Firebase の Package.swift から削除します。以前のバージョンも引き続きご利用いただけますが、更新を受け取ることはありません。
メイン モジュールから Swift ネイティブ API を使用するように移行する方法
現在 Swift 拡張機能 SDK を使用していない場合、対応は必要ありません。Swift 拡張機能 SDK を使用している場合は、プロジェクトで次の変更を行います。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-09-05 UTC。"],[],[],null,["\u003cbr /\u003e\n\nWe're merging our Swift extension SDKs into the main SDKs in order to make\nSwift-native APIs more broadly available and increase our ability to support\nnew Swift language features in the future. The changes we're making and their\nexpected impacts on your projects are documented below.\n\nWhat's changing?\n\nStarting with Firebase for Apple SDK 10.17.0, the Swift extension SDKs have\nbeen merged into their corresponding main SDKs. For example, all of the APIs\nfrom the `FirebaseFirestoreSwift` module have been added to `FirebaseFirestore`,\nso you no longer have to import the `FirebaseFirestoreSwift` module to access\nthose APIs.\n\nAs all Swift extensions now are part of the main modules, the extension SDKs\nare no longer required, and are deprecated. Including or using the Swift\nextension SDKs will raise a compiler warning and as early as February 2024,\nwe'll stop releasing the Swift extensions entirely.\n\n★ Note: Any currently or previously released versions of the Swift extensions\nwill still function. However, we recommend that you migrate your app to use\nSwift APIs from the main module to ensure you continue to receive fixes and can\ntake advantage of changes and new features.\n\nImportant dates for this change\n\nIn October 2023\n\nThe Swift extension SDKs have been merged into the main SDKs and then\ndeprecated in favor of the main SDKs. See the release notes for version 10.17.0\nannouncing this change.\n\nYou can now use the Swift extension SDK APIs directly from the main SDK modules.\nUsage of the extension SDKs will is still possible until the next major version\nrelease but will raise a deprecation warning when used.\n\nAs early as February 2024\n\nWe'll stop releasing new versions of the Swift extensions, and we'll remove the\nSwift extensions from Firebase's `Package.swift`. Older versions will continue\nto function but will not receive updates.\n\nHow to migrate to use Swift-native APIs from the main module\n\nIf you currently do not use the Swift extension SDKs, no action is necessary. If\nyou do use a Swift extension SDK, make the following changes in your project.\n\nWorkspace changes\n\nSwift Package Manager\n\nAfter updating Firebase to version 10.17.0+, navigate to the Frameworks,\nLibraries, and Embedded Content section in the General tab of your target's\nsettings and remove the Swift extension SDK (such as `FirebaseFirestoreSwift`).\n\nCocoaPods\n\nAfter updating Firebase to version 10.17.0+, navigate to your Podfile and remove\nthe line corresponding to your project's dependency on adding the frameworks\nsection for your target and remove the Swift extension SDK\n(such as pod `FirebaseFirestoreSwift`). Then, re-run the `pod install` command.\n\nZip distribution and Carthage\n\nAfter updating Firebase to version 10.17.0+, remove any Swift extension\n`xcframeworks` within your project (such as\n`FirebaseFirestoreSwift.xcframework`).\n\nSource code changes\n\nFor all of the Swift extension SDKs you previously used, take the following\nactions:\n\n1. Delete any import statements referencing the Swift extension SDK. If the main SDK was not imported separately, you will need to replace the Swift extension import with the main SDK import by deleting the `Swift` at the end of the line.\n2. If you used Swift's explicit-module namespacing to reference any Swift extension SDK types, you will need to replace those with the corresponding main SDK. For example, `FirebaseFirestoreSwift.QueryPredicate` would need to be renamed to `FirebaseFirestore.QueryPredicate`."]]
