Swift 네이티브 API를 더 광범위하게 제공하고 향후 새로운 Swift 언어 기능에 대한 지원을 강화하기 위해 Swift 확장 프로그램 SDK를 기본 SDK에 병합합니다. 적용되는 변경사항과 프로젝트에 미치는 예상 영향이 아래에 설명되어 있습니다.
변경되는 사항
Apple용 Firebase 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의 출시 노트를 참고하세요.
이제 기본 SDK 모듈에서 직접 Swift 확장 프로그램 SDK API를 사용할 수 있습니다.
확장 프로그램 SDK는 다음 주 버전 출시까지 계속 사용 가능하지만 사용 시 지원 중단 경고가 표시됩니다.
빠르면 2024년 2월 이후
Swift 확장 프로그램의 새 버전이 출시되지 않고 Firebase의 Package.swift에서 Swift 확장 프로그램이 삭제됩니다. 이전 버전은 계속 작동하지만 업데이트를 수신하지 않습니다.
기본 모듈에서 Swift 네이티브 API를 사용하도록 마이그레이션하는 방법
현재 Swift 확장 프로그램 SDK를 사용하지 않는 경우 별도의 조치를 취하지 않아도 됩니다. Swift 확장 프로그램 SDK를 사용하는 경우 프로젝트를 다음과 같이 변경합니다.
작업공간의 변경사항
Swift Package Manager
Firebase를 버전 10.17.0 이상으로 업데이트한 후 대상 설정의 일반 탭에서 프레임워크, 라이브러리, 삽입된 콘텐츠 섹션으로 이동하고 Swift 확장 프로그램 SDK(예: FirebaseFirestoreSwift)를 삭제합니다.
CocoaPods
Firebase를 버전 10.17.0 이상으로 업데이트한 후 Podfile로 이동하여 대상의 프레임워크 섹션 추가에 프로젝트의 종속 항목에 해당하는 줄을 삭제하고 Swift 확장 프로그램 SDK(예: 포드 FirebaseFirestoreSwift)를 삭제합니다. 그런 다음 pod install 명령어를 다시 실행합니다.
ZIP 배포 및 Carthage
Firebase를 버전 10.17.0 이상으로 업데이트한 후 프로젝트 내의 Swift 확장 프로그램 xcframeworks(예: FirebaseFirestoreSwift.xcframework)를 삭제합니다.
소스 코드 변경사항
이전에 사용한 모든 Swift 확장 프로그램 SDK의 경우 다음을 조치를 취합니다.
Swift 확장 프로그램 SDK를 참조하는 가져오기 문을 모두 삭제합니다. 기본 SDK를 별도로 가져오지 않은 경우 줄 끝에 있는 Swift를 삭제하여 Swift 확장 프로그램 import를 기본 SDK import로 바꿔야 합니다.
Swift의 명시적 모듈 네임스페이스 지정을 사용하여 Swift 확장 프로그램 SDK 유형을 참조한 경우 이를 해당 기본 SDK로 대체해야 합니다. 예를 들어 FirebaseFirestoreSwift.QueryPredicate을 FirebaseFirestore.QueryPredicate로 바꿔야 합니다.
[[["이해하기 쉬움","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`."]]
