Facebook/CHANGELOG and Facebook Releases

All Versions

Latest Version

15.1.0

Avg Release Cycle

16 days

Latest Release

Changelog History

Page 1

v15.1.0 Changes
🔄 Changed
- The enum AppLinkNavigation.Type type has been renamed tp AppLinkNavigationType.
- The initializer init(appLink:extras:appLinkData:settings:) in AppLinkNavigation ignores the settings argument if one is passed.
- The method navigation(with:extras:appLinkData:settings:) in AppLinkNavigation ignores the settings argument if one is passed.
🗄 Deprecated
- 🗄 The navigation(with:extras:appLinkData:settings:) method in AppLinkNavigation is deprecated in favor of the init(appLink:extras:appLinkData:) designated init.
- 🗄 The init(appLink:extras:appLinkData:settings:) initializer in AppLinkNavigation is deprecated in favor of the init(appLink:extras:appLinkData:) designated init.
- ⚡️ The Profile.enableUpdatesOnAccessTokenChange(_:) method is deprecated in favor of the Profile.isUpdatedWithAccessTokenChange property.
- 🗄 SettingsProtocol.codelessDebugLogEnabled is deprecated in favor of SettingsProtocol.isCodelessDebugLogEnabled.
- 🗄 SettingsProtocol.advertiserIDCollectionEnabled is deprecated in favor of SettingsProtocol.isAdvertiserIDCollectionEnabled.
- 🗄 SettingsProtocol.advertiserTrackingEnabled is deprecated in favor of SettingsProtocol.isAdvertiserTrackingEnabled.
- 🗄 SettingsProtocol.graphAPIDebugParamValue is deprecated in favor of its new name SettingsProtocol.graphAPIDebugParameterValue
- 🗄 Settings.autoLogAppEventsEnabled is deprecated in favor of Settings.isAutoLogAppEventsEnabled.
📇 Renamed
- SettingsProtocol.graphAPIDebugParamValue has been renamed to SettingsProtocol.graphAPIDebugParameterValue
✂ Removed
- 🚚 Profile conformance to NSCopying has been removed as well as custom hashability and equatability.
🛠 Fixed
- 📚 The documentation for the property list-backed value Settings.isCodelessDebugLogEnabled has been corrected to indicate that the default value is false.
🚀 2022-10-24 | Full Changelog
v15.0.0 Changes
🔄 Changed
- 👍 The minimum supported version of iOS and tvOS is now 12.0.
🗄 Deprecated
- 👌 Support for tvOS is now deprecated and will be removed in Version 16.
✂ Removed
- 👌 Support for bitcode. Bitcode is no longer needed or supported by Apple as of Xcode 14 - https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes
👌 Improved
- Binary artifact sizes are now smaller.
🚀 2022-09-19 | Full Changelog
v14.1.0 Changes
🛠 Fixed
- 🛠 Fixed GitHub Issue #2082.
➕ Added
- ➕ Added server-side AEM rule matching
🚀 2022-06-28 | Full Changelog
v14.0.0 Changes
✂ Removed
- ✂ Removed deprecated AEMReporter.configure(networker:appID:) method.
- ✂ Removed deprecated ContextDialogPresenter.showCreateContextDialog(withContent:delegate:) method.
- ✂ Removed deprecated ContextDialogPresenter.showSwitchContextDialog(withContent:delegate:) method.
- ✂ Removed deprecated ContextDialogPresenter.showChooseContextDialog(withContent:delegate:) method.
- ✂ Removed deprecated ContextDialogPresenter.showChooseContextDialog(with:delegate:) method.
- ✂ Removed deprecated ContextDialogPresenter.createContextDialog(withContent:delegate:) method.
- ✂ Removed deprecated ContextDialogPresenter.switchContextDialog(withContent:delegate:) method.
- ✂ Removed deprecated SwitchContextDialog.dialog(content:windowFinder:delegate:) method.
- ✂ Removed deprecated LoginConfiguration.authType(for:) method.
- ✂ Removed internal AuthenticationTokenSettings protocol.
🔄 Changed
- Made LoginManagerLoginResult.token immutable.
- Made LoginManagerLoginResult.authenticationToken immutable.
- Made LoginManagerLoginResult.isCancelled immutable.
- Made LoginManagerLoginResult.grantedPermissions immutable.
- Made LoginManagerLoginResult.declinedPermissions immutable.
- Made AccessToken.currentAccessToken use a Swift name of current.
- Made AuthenticationToken.currentAuthenticationToken use a Swift name of current.
- 📇 Renamed SharingValidation protocol to SharingValidatable.
- Corrected type definition for FBSDKUserIdentifier to be NSString * instead of NSString for Swift compatibility.
🚀 2022-06-03 | Full Changelog
v13.2.0 Changes
🛠 Fixed
- 🛠 Fixed an issue in native sharing where hashtags are not automatically added to a post.
🚀 2022-04-15 | Full Changelog

v13.1.0 Changes

🚀 2022-03-14 | Full Changelog

Notable Changes

➕ Added an API to support deep linking using Universal Links

In order to ensure that your app properly supports deep linking from app ads with Universal Links, you will need to implement application(_:continue:restorationHandler:) in your App Delegate, and call ApplicationDelegate.shared.application(_:continue:) from your implementation. Your change might look like the following snippet:

func application(
  _ application: UIApplication,
  continue userActivity: NSUserActivity,
  restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
) -> Bool {
  ApplicationDelegate.shared.application(application, continue: userActivity)

  // Rest of implementation...

  return true
}

If your app is opted into Scenes, then you will also need to add the following code in your Scene Delegate implementation, in scene(_:willConnectTo:options:):

func scene(
  _ scene: UIScene,
  willConnectTo session: UISceneSession,
  options connectionOptions: UIScene.ConnectionOptions
) {
  if let userActivity = connectionOptions.userActivities.first {
    ApplicationDelegate.shared.application(UIApplication.shared, continue: userActivity)
  }

  // Rest of implementation...
}

v13.0.0 Changes
Notable Changes
👌 Supported platform versions have been updated

👍 The minimum supported version of iOS is now 11.0 for all frameworks. The minimum supported version of tvOS is now 11.0 for all frameworks. The XCFramework binaries are now built with Xcode 13 so Xcode 12 is no longer supported.

Client Tokens are now required

🚀 Starting with the v13.0 release, client tokens must be included in apps for Graph API calls. An exception is now raised when running apps without a client token. See the instructions for more information.

Swift conversions

A number of types have been converted from Objective-C to Swift. As a consequence, developers may need to use modular import statements when using GamingServicesKit and a majority of ShareKit in order to avoid encountering compilation errors in Objective-C.
```
// When importing a framework in this form:
#import <FBSDKShareKit/FBSDKShareKit.h>

// You may be need to update to this form when unknown symbol warnings appear:
@import FBSDKShareKit;
```
⬇️ Reduced use of Objective-C value-type practices

We have further reduced the use of Objective-C value-type practices in ShareKit. ShareKit content types will no longer implement the following behaviors:
- conformance to the NSCopying protocol
- custom hashability and equatability
- conformance to NSSecureCoding
➕ Additional strong typing of app event reporting methods

More app event reporting interfaces now use formal app event names and parameter names. Developers working in Swift code are required to use AppEvents.Name and AppEvents.ParameterName instances to represent app event names and app event parameter names, respectively.

The example below works without changes in Objective-C:
```
NSDictionary<NSString *, id> *parameters = @{
  FBSDKAppEventParameterNameNumItems: @5,
  @"custom_parameter": @"special info"
};

[FBSDKAppEvents logEvent:FBSDKAppEventNamePurchased
              parameters:parameters];
```
⚡️ This next example is how it would look in Swift for an updated API:
```
let parameters: [AppEvents.ParameterName: Any] = [
  .numItems: 5,
  .init("custom_parameter"): "special info"
]

AppEvents.logEvent(.purchased, parameters: parameters)
```
🔄 Changed
- 📇 Renamed frictionlessRequestsEnabled property on GameRequestDialog in Objective-C; use isFrictionlessRequestsEnabled and setIsFrictionlessRequestsEnabled: instead.
- Corrected nullability of contentURL in protocol SharingContent
- 📇 Renamed AppInviteDestination to AppInviteContent.Destination
- 📇 Renamed userGenerated property on SharePhoto in Objective-C; use isUserGenerated and setIsUserGenerated: instead.
🗄 Deprecated
- 🗄 Deprecated the FacebookGamingServices CocoaPod; please use the FBSDKGamingServicesKit pod instead. SPM users should continue to use FacebookGamingServices.
🚚 Moved

🚚 A few types have been moved from FBSDKShareKit to FBSDKGamingServicesKit. If you were using any of these you will have to add @import FBSDKGamingServicesKit in order to access these:
- GameRequestActionType
- GameRequestContent
- GameRequestDialog
- GameRequestDialogDelegate
- GameRequestFilter
- GameRequestFrictionlessRecipientCache
- GameRequestURLProvider
✂ Removed
- ✂ Removed NSObjectProtocol conformance/inheritance from multiple types in ShareKit.
- ✂ Removed deprecated SDKError type; ErrorFactory and/or NetworkErrorChecker should be used instead.
- ✂ Removed deprecated ReferralCode, ReferralManager, ReferralManagerResult and related classes.
- ✂ Removed unused AppGroupContent class, AppGroupPrivacy enum and NSStringFromFBSDKAppGroupPrivacy function.
- ✂ Removed SharingScheme protocol from ShareKit
- ✂ Removed deprecated logInWithURL:handler from LoginManager
- ✂ Removed deprecated init and new methods from AppInviteContent
- ✂ Removed deprecated AppLinkResolverRequestBuilder
- ✂ Removed deprecated URL schemes .facebookApp, .facebookShareExtension and .masqueradePlayer; use .facebookAPI instead.
- ✂ Removed deprecated init and new methods from CrashHandler
- ✂ Removed init and new methods from MessageDialog; use init(content:delegate:) instead.
- ✂ Removed deprecated init and new methods from Logger
- ✂ Removed deprecated init and new methods from FBSDKURLSession
- ✂ Removed init and new methods from ShareDialog; use init(viewController:content:delegate:) instead.
- ✂ Removed init and new from ShareCameraEffectContent; use init(effectID:contentURL:) instead.
- ✂ Removed deprecated init(appLink:extras:appLinkData:) from AppLinkNavigation; use init(appLink:extras:appLinkData:settings:) instead".
- ✂ Removed class-based factory methods for SharePhoto: 🚚 +photoWithImage:userGenerated:, +photoWithImageURL:userGenerated:, +photoWithPhotoAsset:userGenerated:. Also removed init and new; use the new convenience initializers instead.
- ✂ Removed class-based factory methods for ShareVideo: +videoWithData:, +videoWithData:previewPhoto:, +videoWithVideoAsset:, +videoWithVideoAsset:previewPhoto:, +videoWithVideoURL:, +videoWithVideoURL:previewPhoto:. Also removed init and new; use the new convenience initializers instead.
- ✂ Removed videoURL property from PHAsset.
- ✂ Removed isEqualToHashtag: and hashtagWithString: methods from Hashtag. Use isEqual: and initWithString: instead.
🗄 AppEvents deprecations

🗄 Use AppEvents.shared in places where AppEvents was used before. (Many class methods and properties in AppEvents have been deprecated in favor of their instance-based equivalents.)
- ✂ Removed deprecated AppEvents.flushBehavior (use AppEvents.shared.flushBehavior instead)
- ✂ Removed deprecated AppEvents.loggingOverrideAppID (use AppEvents.shared.loggingOverrideAppID instead)
- ✂ Removed deprecated AppEvents.userID (use AppEvents.shared.userID instead)
- ✂ Removed deprecated AppEvents.anonymousID (use AppEvents.shared.anonymousID instead)
- Removed deprecated AppEvents.logEvent(_:) (use AppEvents.shared.logEvent(_:) instead)
- Removed deprecated AppEvents.logEvent(_:valueToSum:) (use AppEvents.shared.logEvent(_:valueToSum:) instead)
- Removed deprecated AppEvents.logEvent(_:parameters:) (use AppEvents.shared.logEvent(_:parameters:) instead)
- Removed deprecated AppEvents.logEvent(_:valueToSum:parameters:) (use AppEvents.shared.logEvent(_:valueToSum:parameters:) instead)
- Removed deprecated AppEvents.logEvent(_:valueToSum:parameters:accessToken:) (use AppEvents.shared.logEvent(_:valueToSum:parameters:accessToken:) instead)
- ✂ Removed deprecated AppEvents.logPurchase(_:currency:) (use AppEvents.shared.logPurchase(amount:currency:) instead)
- ✂ Removed deprecated AppEvents.logPurchase(_:currency:parameters:) (use AppEvents.shared.logPurchase(amount:currency:parameters:) instead)
- ✂ Removed deprecated AppEvents.logPurchase(_:currency:parameters:accessToken:) (use AppEvents.shared.logPurchase(amount:currency:parameters:accessToken:) instead)
- ✂ Removed deprecated AppEvents.logPushNotificationOpen(_:) (use AppEvents.shared.logPushNotificationOpen(payload:) instead)
- ✂ Removed deprecated AppEvents.logPushNotificationOpen(_:action:) (use AppEvents.shared.logPushNotificationOpen(payload:action:) instead)
- ✂ Removed deprecated AppEvents.logProductItem(_:availability:condition:description:imageLink:link:title:priceAmount:currency:gtin:mpn:brand:parameters:) (use AppEvents.shared.logProductItem(id:availability:condition:description:imageLink:link:title:priceAmount:currency:gtin:mpn:brand:parameters:) instead)
- Removed deprecated AppEvents.setPushNotificationsDeviceToken(_:) (use AppEvents.shared.setPushNotificationsDeviceToken(_:) instead)
- Removed deprecated AppEvents.setPushNotificationsDeviceToken(_:) (use AppEvents.shared.setPushNotificationsDeviceToken(_:) instead)
- ✂ Removed deprecated AppEvents.flush() (use AppEvents.shared.flush() instead)
- ✂ Removed deprecated AppEvents.requestForCustomAudienceThirdPartyID(with:) (use AppEvents.shared.requestForCustomAudienceThirdPartyID(accessToken:) instead)
- ✂ Removed deprecated AppEvents.clearUserID is deprecated and will be removed in the next major release, please set AppEvents.shared.userID to nil instead)
- Removed deprecated AppEvents.augmentHybridWKWebView(_:) (use AppEvents.shared.augmentHybridWebView(_:) instead)
- Removed deprecated AppEvents.setIsUnityInit(_:) (use AppEvents.shared.setIsUnityInitialized(_:) instead)
- ✂ Removed deprecated AppEvents.sendEventBindingsToUnity() (use AppEvents.shared.sendEventBindingsToUnity() instead)
- ✂ Removed deprecated AppEvents.setUser(email:firstName:lastName:phone:dateOfBirth:gender:city:state:zip:country:) (use AppEvents.shared.setUser(email:firstName:lastName:phone:dateOfBirth:gender:city:state:zip:country:) instead)
- ✂ Removed deprecated AppEvents.clearUserData() (use AppEvents.shared.clearUserData() instead)
- ✂ Removed deprecated AppEvents.getUserData() (use AppEvents.shared.getUserData() instead)
- Removed deprecated AppEvents.setUserData(_:forType:) (use AppEvents.shared.setUserData(_:forType:) instead)
- Removed deprecated AppEvents.clearUserDataForType(_:) (use AppEvents.shared.clearUserDataForType(_:) instead)
🗄 Settings deprecations

🗄 Use Settings.shared in places where Settings was used before. (Many class methods and properties in FBSDKSettings have been deprecated in favor of their instance-based equivalents.)
- ✂ Removed deprecated Settings.sdkVersion (use Settings.shared.sdkVersion instead")
- ✂ Removed deprecated Settings.defaultGraphAPIVersion (use Settings.shared.defaultGraphAPIVersion instead")
- ✂ Removed deprecated Settings.JPEGCompressionQuality (use Settings.shared.JPEGCompressionQuality instead")
- ✂ Removed deprecated Settings.isAutoLogAppEventsEnabled (use Settings.shared.isAutoLogAppEventsEnabled instead")
- ✂ Removed deprecated Settings.isCodelessDebugLogEnabled (use Settings.shared.isCodelessDebugLogEnabled instead")
- ✂ Removed deprecated Settings.isAdvertiserIDCollectionEnabled (use Settings.shared.isAdvertiserIDCollectionEnabled instead")
- ✂ Removed deprecated Settings.isSKAdNetworkReportEnabled (use Settings.shared.isSKAdNetworkReportEnabled instead")
- ✂ Removed deprecated Settings.shouldLimitEventAndDataUsage (use Settings.shared.isEventDataUsageLimited instead")
- ✂ Removed deprecated Settings.shouldUseCachedValuesForExpensiveMetadata (use Settings.shared.shouldUseCachedValuesForExpensiveMetadata instead")
- ✂ Removed deprecated Settings.isGraphErrorRecoveryEnabled (use Settings.shared.isGraphErrorRecoveryEnabled instead")
- ✂ Removed deprecated Settings.appID (use Settings.shared.appID instead")
- ✂ Removed deprecated Settings.appURLSchemeSuffix (use Settings.shared.appURLSchemeSuffix instead")
- ✂ Removed deprecated Settings.clientToken (use Settings.shared.clientToken instead")
- ✂ Removed deprecated Settings.displayName (use Settings.shared.displayName instead")
- ✂ Removed deprecated Settings.facebookDomainPart (use Settings.shared.facebookDomainPart instead")
- ✂ Removed deprecated Settings.loggingBehaviors (use Settings.shared.loggingBehaviors instead")
- ✂ Removed deprecated Settings.graphAPIVersion (use the Settings.shared.graphAPIVersion property instead")
- ✂ Removed deprecated Settings.isAdvertiserTrackingEnabled() (use the Settings.shared.isAdvertiserTrackingEnabled property instead")
- ✂ Removed deprecated Settings.setAdvertiserTrackingEnabled(_:) (use the Settings.shared.isAdvertiserTrackingEnabled property to set a value instead")
- Removed deprecated Settings.setDataProcessingOptions(_:) (use the Settings.shared.setDataProcessingOptions(_:) method to set the data processing options instead")
- Removed deprecated Settings.setDataProcessingOptions(_:_:_:) (use the Settings.shared.setDataProcessingOptions(_:_:_:) method to set the data processing options instead")
- ✂ Removed deprecated Settings.enableLoggingBehavior() (use Settings.shared.enableLoggingBehavior() instead")
- ✂ Removed deprecated Settings.disableLoggingBehavior() (use Settings.shared.disableLoggingBehavior() instead")
🚀 2022-02-15 | Full Changelog
v12.3.2 Changes
🚀 This release contains various fixes for FBAEMKit

🛠 Fixed
- Fetched AEM config after AEM URL is received
- ➕ Added delay between AEM conversion requests
- 🚚 Moved Catalog Matching logic behind GK
🚀 2022-02-07 | Full Changelog
v12.3.1 Changes
🛠 Fixed
- 🛠 Fixed missing defaultComponents accessor for CoreKitComponents. Fixes issue #2010.
🚀 2022-01-19 | Full Changelog
v12.3.0 Changes
➕ Added
- ➕ Added network error checking protocol (NetworkErrorChecking) and concrete implementation (NetworkErrorChecker)
- ➕ Added error factory protocol (ErrorCreating) and concrete implementation (ErrorFactory)
✂ Removed
- ✂ Removed configureWithWebViewProvider:urlOpener: from FBSDKWebDialogView
🗄 Deprecated
- 🗄 SDKError has been deprecated in favor of the new ErrorFactory and NetworkErrorChecker types
- 🗄 NSStringFromFBSDKShareDialogMode() has been deprecated in favor of ShareDialog.Mode.description
🚀 2022-01-06 | Full Changelog

1
2
3
4
5
Next ›
Last »

Facebook changelog

Used to integrate the Facebook Platform with your iOS & tvOS apps.

Changelog History Page 1

🔄 Changed

🗄 Deprecated

📇 Renamed

✂ Removed

🛠 Fixed

🔄 Changed

🗄 Deprecated

✂ Removed

👌 Improved

🛠 Fixed

➕ Added

✂ Removed

🔄 Changed

🛠 Fixed

Notable Changes

➕ Added an API to support deep linking using Universal Links

Notable Changes

👌 Supported platform versions have been updated

Client Tokens are now required

Swift conversions

⬇️ Reduced use of Objective-C value-type practices

➕ Additional strong typing of app event reporting methods

🔄 Changed

🗄 Deprecated

🚚 Moved

✂ Removed

🗄 AppEvents deprecations

🗄 Settings deprecations

🛠 Fixed

🛠 Fixed

➕ Added

✂ Removed

🗄 Deprecated

Changelog History

Page 1