최신 Swift용 Firebase SDK(v4.0.0)로 마이그레이션

Swift용 Firebase iOS SDK 버전 4.0.0에는 Swift API 설계 가이드라인의 이름 지정 규칙을 따르도록 변경사항을 포함했습니다. Firebase iOS SDK의 앱 버전을 업그레이드할 때 발생할 수 있는 오류나 경고를 수정하려면 마이그레이션 가이드의 단계를 따르세요.

새 버전의 변경사항

모든 Firebase 제품의 Swift SDK가 다음과 같이 변경되었습니다.

모든 상수, 프로토콜, 클래스, enum, 유형 정의의 이름에서 FIR 프리픽스 삭제
FIRApp에서 FirebaseApp으로 이름 변경
FIROptions에서 FirebaseOptions으로 이름 변경

변경사항의 전체 목록은 변경사항 세부 목록 섹션을 참조하세요.

오류 해결

이러한 변경사항으로 인한 오류를 해결하는 가장 좋은 방법은 Xcode의 문제 해결 대화상자를 사용하는 것입니다.

Xcode 작업공간에서 업데이트된 프로젝트를 열면 이름 변경으로 인해 발생한 오류가 이슈 탐색기에 표시됩니다.
오류를 클릭하고 문제 해결 대화상자의 제안으로 오류를 해결합니다.

이름 충돌 해결

이름 충돌을 해결하려면 모듈에서 제공하는 네임스페이스를 사용하세요. 예를 들어 FIRUser(현재 User)의 경우 User 클래스/구조체와 Firebase User 클래스를 구별하는 것이 좋습니다.

@import Firebase
...
var firebaseUser: Firebase.User?

변경사항 세부 목록

애널리틱스

이전	신규
함수
`FIRAnalytics`
`logEvent(withName:parameters:)`	`logEvent(_:parameters:)`
이전 사용량: FIRAnalytics.logEvent(withName: "com.myapp.appStart", parameters: nil) 새로운 사용량: Analytics.logEvent("com.myapp.appStart", parameters: nil)
`setUserPropertyString(_:forName:)`	`setUserProperty(_:forName:)`
이전 사용량: FIRAnalytics.setUserPropertyString("mechanic", forName: "job") 새로운 사용량: Analytics.setUserProperty("mechanic", forName: "job")
클래스
`FIRAnalytics`	`Analytics`
상수
`FIRAnalyticsEventAddPaymentInfo`	`AnalyticsEventAddPaymentInfo`
`FIRAnalyticsEventAddToCart`	`AnalyticsEventAddToCart`
`FIRAnalyticsEventAddToWishlist`	`AnalyticsEventAddToWishlist`
`FIRAnalyticsEventAppOpen`	`AnalyticsEventAppOpen`
`FIRAnalyticsEventBeginCheckout`	`AnalyticsEventBeginCheckout`
`FIRAnalyticsEventCampaignDetails`	`AnalyticsEventCampaignDetails`
`FIRAnalyticsEventCheckoutProgress`	`AnalyticsEventCheckoutProgress`
`FIRAnalyticsEventEarnVirtualCurrency`	`AnalyticsEventEarnVirtualCurrency`
`FIRAnalyticsEventEcommercePurchase`	`AnalyticsEventEcommercePurchase`
`FIRAnalyticsEventGenerateLead`	`AnalyticsEventGenerateLead`
`FIRAnalyticsEventJoinGroup`	`AnalyticsEventJoinGroup`
`FIRAnalyticsEventLevelUp`	`AnalyticsEventLevelUp`
`FIRAnalyticsEventLogin`	`AnalyticsEventLogin`
`FIRAnalyticsEventPostScore`	`AnalyticsEventPostScore`
`FIRAnalyticsEventPresentOffer`	`AnalyticsEventPresentOffer`
`FIRAnalyticsEventPurchaseRefund`	`AnalyticsEventPurchaseRefund`
`FIRAnalyticsEventRemoveFromCart`	`AnalyticsEventRemoveFromCart`
`FIRAnalyticsEventSearch`	`AnalyticsEventSearch`
`FIRAnalyticsEventSelectContent`	`AnalyticsEventSelectContent`
`FIRAnalyticsEventSetCheckoutOption`	`AnalyticsEventSetCheckoutOption`
`FIRAnalyticsEventShare`	`AnalyticsEventShare`
`FIRAnalyticsEventSignUp`	`AnalyticsEventSignUp`
`FIRAnalyticsEventSpendVirtualCurrency`	`AnalyticsEventSpendVirtualCurrency`
`FIRAnalyticsEventTutorialBegin`	`AnalyticsEventTutorialBegin`
`FIRAnalyticsEventTutorialComplete`	`AnalyticsEventTutorialComplete`
`FIRAnalyticsEventUnlockAchievement`	`AnalyticsEventUnlockAchievement`
`FIRAnalyticsEventViewItem`	`AnalyticsEventViewItem`
`FIRAnalyticsEventViewItemList`	`AnalyticsEventViewItemList`
`FIRAnalyticsEventViewSearchResults`	`AnalyticsEventViewSearchResults`
`FIRAnalyticsParameterAchievementID`	`AnalyticsParameterAchievementID`
`FIRAnalyticsParameterAdNetworkClickID`	`AnalyticsParameterAdNetworkClickID`
`FIRAnalyticsParameterAffiliation`	`AnalyticsParameterAffiliation`
`FIRAnalyticsParameterCampaign`	`AnalyticsParameterCampaign`
`FIRAnalyticsParameterCharacter`	`AnalyticsParameterCharacter`
`FIRAnalyticsParameterCheckoutStep`	`AnalyticsParameterCheckoutStep`
`FIRAnalyticsParameterCheckoutOption`	`AnalyticsParameterCheckoutOption`
`FIRAnalyticsParameterContent`	`AnalyticsParameterContent`
`FIRAnalyticsParameterContentType`	`AnalyticsParameterContentType`
`FIRAnalyticsParameterCoupon`	`AnalyticsParameterCoupon`
`FIRAnalyticsParameterCreativeName`	`AnalyticsParameterCreativeName`
`FIRAnalyticsParameterCreativeSlot`	`AnalyticsParameterCreativeSlot`
`FIRAnalyticsParameterCurrency`	`AnalyticsParameterCurrency`
`FIRAnalyticsParameterDestination`	`AnalyticsParameterDestination`
`FIRAnalyticsParameterEndDate`	`AnalyticsParameterEndDate`
`FIRAnalyticsParameterFlightNumber`	`AnalyticsParameterFlightNumber`
`FIRAnalyticsParameterGroupID`	`AnalyticsParameterGroupID`
`FIRAnalyticsParameterIndex`	`AnalyticsParameterIndex`
`FIRAnalyticsParameterItemBrand`	`AnalyticsParameterItemBrand`
`FIRAnalyticsParameterItemCategory`	`AnalyticsParameterItemCategory`
`FIRAnalyticsParameterItemID`	`AnalyticsParameterItemID`
`FIRAnalyticsParameterItemLocationID`	`AnalyticsParameterItemLocationID`
`FIRAnalyticsParameterItemName`	`AnalyticsParameterItemName`
`FIRAnalyticsParameterItemList`	`AnalyticsParameterItemList`
`FIRAnalyticsParameterItemVariant`	`AnalyticsParameterItemVariant`
`FIRAnalyticsParameterLevel`	`AnalyticsParameterLevel`
`FIRAnalyticsParameterLocation`	`AnalyticsParameterLocation`
`FIRAnalyticsParameterMedium`	`AnalyticsParameterMedium`
`FIRAnalyticsParameterNumberOfNights`	`AnalyticsParameterNumberOfNights`
`FIRAnalyticsParameterNumberOfPassengers`	`AnalyticsParameterNumberOfPassengers`
`FIRAnalyticsParameterNumberOfRooms`	`AnalyticsParameterNumberOfRooms`
`FIRAnalyticsParameterOrigin`	`AnalyticsParameterOrigin`
`FIRAnalyticsParameterPrice`	`AnalyticsParameterPrice`
`FIRAnalyticsParameterQuantity`	`AnalyticsParameterQuantity`
`FIRAnalyticsParameterScore`	`AnalyticsParameterScore`
`FIRAnalyticsParameterSearchTerm`	`AnalyticsParameterSearchTerm`
`FIRAnalyticsParameterShipping`	`AnalyticsParameterShipping`
`FIRAnalyticsParameterSignUpMethod`	`AnalyticsParameterSignUpMethod`
`FIRAnalyticsParameterSource`	`AnalyticsParameterSource`
`FIRAnalyticsParameterStartDate`	`AnalyticsParameterStartDate`
`FIRAnalyticsParameterTax`	`AnalyticsParameterTax`
`FIRAnalyticsParameterTerm`	`AnalyticsParameterTerm`
`FIRAnalyticsParameterTransactionID`	`AnalyticsParameterTransactionID`
`FIRAnalyticsParameterTravelClass`	`AnalyticsParameterTravelClass`
`FIRAnalyticsParameterValue`	`AnalyticsParameterValue`
`FIRAnalyticsParameterVirtualCurrencyName`	`AnalyticsParameterVirtualCurrencyName`
`FIRAnalyticsUserPropertySignUpMethod`	`AnalyticsUserPropertySignUpMethod`

인증

이전	신규
함수
`FIRAuth.h`
`init?(app:)`	`auth(app:)`
이전 사용량: let auth = FIRAuth(app: myApp) 새로운 사용량: let auth = Auth.auth(app: myApp)
`FIRUser.h`
`updateEmail(_:completion:)`	`updateEmail(to:completion:)`
이전 사용량: user.updateEmail("firebase_rox42@gmail.com") { error in // Check for error } 새로운 사용량: user.updateEmail(to: "firebase_rox42@gmail.com") { error in // Check for error }
`updatePassword(_:completion:)`	`updatePassword(to:completion:)`
이전 사용량: user.updatePassword("hunter2") { error in // Check for error } 새로운 사용량: user.updatePassword(to: "hunter2") { error in // Check for error }
`profileChangeRequest()`	`createProfileChangeRequest()`
이전 사용량: let request = user.profileChangeRequest() 새로운 사용량: let request = user.createProfileChangeRequest()
`getTokenWithCompletion(_:)`	`getToken(completion:)`
이전 사용량: user.getTokenWithCompletion() { token, error in // Handle token or error here } 새로운 사용량: user.getToken() { token, error in // Handle token or error here }
클래스
`FIRAdditionalUserInfo`	`AdditionalUserInfo`
`FIRActionCodeInfo`	`ActionCodeInfo`
`FIRAuth`	`Auth`
`FIRAuthCredential`	`AuthCredential`
`FIRAuthDataResult`	`AuthDataResult`
`FIRAuthErrors`	`AuthErrors`
`FIRSecureTokenService`	`SecureTokenService`
`FIRUser`	`User`
`FIRUserProfileChangeRequest`	`UserProfileChangeRequest`
`FIRUserInfo`	`UserInfo`
`FIREmailAuthProvider`	`EmailAuthProvider`
`FIRFacebookAuthProvider`	`FacebookAuthProvider`
`FIRGitHubAuthProvider`	`GitHubAuthProvider`
`FIRGoogleAuthProvider`	`GoogleAuthProvider`
`FIROAuthProvider`	`OAuthProvider`
`FIRTwitterAuthProvider`	`TwitterAuthProvider`
상수
`FIRAuthErrorDomain`	`AuthErrorDomain`
`FIRAuthErrorNameKey`	`AuthErrorNameKey`
`FIREmailAuthProviderID`	`EmailAuthProviderID`
`FIRFacebookAuthProviderID`	`FacebookAuthProviderID`
`FIRGitHubAuthProviderID`	`GitHubAuthProviderID`
`FIRGoogleAuthProviderID`	`GoogleAuthProviderID`
`FIRTwitterAuthProviderID`	`TwitterAuthProviderID`
`FIRAuthStateDidChange`	`AuthStateDidChange`
유형 선언
`FIRAuthStateDidChangeListenerHandle`	`AuthStateDidChangeListenerHandle`
`FIRAuthStateDidChangeListenerBlock`	`AuthStateDidChangeListenerBlock`
`FIRAuthDataResultCallback`	`AuthDataResultCallback`
`FIRAuthResultCallback`	`AuthResultCallback`
`FIRProviderQueryCallback`	`ProviderQueryCallback`
`FIRSendPasswordResetCallback`	`SendPasswordResetCallback`
`FIRConfirmPasswordResetCallback`	`ConfirmPasswordResetCallback`
`FIRVerifyPasswordResetCodeCallback`	`VerifyPasswordResetCodeCallback`
`FIRApplyActionCodeCallback`	`ApplyActionCodeCallback`
`FIRVerificationResultCallback`	`VerificationResultCallback`
열거형
`FIRActionDataKey`	`ActionDataKey`
`FIRActionCodeOperation`	`ActionCodeOperation`
`FIRAuthErrorCode`	`AuthErrorCode`

Core

이전	신규
함수
`FIRAnalyticsConfiguration.sharedInstance()`	`AnalyticsConfiguration.shared()`
`FIRApp.configure(withName:options:)`	`FirebaseApp.configure(name:options:)`
이전 사용량: FIRApp.configure(withName: "myCustomApp", options: customOptions) 새로운 사용량: FirebaseApp.configure(name: "myCustomApp", options: customOptions)
`FIRApp.defaultApp()`	`FirebaseApp.app()`
`FIRApp.init?(named:)`	`FirebaseApp.app(name:)`
이전 사용량: let app = FIRApp(named: "myCustomApp") 새로운 사용량: let app = FirebaseApp.app(name: "myCustomApp")
`FIRApp.allApps()`	`FirebaseApp.allApps`
이전 사용량: for app in FIRApp.allApps() { print("App name: \(app.name)") } 새로운 사용량: for app in FirebaseApp.allApps { print("App name: \(app.name)") }
`FIRConfiguration.sharedInstance()`	`FirebaseConfiguration.shared()`
`FIROptions.default()`	`FirebaseOptions.defaultOptions()`
속성
FIROptions
`GCMSenderID`	`gcmSenderID`
클래스
`FIRAnalyticsConfiguration`	`AnalyticsConfiguration`
`FIRApp`	`FirebaseApp`
`FIRConfiguration`	`FirebaseConfiguration`
`FIROptions`	`FirebaseOptions`
유형 선언
`FIRAppVoidBoolCallback`	`FirebaseAppVoidBoolCallback`
열거형
`FIRLoggerLevel`	`FirebaseLoggerLevel`

비정상 종료

이전	신규
함수
`FIRCrashMessage(_:)`	`FirebaseCrashMessage(_:)`

데이터베이스

이전	신규
속성
FIRDatabase.h
`persistenceEnabled`	`isPersistenceEnabled`
클래스
`FIRDataSnapshot`	`DataSnapshot`
`FIRDatabase`	`Database`
`FIRDatabaseQuery`	`DatabaseQuery`
`FIRDatabaseReference`	`DatabaseReference`
`FIRMutableData`	`MutableData`
`FIRServerValue`	`ServerValue`
`FIRTransactionResult`	`TransactionResult`
유형 선언
`FIRDatabaseHandle`	`DatabaseHandle`
열거형
`FIRDataEventType`	`DataEventType`

동적 링크

이전	신규
함수
`// FIRDynamicLinks.h`
`dynamicLink(fromUniversalLinkURL:)`	`dynamicLink(fromUniversalLink:)`
클래스
`FIRDynamicLink`	`DynamicLink`
`FIRDLRetrievalDelegate`	`DLRetrievalDelegate`
`FIRDynamicLinks`	`DynamicLinks`
`FIRDynamicLinkGoogleAnalyticsParameters`	`DynamicLinkGoogleAnalyticsParameters`
`FIRDynamicLinkIOSParameters`	`DynamicLinkIOSParameters`
`FIRDynamicLinkItunesConnectAnalyticsParameters`	`DynamicLinkItunesConnectAnalyticsParameters`
`FIRDynamicLinkAndroidParameters`	`DynamicLinkAndroidParameters`
`FIRDynamicLinkSocialMetaTagParameters`	`DynamicLinkSocialMetaTagParameters`
`FIRDynamicLinkNavigationInfoParameters`	`DynamicLinkNavigationInfoParameters`
`FIRDynamicLinkComponentsOptions`	`DynamicLinkComponentsOptions`
`FIRDynamicLinkComponents`	`DynamicLinkComponents`
유형 선언
`FIRDynamicLinkResolverHandler`	`DynamicLinkResolverHandler`
`FIRDynamicLinkUniversalLinkHandler`	`DynamicLinkUniversalLinkHandler`
`FIRDynamicLinkShortenerCompletion`	`DynamicLinkShortenerCompletion`
열거형
`FIRDynamicLinkMatchConfidence`	`DynamicLinkMatchConfidence`
`FIRDLRequiredMatchConfidence`	`DLRequiredMatchConfidence`
`FIRDLRetrieveResult`	`DLRetrieveResult`
`FIRShortDynamicLinkPathLength`	`ShortDynamicLinkPathLength`

인스턴스 ID

이전	신규
함수
`FIRInstanceID.h`
`getWithHandler()`	`getIDWithHandler()`
이전 사용량: FIRInstanceID.instanceID().get { identity, error in // Check identity and error } 새로운 사용량: instanceID.instanceID().getID { identity, error in // Check identity and error }
`deleteWithHandler()`	`deleteIDWithHandler()`
이전 사용량: FIRInstanceID.instanceID().delete { error in // Check error } 새로운 사용량: instanceID.instanceID().deleteID { error in // Check error }
클래스
`FIRInstanceID`	`InstanceID`
상수
`FIRInstanceIDScopeFirebaseMessaging`	`InstanceIDScopeFirebaseMessaging`
`FIRInstanceIDTokenRefresh`	`InstanceIDTokenRefresh`
유형 선언
`FIRInstanceIDTokenHandler`	`InstanceIDTokenHandler`
`FIRInstanceIDDeleteTokenHandler`	`InstanceIDDeleteTokenHandler`
`FIRInstanceIDHandler`	`InstanceIDHandler`
`FIRInstanceIDDeleteHandler`	`InstanceIDDeleteHandler`
열거형
`FIRInstanceIDError`	`InstanceIDError`
`FIRInstanceIDAPNSTokenType`	`InstanceIDAPNSTokenType`

초대

이전	신규
클래스
`FIRInvites`	`Invites`
`FIRInvitesTargetApplication`	`InvitesTargetApplication`
`FIRReceivedInvite`	`ReceivedInvite`
상수
`FIRInvitesErrorDomain`	`InvitesErrorDomain`
열거형
`FIRInvitesErrorCode`	`InvitesErrorCode`
`FIRReceivedInviteMatchType`	`ReceivedInviteMatchType`
프로토콜
`FIRInviteBuilder`	`InviteBuilder`
`FIRInviteDelegate`	`InviteDelegate`

메시지

이전	신규
함수
FIRMessaging
`connect(completion:)`	`connect(handler:)`
클래스
`FIRMessagingMessageInfo`	`MessagingMessageInfo`
`FIRMessagingRemoteMessage`	`MessagingRemoteMessage`
`FIRMessaging`	`Messaging`
상수
`FIRMessagingSendSuccess`	`MessagingSendSuccess`
`FIRMessagingSendError`	`MessagingSendError`
`FIRMessagingMessagesDeleted`	`MessagingMessagesDeleted`
`FIRMessagingConnectionStateChanged`	`MessagingConnectionStateChanged`
`FIRMessagingRegistrationTokenRefreshed`	`MessagingRegistrationTokenRefreshed`
유형 선언
`FIRMessagingFCMTokenFetchCompletion`	`MessagingFCMTokenFetchCompletion`
`FIRMessagingDeleteFCMTokenCompletion`	`MessagingDeleteFCMTokenCompletion`
열거형
`FIRMessagingError`	`MessagingError`
`FIRMessagingMessageStatus`	`MessagingMessageStatus`
`FIRMessagingAPNSTokenType`	`MessagingAPNSTokenType`
프로토콜
`FIRMessagingDelegate`	`MessagingDelegate`

원격 구성

이전	신규
함수
FIRRemoteConfig
`setDefaultsFromPlistFileName(_:)`	`setDefaults(fromPlist:)`
`setDefaultsFromPlistFileName(_:namespace)`	`setDefaults(fromPlist:namespace)`
클래스
`FIRRemoteConfigValue`	`RemoteConfigValue`
`FIRRemoteConfigSettings`	`RemoteConfigSettings`
`FIRRemoteConfig`	`RemoteConfig`
상수
`FIRNamespaceGoogleMobilePlatform`	`NamespaceGoogleMobilePlatform`
`FIRRemoteConfigThrottledEndTimeInSecondsKey`	`RemoteConfigThrottledEndTimeInSecondsKey`
`FIRRemoteConfigErrorDomain`	`RemoteConfigErrorDomain`
유형 선언
`FIRRemoteConfigFetchCompletion`	`RemoteConfigFetchCompletion`
열거형
`FIRRemoteConfigFetchStatus`	`RemoteConfigFetchStatus`
`FIRRemoteConfigError`	`RemoteConfigError`
`FIRRemoteConfigSource`	`RemoteConfigSource`

스토리지

이전	신규
함수
FIRStorageReference
`put(_:)`	`putData(_:)`
`put(_:metadata:)`	`putData(_:metadata:)`
`put(_:metadata:completion:)`	`putData(_:metadata:completion:)`
`putFile(_:)`	`putFile(from:)`
`putFile(_:metadata:)`	`putFile(from:metadata:)`
`putFile(_:metadata:completion:)`	`putFile(from:metadata:completion:)`
`data(withMaxSize:completion:)`	`getData(maxSize:completion:)`
`metadata(completion:)`	`getMetadata(completion:)`
`update(_:completion:)`	`updateMetadata(_:completion:)`
클래스
`FIRStorage`	`Storage`
`FIRStorageDownloadTask`	`StorageDownloadTask`
`FIRStorageMetadata`	`StorageMetadata`
`FIRStorageObservableTask`	`StorageObservableTask`
`FIRStorageReference`	`StorageReference`
`FIRStorageTask`	`StorageTask`
`FIRStorageTaskSnapshot`	`StorageTaskSnapshot`
`FIRStorageUploadTask`	`StorageUploadTask`
상수
`FIRStorageErrorDomain`	`StorageErrorDomain`
열거형
`FIRStorageTaskStatus`	`StorageTaskStatus`
`FIRStorageErrorCode`	`StorageErrorCode`
프로토콜
`FIRStorageTaskManagement`	`StorageTaskManagement`
유형 선언
`FIRStorageHandle`	`StorageHandle`
`FIRStorageVoidDataError`	`StorageVoidDataError`
`FIRStorageVoidError`	`StorageVoidError`
`FIRStorageVoidMetadata`	`StorageVoidMetadata`
`FIRStorageVoidMetadataError`	`StorageVoidMetadataError`
`FIRStorageVoidSnapshot`	`StorageVoidSnapshot`
`FIRStorageVoidURLError`	`StorageVoidURLError`