דף זה תורגם על ידי Cloud Translation API.

מעבר לגרסה העדכנית ביותר של Firebase SDK for Swift (גרסה 4.0.0)

בגרסה 4.0.0 של Firebase iOS SDK for Swift, כללנו שינויים בהתאם מוסכמות לגבי מתן שמות הנחיות לעיצוב API של Swift. כדי לתקן שגיאות או אזהרות שעשויות להופיע בזמן עדכון האפליקציה של Firebase iOS SDK, פועלים לפי השלבים המפורטים במדריך זה להעברת נתונים.

השינויים בגרסה החדשה

ביצענו את השינויים הבאים ב-Swift SDK בכל מוצרי Firebase:

הסרת הקידומת FIR בכל השמות הקבועים, הפרוטוקולים, המחלקות, טיפוסים בני מנייה (enum) והגדרות של סוגים.
שינוי השם של FIRApp ל-FirebaseApp.
שינוי השם של FIROptions ל-FirebaseOptions.

רשימה מלאה של השינויים מפורטת בקטע 'רשימת שינויים מפורטת'.

תיקון השגיאות

הדרך הטובה ביותר לפתור שגיאות שנובעות מהשינויים האלה היא להשתמש בכלי 'תיקון' ב-Xcode.

כשפותחים את הפרויקט המעודכן בסביבת העבודה של Xcode, השגיאות שנובעות משינויי השמות מופיעות במרכז הבעיות.
לוחצים על השגיאה ומתקנים אותה בעזרת ההצעה תיבת הדו-שיח 'תיקון'.

פתרון התנגשויות בשמות

כדי לפתור התנגשויות בין שמות, צריך להשתמש במרחב השמות שסופק על ידי המודול. עבור לדוגמה, במקרה של FIRUser, שעכשיו הוא User, אולי כדאי להבדיל בין המחלקה או המבנה של User למחלקה User של Firebase.

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

רשימה מפורטת של השינויים

Analytics

הקודם	חדש
פונקציות
`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`
טיפוסים בני מנייה (enum)
`FIRActionDataKey`	`ActionDataKey`
`FIRActionCodeOperation`	`ActionCodeOperation`
`FIRAuthErrorCode`	`AuthErrorCode`

ליבה

הקודם	חדש
פונקציות
`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`
טיפוסים בני מנייה (enum)
`FIRLoggerLevel`	`FirebaseLoggerLevel`

קריסה

הקודם	חדש
פונקציות
`FIRCrashMessage(_:)`	`FirebaseCrashMessage(_:)`

מסד נתונים

הקודם	חדש
מאפיינים
FIRDatabase.h
`persistenceEnabled`	`isPersistenceEnabled`
שיעורים
`FIRDataSnapshot`	`DataSnapshot`
`FIRDatabase`	`Database`
`FIRDatabaseQuery`	`DatabaseQuery`
`FIRDatabaseReference`	`DatabaseReference`
`FIRMutableData`	`MutableData`
`FIRServerValue`	`ServerValue`
`FIRTransactionResult`	`TransactionResult`
סוג הצהרות
`FIRDatabaseHandle`	`DatabaseHandle`
טיפוסים בני מנייה (enum)
`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`
טיפוסים בני מנייה (enum)
`FIRDynamicLinkMatchConfidence`	`DynamicLinkMatchConfidence`
`FIRDLRequiredMatchConfidence`	`DLRequiredMatchConfidence`
`FIRDLRetrieveResult`	`DLRetrieveResult`
`FIRShortDynamicLinkPathLength`	`ShortDynamicLinkPathLength`

מזהה מופע

הקודם	חדש
פונקציות
`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`
טיפוסים בני מנייה (enum)
`FIRInstanceIDError`	`InstanceIDError`
`FIRInstanceIDAPNSTokenType`	`InstanceIDAPNSTokenType`

הזמנות

הקודם	חדש
שיעורים
`FIRInvites`	`Invites`
`FIRInvitesTargetApplication`	`InvitesTargetApplication`
`FIRReceivedInvite`	`ReceivedInvite`
קבועים
`FIRInvitesErrorDomain`	`InvitesErrorDomain`
טיפוסים בני מנייה (enum)
`FIRInvitesErrorCode`	`InvitesErrorCode`
`FIRReceivedInviteMatchType`	`ReceivedInviteMatchType`
פרוטוקולים
`FIRInviteBuilder`	`InviteBuilder`
`FIRInviteDelegate`	`InviteDelegate`

העברת הודעות

הקודם	חדש
פונקציות
העברת הודעות (FIR)
`connect(completion:)`	`connect(handler:)`
שיעורים
`FIRMessagingMessageInfo`	`MessagingMessageInfo`
`FIRMessagingRemoteMessage`	`MessagingRemoteMessage`
`FIRMessaging`	`Messaging`
קבועים
`FIRMessagingSendSuccess`	`MessagingSendSuccess`
`FIRMessagingSendError`	`MessagingSendError`
`FIRMessagingMessagesDeleted`	`MessagingMessagesDeleted`
`FIRMessagingConnectionStateChanged`	`MessagingConnectionStateChanged`
`FIRMessagingRegistrationTokenRefreshed`	`MessagingRegistrationTokenRefreshed`
סוג הצהרות
`FIRMessagingFCMTokenFetchCompletion`	`MessagingFCMTokenFetchCompletion`
`FIRMessagingDeleteFCMTokenCompletion`	`MessagingDeleteFCMTokenCompletion`
טיפוסים בני מנייה (enum)
`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`
טיפוסים בני מנייה (enum)
`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`
טיפוסים בני מנייה (enum)
`FIRStorageTaskStatus`	`StorageTaskStatus`
`FIRStorageErrorCode`	`StorageErrorCode`
פרוטוקולים
`FIRStorageTaskManagement`	`StorageTaskManagement`
הצהרות על טיפוסים
`FIRStorageHandle`	`StorageHandle`
`FIRStorageVoidDataError`	`StorageVoidDataError`
`FIRStorageVoidError`	`StorageVoidError`
`FIRStorageVoidMetadata`	`StorageVoidMetadata`
`FIRStorageVoidMetadataError`	`StorageVoidMetadataError`
`FIRStorageVoidSnapshot`	`StorageVoidSnapshot`
`FIRStorageVoidURLError`	`StorageVoidURLError`