文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:2020年11月19日
中文(简体) 更新时间:2018年12月24日

Facebook SDK for iOS Changelog

Changelog and release notes for the Facebook SDK for iOS.

5.0.0 and later

For the changelogs for 5.0.0 and later, see facebook/facebook-objc-sdkCHANGELOG.md on GitHub.

4.44.0 - 2019-04-05

2019-04-02 | Full Changelog

Added

  • Add parameter _inBackground for app events

Fixed

  • Various bug fixes

4.40.0 - January 22, 2019

Facebook SDK

Added

Modified

Fixed

  • Various bug fixes

4.39.1 - January 15, 2019

Facebook SDK

Added

Modified

Fixed

  • Various bug fixes

4.39.0 - December 5, 2018

Facebook SDK

Added

Modified

  • In-app purchase auto logging is turned on by default. All iOS auto-logged purchases are automatically verified.

Fixed

  • Various bug fixes

4.38.0 - October 23, 2018

Facebook SDK

Added

Modified

Fixed

  • Resolved Bitcode Failure for Xcode 10/iOS 12
  • Various bug fixes

4.37.0 - September 27, 2018

Facebook SDK

Added

Modified

Fixed

  • Various bug fixes

4.36.0 - August 30, 2018

Facebook SDK

Added

  • New in-app purchase auto logging advanced matching for app events uninstall tracking new standard events

Modified

Fixed

  • Various bug fixes

4.35.0 - July 26, 2018

Facebook SDK

Added

  • Access to Graph API v3.1
  • Added [FBSDKAppEvents clearUserID];

Modified

Fixed

  • Various bug fixes.

4.34.0 - June 18, 2018

Facebook SDK

Added

  • Added Marketing kit to enable codeless app events logging.
  • Added a JavascriptInterface and an augmentWebview method. This allow hybrid apps to send AppEvents from the pixel.
  • Added videoAsset property to FBShareVideo so partners can share a video from the Photo library using a PHAsset.

Modified

  • Improved compatibility with Graph API 3.0.

Fixed

  • Various bug fixes.

4.33.0 - May 1, 2018

Facebook SDK

Added

  • UPGRADE TO FACEBOOK GRAPH API VERSION 3.0
  • ADDS FBSDKACCESSTOKEN CURRENTACCESSTOKENISACTIVE CONVENIENCE METHOD

Modified

Fixed

  • BETTER HANDLING OF INACTIVE LOGINS
  • VARIOUS BUG FIXES

4.32.0 - April 11, 2018

Facebook SDK

Added

Modified

  • Added support for providing a custom location for the getCurrentLocation call.

Fixed

  • Fixed a crash related to completion blocks.
  • Fixed a bluetooth alert issue

Account Kit SDK

Added

Modified

Fixed

4.31.1 - March 5, 2018

Facebook SDK

Added

Modified

Fixed

  • Fixed bug with batch request post parameters

4.31.0 - February 28, 2018

Facebook SDK

Added

Modified

Fixed

Account Kit SDK

Added

Modified

Fixed

4.30.0 - January 24, 2018

Facebook SDK

Added

Modified

Fixed

  • Minor fixes to messenger sharing
  • Fix for locking the device in middle of authentication session

Account Kit SDK

Added

  • Upgrade to AccountKit Graph API version 1.3

Modified

  • Removed preferences API

Fixed

4.29.0 - December 5, 2017

Facebook SDK

Added

  • New Messenger Sharing SDK features: Blog post

Fixed

  • Emission of bitcodes for XCode 9 / iOS 11 SDK

4.28.0 - November 7, 2017

Facebook SDK

Modified

  • The App Invites feature has been deprecated.
  • The Native Like Button has been deprecated.
  • Capture receipt data in implicit purchase logging

4.27.0 - September 26, 2017

Facebook SDK

Added

  • Support for Xcode 9

Fixed

  • iOS 11 Bug fixes

4.26.0 - August 24, 2017

Facebook SDK

Added

  • QR Codes on device login and sharing

Fixed

  • Mitigate issue with SafariViewController not showing if there keyWindow in UIApplication is nil

4.25.0 - July 26, 2017

Facebook SDK

Fixed

  • Fixed Carthage integration

Audience Network

Modified

  • Log the type of events that are dispatched from unified logging (only ids were logged to the console before)
  • Added support for offline playback of Interstitial video ads
  • Additional support for showing Interstitial ads after device orientation change
  • Minor redesign of AdUnitsSample project (now includes Instream sample)
  • Removed InstreamAdSample project
  • Added playing property to FBMediaViewVideoRenderer
  • Changed default value of FBMediaViewVideoRenderer duration property to kCMTimeIndefinite

Fixed

  • Log the type of events that are dispatched from unified logging (only ids were logged to the console before)
  • Added support for offline playback of Interstitial video ads
  • Additional support for showing Interstitial ads after device orientation change
  • Minor redesign of AdUnitsSample project (now includes Instream sample)
  • Removed InstreamAdSample project

4.24.0 - June 26, 2017

Facebook SDK

Added

  • Localization for "Continue with Facebook" button

Fixed

  • FBSDKSharingDialog canShow validates content if set

Audience Network

Added

  • Added additional AdChoices properties to FBNativeAd
  • Added backgroundVideoPlaybackAllowed property to FBAdSettings

Modified

  • Improvements to FBRewardedVideoAd layout

Fixed

  • Fix occasional debugger warnings in FBMediaView

4.23.0 - May 25, 2017

Facebook SDK

Fixed

  • Fixed a crash bug in the PlacesKit Sample App for iOS 8/9

Audience Network

Added

  • Added FBMediaViewVideoRenderer for native video ad customization
  • Reverted LTO-built library due to compatibility issues compiling with older Xcode versions
  • Changed debug output to line tables only for SDK size reduction
  • Added dynamic library build (FBAudienceNetworkDynamicFramework)

Modified

  • Simplified public interface of FBAdChoicesView

Fixed

  • Updated video player library to latest stable version
  • Fixes a race condition for native video ads (blank screen error)

Account Kit

Added

  • Added country flags to country code selector of phone login

Modified

  • Localization improvements
  • Improvement to accessibility controls

Fixed

  • Fixes to UI issues with disappearing buttons and wrong labels

4.22.1 - May 12, 2017

Account Kit

Fixed

  • Fixes issue with unsupported language in App Store Review process.

4.22.0 - April 18, 2017

Facebook SDK

Added

Modified

  • Updated to use Graph API v2.9.
  • The title, description, caption and image field of FBSDKShareLinkContent have been deprecated. Please take appropriate action to remove usage of them.

Audience Network

Fixed

  • Fixed a critical bug that the image ad content is not rendered in FBMediaView.
  • Fixed Xcode 8.3 module map build error

Account Kit

Added

  • Backup verification for phone number using voice call.
  • Two additional Skin types: Contemporary and Translucent
  • Calling logout endpoint for logging out

Modified

  • Added additional logging
  • Updated UX for the resending SMS flow
  • Improve experience for small screens
  • Improve how the disclosure text is shown in the UX
  • Show error message in title and not in actionBar

Fixed

  • Improvements to support for right-to-left languages (Arabic and Hebrew)
  • Fixes for iOS8 and iOS9 for UX
  • Improved accessibility identifiers

4.21.0 - April 5, 2017

Audience Network

Added

  • Redesigned Interstitial ads and added video autoplay for DR and brand video ads.
  • Added support for iOS App extensions to show ads in keyboard apps.

Fixed

  • Fixed several memory leak issues playing video ads.

4.20.2 - March 16, 2017

Account Kit

Fixed

  • Fixes issue with missing architecture for i385 and x86_64.

4.20.1 - March 10, 2017

Account Kit

Fixed

  • Fixes issue with unsupported language in App Store Review process.

4.20.0 - March 1, 2017

Facebook SDK

Modified

  • Updates and localizes the SmartLogin dialog.
  • Push tokens are now sent immediately. See docs for more details.

Account Kit

Added

  • Classic skin option.

Fixed

  • Counter on the "resend SMS" button is fixed.

Modified

  • Default UI when no theme is selected is now Classic skin instead of the old default look.
  • Minor visual changes.

Audience Network

Fixed

  • Reduced iOS SDK static library size to 55MB.
  • Improved SDK Quality and Performance.

4.19.0 - January 25, 2017

Facebook SDK

Modified

  • [FBSDKAppEvents activateApp] is now called during SDK initialization. No need to call activateApp in code
  • Update the look and feel of FBSDKLoginButton. See upgrade guide for more details

Account Kit

Added

  • Logging for country codes

Fixed

  • Allow for Account Kit Advanced UI theming in country code selector
  • Ensure on small devices the Next button is visible

Audience Network

Added

  • Added the aspectRatio property to FBMediaView, to provide a hint for publishers who want to adjust their app layout in response to the dimensions of the contents of the view. This will allow publishers to do things like adapting the height of an ad cell in a feed, or showing a specialized layout for portrait video ads. The aspect ratio is width/height and is greater than or equal to 0.0.
  • Added applyNaturalWidth and applyNaturalHeight which change the width or height based on current FBMediaView's dimension, respecting aspectRatio property. Check Native Ads developer document for more information about how to use these new APIs.
  • Added setMediaViewRenderingMethod to FBAdSetting to configure the rendering method for FBMediaView. The available rendering methods are FBMediaViewRenderingMethodDefault, FBMediaViewRenderingMethodMetal, FBMediaViewRenderingMethodOpenGL, and FBMediaViewRenderingMethodSoftware.

Fixed

  • Fixed performance and stability issues with integrity checks.
  • Improved the stability of video playing for video ads.
  • Switched software fallback for OpenGL blurred image rendering on iPhone 5 devices to prevent crashes.
  • Fixed occasional white screen bug on link clicks for banner/interstitial ads.
  • Fixed a bug that adViewDidClick callback method of FBInstreamAdViewDelegate is not called.
  • Fixed some memory leak and crash issues reported from previous release.

4.18.0 - November 30, 2016

Facebook SDK

Fixed

  • Improved setting fetching in poor connectivity
  • Updated logging event naming

Account Kit

Fixed

  • Fix keyboard behavior on all entry screens

4.17.0 - October 26, 2016

Facebook SDK

Added

  • Added setUserID: and updateUserProperties: to FBSDKAppEvents. See here for more details.
  • Added application:openURL:options: to FBSDKApplicationDelegate to iOS 10.

Fixed

  • Fixed potential issues when presenting UI without a dispatch in the FBSDKLoginManager callbacks.
  • Fixed bug where FBSDKLoginManager was prematurely deallocated.
  • Fixed builds for older versions of Xcode. PR 845

Audience Network

Fixed

  • Fixed layout constraints for medium rectangle ad
  • Fixed missing selector crash in native ad templates

Account Kit

Modified

  • Updated session logging
  • Removed cancel callback
  • Updated to use the 1.1 Account Kit graph endpoint

4.16.1 - October 10, 2016

Facebook SDK

Modified

  • Updated to use Graph API 2.8

Audience Network

Fixed

  • Fixed nativeAdDidClick: not being called on FBNativeAdDelegate
  • Removed UIImagePickerController reference causing App Store rejections

4.16.0 - September 27, 2016

Facebook SDK

Added

  • Added FBSDKSettings setGraphAPIVersion: to allow global setting of different Graph API versions.

Audience Network

Added

  • Added FBInstreamAdView to support instream ad placements

Modified

  • Deprecated autoplayEnabled setter on FBMediaView in favor of server-side controls
  • Impression/click reliability improvements
  • Updated FnF video player library for increased reliability and performance

Fixed

  • Removed unintentional references to PHAsset in the FnF video player library that may cause App Store static analysis to fail

Account Kit SDK

Modified

  • Improved Resend flow, making it clearer when the user will receive a new confirmation SMS

Fixed

  • Improved layout for small screen devices (iPhone 4s, iPhone 5)

4.15.1 - Sept 9, 2016

Facebook SDK

  • Updated for Xcode 8 GM and iOS 10.
  • Deprecated FBSDKAppEventsUtility fetchDeferredAppInvite:.

4.15.0 - August 26, 2016

Facebook SDK

Deprecated

  • Deprecated FBSDKAppGroupAddDialog and FBSDKAddGroupJoinDialog interfaces.

Modified

  • The SDK now uses NSURLSession instead of NSURLConnection for making Graph API requests since NSURLConnection.

Fixed

  • PR 836 - pass in correct to login params for webview
  • Fixed crash on iPads when logging out via FBSDKLoginButton.
  • Fixed localization when using Cocoapods
  • Return individual photo IDs when sharing photos via FBSDKShareAPI whereas previously the SDK would return the photo album post ID.

Audience Network

Added

  • Improved viewability debugging information

Modified

  • Changed app store SKStoreProductViewController to allow all orientations except upside down
  • Removed unused components from SDK
  • Cleanup and optimization of FBAdEnvironmentData

Fixed

  • Improved fix for FBAdConfigManager timing issues causing FNF / AVFoundation mixed object crashes
  • Handle additional error conditions for bad user agents
  • Fixed incorrect orientations being used for interstitial rendering due to orientation being checked in two different locations
  • Reduced error logging in FBAdConfigManager in valid situations
  • Fixed crash in client event logging

Account Kit SDK

Fixed

  • Make sure viewControllerDidCancel delegate method is called when the user presses Cancel
  • Fix iOS 10 rendering issues

v4.14.0 - July 13, 2016

Facebook SDK

Modified

  • Updated to use Graph API 2.7
  • Added dynamic framework targets and Carthage support for FBSDKCoreKit, FBSDKLoginKit, FBSDKShareKit.

Fixed

  • Replace deprecated UIActionSheet with UIAlertController
  • Fix empty profile picture when all permissions revoked

Audience Network

Added

  • Improved SKStoreProductViewController with more reliable loads and automatic timeout

Fixed

  • Size and performance improvements
  • Fixed timing issue with FBAdConfig that caused AVFoundation and FNF* objects to be used together, causing "unknown selector" crashes
  • Removed "objc_arc" flag from modulemap

AccountKit

Fixed

  • Updated the method signature of viewControllerForLoginResume

v4.13.1 - June 16, 2016

Audience Network

Fixed

  • Performance and size improvements
  • Removed internal debugging utilities not meant for release builds (FBAdThreadWatchdog)

v4.13.0 - June 15, 2016

Audience Network

Fixed

  • Fixed conflicting selector (dataAvailable) used in video library
  • Fixed deadlock in video library
  • Fixed rare crash caused by threading issues with FBAdConfigManager
  • Performance optimization and improvement

v4.12.0 - May 19, 2016

Facebook SDK

Added

  • Added [FBSDKShareAPI.accessToken] to allow changing the access token used for sharing (pull request 826)

Modified

  • Initial logins will now pass the "rerequest" flag so that previously denied permissions are presented in the login dialog

Fixed

  • Fixed cases where AppEvents could crash because of missing session id.
  • Fixed bug in some cases where access token expiration date was the refresh date.

Audience Network

Added

  • Added new high performance video player for FBMediaView using the same technology as the Facebook app (no more UI stalls)
  • Added new high performance Metal-based blurred image renderer for FBMediaView (with OpenGL fallback)
  • Added New dependencies - libxml2 and the C++ runtime

Modified

  • Improved view controller error detection

Fixed

  • FBMediaView shows cover image instead of first video frame when autoplay is disabled
  • FBMediaView now adds blurring to carousel images with different aspect ratios (if necessary)
  • FBMediaView follows media cache flag for carousel images
  • Fixed FBNativeAdsCachePolicyAll media cache flag
  • Fixed video stopping when rotated into landscape on iOS 7 devices
  • Fixed being unable to restart a video after it ends

AccountKit

Added

  • Added Cocoapods support for AccountKit
  • Added ability to theme headerButtonTitleColor.
  • Added ability to specify custom content margins in theme
  • Added ability to customize text position when using advanced UI customization
  • Added ability to cancel login when using advanced UI customization

Fixed

  • Fixed rendering of styled headers in the country code list
  • Fixed rendering of styled email entry field
  • Fixed bug in advanced UI theming where wrong step was being reported for email verification screen

v4.11.0 - April 12, 2016

Facebook SDK

Added

  • Added -[FBSDKAppEvents logPushNotification*] and -[FBSDKAppEvents setPushNotificationsDeviceToken:]. See push campaigns docs for more details.
  • Added -[FBSDKAppLinkUtility fetchDeferredAppInvite:] to support deferred App Invite app links on iOS, and FBSDKAppInviteContent.promotionCode and FBSDKAppInviteContent.promotionText to make it easy to include a promotion code with the invite. See app invite docs for more details.
  • Added -[FBSDKProfile loadCurrentProfileWithCompletion:]
  • Added FBSDKHashTag and FBSDKShareMediaContent to support sharing hash tags and mixed content (e.g., photos and videos). See sharing docs for details.
  • Added FBSDKShareLinkContent.quote to support sharing quotes from a link.
  • Added FBSDKShareVideo.previewPhoto to provide a photo to represent the video.

Modified

  • Updated to use Graph API v2.6.
  • Improved session tracking accuracy in FBSDKAppEvents, including a configurable value for identifying session timeout thresholds (located in your app's Facebook Analytics settings).
  • The SDK throws an exception if incorrect schemes are configured in the app's plist.
  • Updated xctool and Bolts (v1.7) submodules.

Fixed

  • Fixed support for Cocoapods 0.39 and 1.0.0-beta6
  • Fixed scope of static variables in FBSDKAppEventsDeviceInfo that were incorrectly scoped global.

Audience Network

Added

  • Added video precaching for native ads

Modified

  • Changed full screen video player to start from the inline player's current time instead of the beginning

Fixed

  • Fixed iOS 7 interstitials rendering with wrong orientation issue

AccountKit

FBNotifications

v4.10.1 - March 16, 2016

Facebook SDK

  • Fixed timezone accuracy for App Events in some affected cases.

Audience Network

  • Improved Xcode 7.3-beta compatibility
  • Moved feature config loading to first call to SDK
  • Changed log when loading feature config to debug level instead of error level
  • Fixed crash when dismissing AdChoices view
  • Disabled module support to fix excessive linker warnings

v4.10.0 - February 10, 2016

Facebook SDK

Modified

  • Update Bolts submodule to 1.6.
  • App Transport Security allow listing for Facebook servers is no longer needed.

Fixed

  • Fixed rendering issues for FBSDKWebDialog (fixed the border alignment).
  • Fixed bug that would overwrite explicit "locale" parameters on graph requests.
  • Removed development team ID from FBSDKLoginKit(GitHub pull request #813: @IgorOvechko).

Audience Network

Added

  • Added support for Carousel ads to FBMediaView.

Fixed

  • Fixed SFSafariViewController not dispatching dismissed events.
  • Fixed FBNativeAdTableViewCellProvider native ad registration issue.
  • Fixed rare crash in FBAdURLSession.
  • Fixed memory leak from C string to NSString conversion.
  • Fixed memory leak in network reachability.
  • Fixed memory leak in FBAdCache when image URLs are invalid.
  • Fixed crash caused by [NSString containsString:] use in iOS 7.

v4.9.1 - January 16, 2016

Fixed

  • Fixed bitcode support for all frameworks.

v4.9.0 - January 13, 2016

Facebook SDK

Added

  • Added FBSDKCatalog sample app.
  • Added FBSDKTVOSKit.framework for building tvOS apps. See our tvOS guide for more details.

Modified

  • Updated Bolts submodule to 1.5 and OHHTTPStubs submodule to 4.6.

Fixed

  • Fixed the FBSDKLikeControl social sentence to respect locale.
  • Fixed bug in FBSDKAppEvents that not send attribution in some cases.
  • Fixed FBSDKLoginButton delegate to receive loginButtonWillLogin: only at button login.
  • Fixed bug in FBSDKAppEvents that would not sent events if activateApp was sent from a background thread.
  • Fixed README documentation(github pull request #810: @orta).
  • Fixed login bug that treated a request for no new permissions as a cancellation.
  • Fixed headerdoc comments for FBSDKLoginButton regarding default height (GitHub pull request #804: @revolter).
  • Fixed missing Hebrew localization in FacebookSDKStrings.bundle
  • Fixed support for Cocoapods-1.0.0-beta2
  • Fixed ENABLE_BITCODE flag for Xcode 7.2

Audience Network

Modified

  • Removed StoreKit dependency.
  • Updated networking to use NSURLSession.
  • Improved AVPlayer/AVPlayerItem performance, minor performance gains with video scrolling

Fixed

  • Fixed heap overflow bug with CGColorGetComponents
  • Fixed rare crash caused by timers
  • Fixed changing status bar visibility on iPad devices
  • Fixed gesture recognizers being removed on native ad templates in table views
  • Fixed crash caused by UI access on the main thread
  • Fixed issue where interstitials or banners would swallow WKWebView rendering errors
  • Fixed linker warnings caused by unneeded module debug info
  • Fixed FBNativeAdView never loading contents when used standalone

v4.8.0 - November 11, 2015

Facebook SDK

Added

  • FBSDKShareAPI can now share FBSDKShareVideo content initialized with file URLs.

Modified

  • Update OHHTTPStubs to 3.1.12.
  • Reorganized some internal headers as "Project" instead of "Private" scope.

Fixed

  • Fixed the issue sharePhotoContent cannot set peopleIds in FBSDKShareAPI.
  • Fixed shareVideoContent to reject setting peopleIds and placeId (unsupported in Graph API video endpoint) in FBSDKShareAPI.

Audience Network

Modified

  • Improved FBMediaView performance - entirely skip blurring image if the media view is already at or close to the ideal 1.9:1 ratio for cover images.

Fixed

  • Resolved a rare race condition in interstitial impression logging when using WebKit to render the interstitial (iOS 8 + 9 devices).
  • Fixed issues fetching the current view controller when multiple UIWindows are present or are not at window level UIWindowLevelNormal.
  • Resolved linker errors by removing direct references to AVFoundation, CoreMedia and CoreMotion, now they are lazily loaded at runtime.

v4.7.1 - October 26, 2015

Facebook SDK

No binary changes were made in this release.

Fixed

  • Fixed issue with the login podspec.

v4.7.0 - October 7, 2015

Facebook SDK

Deprecated

  • Deprecated [FBSDKProfile imagePathForPictureMode]. Added [FBSDKProfile imageURLForPictureMode] instead.

Added

  • Added [+FBSDKRequestConnection setDefaultConnectionTimeout:] to allow setting of default timeout value for all requests.

Modified

  • The SDK now targets v2.5 of the Graph API. See the Graph API changelog for details.
  • The completion results sent to the delegate of GameRequestDialog will now contain a key "to" with a NSArray value containing the recipients.
  • Updated Bolts submodule to 1.3.0
  • Annotated FBSDKAccessToken init and new as NS_UNAVAILABLE.

Fixed

  • Fixed usage of FBSDKApplicationDelegate application:didFinishLaunchingWithOptions: in SDK samples.
  • Fixed EXEC_BAD_ACCESS that could occur in FBSDKLoginManager using FBSDKLoginBehaviorWeb and the login is cancelled.
  • Fixed headerdoc comments on FBSDKLoginBehavior.
  • Fixed deprecated warnings when compiled for iOS 9 with CocoaPods.
  • Fixed orientation issue where SFSafariViewController was not rotating in the login flow.

MessengerShareKit

  • Modified the alert message presented to user when the current Messenger version does not support the share.

Audience Network

Fixed

  • Fixed issue with excessive memory consumption displaying banners, interstitials, or link ads on some devices
  • Improved performance of banners and interstitials
  • Fixed FBMediaView blur scaling on 3x devices
  • Fixed refresh threshold error handling

v4.6.0 - September 10, 2015

Facebook SDK

Deprecated

  • Several methods on FBSDKLoginManager and FBSDKAppInviteDialog have been deprecated in favor of new overloads that take a fromViewController parameter. This resolves various presentation issues that can occur on iOS 9.

Added

  • The SDK supports various iOS 9 features including Bitcode. In addition, the SDK dialogs such as Login, Like, Share Dialogs automatically determine the best UI based on the device, including SFSafariViewController instead of Safari. Follow the our Preparing for iOS 9 guide.

Modified

  • Updated submodules, including Bolts (1.2.2).
  • Removed armv7s slice from the framework architectures.
  • Added [FBSDKLoginButtonDelegate loginButtonWillLogin:].

Fixed

  • Fixed FBSDKLoginButton selected style.
  • Fixed FBSDKTestUsersManager crash when test users did not have access tokens.
  • Fixed login bug that could cause some logins to fail with error code 308.
  • Removed old install path from samples' framework search paths.
  • Fix deferred applink handling with click_time specified (github pull request #789: @kookiekrak).
  • Fixed bug that may prematurely dismissing login dialogs when processing error recovery.

MessengerShareKit

  • Updated to support iOS 9, including bitcode.
  • Deprecated [FBSDKMessengerSharer messengerPlatformCapabilities]

Audience Network

  • Updated to support iOS 9, including bitcode.

Fixed

  • Improved localization for fullscreen video view
  • Improved image performance for FBMediaView

v4.5.1 - August 13, 2015

Facebook SDK

Fixed

  • Fixed bug that could cause crashes when using ios7.

v4.5.0 - August 10, 2015

Facebook SDK

Modified

  • The SDK is now distributed as a zip archive instead an installer. A script is included to install Xcode docsets manually.
  • The SDK performs some additional logging in preparation for iOS 9. Please review our guide to prepare for iOS 9.
  • FBSDKShareDialog now automatically tries FBSDKShareDialogModeBrowser if FBSDKShareDialogModeNative is specified and the Facebook App on the device does not support the content.
  • Updated submodules OHHTTPStubs, OCMock, xctool.

Fixed

  • Fixed bug that could cause crashes when logging FBSDKAppEvents from multiple threads for different events.
  • Fixed bug in FBSDKGraphRequestConnection where requestConnectionDidFinishLoading is called even in the case of a network error.

MessengerShareKit

Added

  • Added support for rendering static and animated image as sticker in Messenger.

Modified

  • Deprecated [FBSDKMessengerSharer messengerPlatformCapabilities] in preparation for iOS 9. Rather than checking what Messenger is available, simply send the content and the SDK will alert the user if they need to update Messenger.

Audience Network

Added

  • Added video support for FBMediaView.

Fixed

  • Fixed interstitial orientation issue with iOS 7 devices.
  • Fixed crash when using FBMediaView caused by using OpenGL in the background.

v4.4.0 - July 7, 2015

Facebook SDK

Modified

  • The SDK now targets v2.4 of the Graph API. Please review the Graph API changelog for details. For example, the number of default fields returned by Graph endpoints have been reduced and you should always explicitly ask for the fields you need.
  • Updated Bolts to 1.2.
  • Updated header docs for FBSDKShareLinkContent to clarify parameter usage.
  • Modified RPSSample with additional FBSDKAppEvents for game results.
  • Removed unused groupID property from FBSDKAppGroupContent.

Fixed

  • Fixed bug when tagging people or places in open graph stories when using Share Dialogs.
  • Fixed bug in FBSDKShareDialog that did not validate content before sharing.
  • Fixed RPSSample to assign delegate to its share dialog.

v4.3.0 - June 25, 2015

Facebook SDK

Added

  • Added graphNode property to FBSDKShareAPI.

Modified

  • Shares through the integrated share sheet now get proper app attribution.

Fixed

  • Fixed crash when sharing content (like photos) via the Share Dialog in the callback of the FBSDKLoginManager.
  • Fixed stack overflows when rendering FBSDKLoginButton in iPad popovers
  • Fixed NSKeyedUnarchiver console error when using like controls.
  • Fixed bug in refreshCurrentAccessToken to prevent bad logic when currentAccessToken == nil.
  • Fixed consoler error when using FBSDKProfilePictureView with an initial size dimension of 0.

MessengerShareKit

Fixed

  • Fixed bug that truncated metadata containing ampersands or semicolons.

Audience Network

Modified

  • Performance improvements for image fetching and native ad templates

v4.2.0 - May 28, 2015

Facebook SDK

Added

  • Added optional FacebookSDKStrings.bundle to provide localized strings for international apps

Modified

  • Update projects for Xcode 6.3
  • FBSDKTestUsersManager now correctly pages through test user account results.
  • Deprecated FBSDKAppInviteContent.previewImageURL, FBSDKGameRequestContent.to, FBSDKGameRequestContent.suggestions to avoid non public selector validation warnings
  • Removed FBSDKShareAPI.createObjectsWithClientToken
  • Improves Facebook Analytics reporting
  • Improved OAuth Login flow security
  • Modified RPS sample app: added player gesture image to Open Graph share
  • Modified Iconicus sample app: added ability for parse locked positions (from app link)

Fixed

  • Fixed module map for FBSDKTestUsersManager
  • Fixed landscape orientation for web view dialogs on iOS 7
  • Fix bug that incorrectly tried to apply error recovery to client token requests
  • Fixed bug preventing usage of fb:explicitly_shared for Open Graph actions.

FBSDKMessengerShareKit

Fixed

  • Fail at compile time when trying to use Messenger SDK in an extension
  • Renamed FBSDKMessengerUrlHandler.h to FBSDKMessengerURLHandler.h for case-sensitive file systems

Audience Network

Fixed

  • Fixed failure at compile time when building against iOS 6
  • Fixed issue where FBAdView had to have its frame explicitly set
  • Fixed issue with FBNativeAdsManager where sometimes invalid ads were returned as valid
  • Fixed selection style of cells created by FBNativeAdTableViewCellProvider

v4.1.0 - April 30, 2015

Facebook SDK

Added

  • Added [FBSDKAccessToken refreshCurrentAccessToken] to refresh current token.
  • Added FBSDKTestUsersManager to simplify writing tests with test users.
  • Added property caption to FBSDKSharePhoto.
  • Added property message to FBSDKShareAPI.

Modified

  • FBSDKShareAPI will now warn about missing "publish_actions" in the console rather than throwing an exception immediately.
  • The Facebook-iOS-SDK podspec has been deprecated in favor of FBSDKCoreKit, FBSDKLoginKit, FBSDKShareKit individual podspecs in order to support Cocoapods 0.36.
  • The SDK will throw an exception if the FacebookAppID or URL schemes are missing.
  • Removed FBSDKAppInviteContent initWithAppLinkURL:. Use the standard init and set the appLinkURL property.

Fixed

  • Fixed bug that prevented invoking login from app delegate lifecycle events.
  • Fixed bug that prevented usage of fb:explicitly_shared for Open Graph actions.
  • Fixed bug in system account store login that would not re-prompt for missing permissions.
  • Fixed bug in handling NSURLs and NSNumbers in parameters in sharing APIs.
  • Fixed bug that prevented FBSDKGraphRequestConnection's delegate from receiving the 'requestConnectionDidFinishLoading:' message.
  • Fixed bug that could result in premature dellocation of dialogs before completion.
  • Updated Bolts submodule reference to include fix for module map generation when trying use the SDK with Swift.

FBSDKMessengerShareKit

  • FBSDKMessengerShareKit is now available on GitHub (in the FBSDKMessegerShareKit folder in the facebook-ios-sdk repo) and Cocoapods (use pod 'FBSDKMessengerShareKit')

Fixed

  • Fixed Messenger buttons to have clear background color.

Modified

  • Removed FBSDKMessengerURLHandlerCancelShareContext.h. Use FBSDKMessengerURLHandlerCancelContext.h instead.

Audience Network

Added

  • FBNativeAdsManager to to assist in the retrieval of batches of ads.
  • FBNativeAdView which provides configurable native ad views
  • FBNativeAdScrollView which provides a horizontal scrolling experience hosting either FBNativeAdView's or custom native ad views.
  • Helper views to assist in implementations of native ads: FBAdChoicesView, FBMediaView, FBAdStarRatingView.
  • Helpers for using native ads within UITableView's.

Fixed

  • Miscellaneous bug fixes

v4.0.1 - April 2nd, 2015

Facebook SDK

Added

  • Added support for clang modules and usage of @import
  • No need for Obj-C bridging headers when used in Swift
  • Added a new sample app, Iconicus, for demonstrating hosted App Links

Fixed

  • Fixed the Share Sheet validation of photo content

v4.0 - March 25, 2015

The Facebook SDK for iOS v4.0 is a major version upgrade. Please review Upgrading the iOS SDK from 3.x to 4.x.

  • All classes are renamed or removed compared to v3.x, this changelog will describe semantic additions and removals.
  • iOS 6 is no longer supported. The FacebookSDK for iOS v4.0 requires iOS 7 or higher.

Added

  • FBSDKCoreKit.framework - the framework providing common SDK classes, and APIs for app events, Graph API Requests
  • FBSDKProfile - a robust way to fetch public profile data.
  • FBSDKGraphErrorRecoveryProcessor - an error recovery attempter to process Facebook errors.
  • FBSDKUtility - a utility class to help parse URLs.
  • FBSDKLoginKit.framework - a framework providing login functionality. Requires FBSDKCoreKit.
  • FBSDKLoginManager - a block based API for authorization.
  • FBSDKShareKit.framework - a framework providing sharing functionality. Requires FBSDKCoreKit.
  • FBSDKGameRequestDialog - a strongly typed dialog to create Game Requests.
  • FBSDKAppInviteDialog - a strongly typed dialog to send App Invites.
  • FBSDKShareAPI - a strongly typed implementation to perform shares over the Graph API.
  • FBSDKShareButton/FBSDKSendButton/FBSDKLikeButton - turn-key buttons for sharing.
  • FBSDKMessengerSharerKit.framework - a framework for building on Messenger Platform

Modified

  • All types marked @deprecated have been removed.
  • Existing types have been renamed with a FBSDK prefix instead of FB. For example, FBAppEvents -> FBSDKAppEvents.
  • FB*Dialogs and FB*DialogsParams. Use the appropriate strongly typed dialog and content model from FBSDKShareKit.framework.
  • FBAppCall is generally replaced by FBSDKApplicationDelegate. See the getting started guide.
  • FBSDKRequest* is replaced by FBSDKGraphRequest* and automatically provides error recovery and simplier error classification. See the upgrade guide.
  • FBSession and FBAccessTokenData are replaced by FBSDKLoginManager, FBSDKAccessToken. See the upgrade guide.

Removed

  • FBAppLinkData. Use BFURL from Bolts.framework.
  • FBGraphObject. Use the appropriate Open Graph content model along with FBSDKShareAPI from FBSDKShareKit.framework.
  • FB*ViewController and FBCacheDescriptor. No alternative. Construct a table view and page the Graph API results manually.
  • FBSDKTokenCachingStrategy. No alternative. FBSDKLoginManager caches tokens to keychain automatically. You can observe token changes to do manual post processing (see [FBSDKAccessToken currentAccessToken]).