Facebook SDK for Unity Changelog

• Native iOS SDK
  • Improved support for in-app purchase events for Original StoreKit APIs and StoreKit 2 APIs
• Native Android SDK
  • Improved support for in-app purchase events for Google Play Billing Libraries 5 through 7
  • Fixed potential Ad-Services namespace conflict
  • Upgraded a variety of dependencies including Kotlin, Gradle, and the Android Gradle Plugin
  • Modified how we pass the content id of purchases in custom events

• Bumped SDK to 18.0.0
• Bumped iOS SDK version to 18.0.0
• Bumped Android SDK version to 18.0.3

• Bumped SDK to 17.0.1
• Bumped iOS SDK version to 17.0.1
  • Updated privacy manifests.

• Native iOS SDK
  • Added privacy manifests.
• Native Android SDK
  • Supported more integrity use cases.

• Bumped SDK to 17.0.0
• Bumped iOS SDK version to 17.0.0
• Bumped Android SDK version to 17.0.0
• Bumped Graph API version to 17.0.0

• Native iOS SDK
  • Added privacy manifests.
• Native Android SDK
  • Supported more integrity use cases.

• Bumped SDK to 17.0.0
• Bumped iOS SDK version to 17.0.0
• Bumped Android SDK version to 17.0.0
• Bumped Graph API version to 17.0.0

• Bumped SDK to 16.0.2
• Bumped Android SDK version to 16.0.1
• Bumped iOS SDK version to 16.0.1

• Fixed a bug where user did not remain logged in on subsequent sessions.

• Bumped SDK to 16.0.1

• Removed fetching app configuration data before calling FB.Init on iOS/Android platforms.
• Updated copyright in some files.

• Windows platform methods: FB.Windows.CreateReferral and FB.Windows.GetDataReferral
• Android Cloud example
• Subscriptions payments methods for Android Cloud

• Bumped native SDK versions to 16.0.0
• Bumped iOS SDK version to 16.0.0
• Bumped Android SDK version to 116.0.0
• Bumped Graph API version to 16.0
• Updated Windows SDK Dlls

• Payments price convertion to double.
• Improved mobile orientation enum for Unity example
• Improved mobile Tournaments example
• Changed folder structure for External Dependency Manager dlls

• Bumped native SDK versions to 15.1.0
• Bumped iOS SDK version to 15.1
• Bumped Android SDK version to 15.1
• Bumped Windows SDK version to 1.0.15
• Bumped Graph API version to15.0

• Android SDK path detection on latest Unity versions.
• Duplicate Event System in Unity SDK example.
• Fixed DLLs configuration in asset importer.
• Fixed ConsoleBase.cs script for Unity 2021 and above.

• Windows platform methods (FB.Windows.SetSoftKeyboardOpen)

• Bumped native SDK versions to 14.1.0
• Updated Windows platform DLLs

• Issue with new Unity Input System and UnitySDK Example.
• Issue with misconfiguration of each DLL when Unity import the package.
• Fixed some example scenes background color
• Fixed Windows platform logging issue

• Windows platform methods (FB.Windows.SetVirtualGamepadLayout, FB.GetUserLocale)
• Windows example (Virtual Gamepad Layout Test, Physical Gamepad Test)

• Bumped windows SDK versions to 1.0.14
• Bumped native SDK versions to 14.0
• Bumped Graph API version to 14.0
• (Facebook Settings) Client Token is automatically added to Podfile and AndroidManifest.xml
• (Facebook Settings) Client Token is no longer marked as optional in the editor

• GraphAPI version
• IAP empty description field
• Podfile creation for iOS platform

• Added tournament API for iOS
• Bumped native SDK verions to 13.2.0
• Bumped Graph API verion to 13.2
• Bumped minimum supported Unity version to 2019.4.39f1 (iOS only)

• Added APIs for Instant games context dialogs.
• Added Windows platform (Unity standalone build.
• Bumped native SDK version to 12.0.0.
• Bumped Graph API version to 12.0.
• Removed UpdateUserProperties API.

• Added tournaments APIs for cloud game.
• Added Limited Login support for user_hometown, user_location, user_gender and user_link permissions under public beta.
• Bumped native SDK version to 11.0.0.
• Bumped Graph API version to 11.0.
• Deprecated UpdateUserProperties API.

• Added AEM (Aggregated Events Measurement) support under public beta.
• Fix IOSFBEnableProfileUpdatesOnAccessTokenChange build issue.

• Added Limited Login support for user_friends, user_birthday and user_age_range permissions under public beta.
• Shared Profile instance will be populated with FriendIDs, Birthday and AgeRange fields using the claims from the AuthenticationToken. (NOTE: FriendIDs, Birthday and AgeRange fields are in public beta mode).
• Added EnableProfileUpdatesOnAccessTokenChange as part of fixing a bug where upgrading from limited to regular login would fail to fetch the profile using the newly available access token.

• Limited Login. Please read the blog post⁠ and docs for a general overview and implementation details.
• The default Graph API version is updated to v9.0

• Bug fix

• Avoid adding swift standard libs
• Fixed AndroidSdk path detection in Unity 2019 and above

• Added method SetAdvertiserTrackingEnabled to overwrite the advertiser_tracking_enabled flag
• Bumped native SDK version to 8.0.0
• Bumped Graph API version to 8.0
• Fixed lock up issue in Facebook Login

• Bug fix

• Bug fix

• Introduce DataProcessingOptions
• Remove UserProperties API

• Add Express Login
• Various bug fixes

• Fix FeedShare issue: https://github.com/facebook/facebook-sdk-for-unity/issues/284
• Fix crash when AccessToken has no graph domain

• Fix Login issue in Editor mode

• Support for Gaming Video Uploads
• Support for Gaming Image Uploads
• Support for Gaming Friend Finder

• Fix exported iOS project build issue
• Fix Android install referrer issue
• Remove AndroidJNIHelper log
• Bump Google Playservices Resolver to v1.2.135

• Remove Bolts framework
• Fix Android logout issue
• Fix the issue of multiple AppRequest instances when changing screen orientation
• Fix GetUserID issue

• Various bug fixes

• Various bug fixes

• Switch to use cocoapods and maven to pull Facebook iOS/Android SDK

• Various bug fixes

• Codeless Unity
• Remove App Invite
• Add setter and getter for UserID
• Add UpdateUserProperties
• Update iOS library to v5.0.2 and Android library to v5.0.1
• Various bug fixes

• Update iOS library to v4.39.1

• Add Toggles for App Events Setting in the Facebook Setting Inspector
• Fix broken unit tests
• Bug fix

• Bug fix

• Update Android library to v4.38.1
• Update iOS library to v4.38.1

• Update to Audience Network SDK for Android/iOS SDK 5.1.0

• Update Graph API from v2.6 to v3.0. v2.6 deprecating on July 13, 2018

• Update to Audience Network SDK for Android/iOS SDK 4.28.2

• Exceptions with Login and App Events in WebGL
• iOS build link error

• Remove noisy logWarning in AndroidSupportLibraryResolver

• WebGL run-time error

• Update Android library to v4.33.0
• Update iOS library to v4.33.0
• Update Unity Jar Resolver to v1.2.69.0

• iOS bitcode compile error

• Fixed iOS link build error

• Unity Android Purchase AutoLogging
  via Unity Codeless API

• Update Android library to v4.28.0
• Update iOS library to v4.28.0
• Update Unity Jar Resolver to v1.2.61.0

• Replace deprecated Application.ExternallCall() to jslib⁠ to call JavaScript from Unity Scripts

• Fixed missing uploadAccessToken property in Unity editor settings

• Use Unity Jar Resolver⁠ to resolve dependency

• Update Android library to v4.23.0
• Update iOS library to v4.22.0
• Remove deprecated app group and ShareLinkContent params

• Rewarded video support
• AdChoices text, image and link data for native ads

• Fixed rendering issues with native ad cover images (blank or question mark image)
• Improved viewability checks for native ads (handles different rendering types and object hierarchies far better)
• Fixed missed impression callbacks on Android

• Internal Unity build are not supported anymore. Builds should be done with Gradle. (Build Settings, select Build System)

• Support premium games on Arcade platform with PayPremium and HasLicense methods

• Update Android library to v4.17.0

• WebGL compile issues related to iOS framework targeted as Any Platform

• With code stripping enabled minimum unity version is 5.4.1p3 https://unity3d.com/unity/qa/patch-releases/5.4.1p3⁠. Without code stripping the link.xml of the unity sdk can be removed.

• Issue with il2cpp compilation on Android
• get_activeBuildTarget not being supported
• Error setting user agent on some browsers

• Update to Audience Network SDK for Android/iOS SDK 4.17.0

• WebPlayer is no longer supported

• Support for Facebook Games Arcade platform, project named Facebook.Unity.Arcade
• Facebook.sln that contains Facebook.Unity, Facebook.Unity.Arcade, Facebook.Unity.Editor, and Facebook.Unity.Tests

• Update to Facebook SDK for Android/iOS SDK 4.14.0 / 4.14.0
• Refactor Facebook.Unity to include only core SDK logic
• Refactor editor code into separate project named Facebook.Unity.Editor
• Refactor native iOS code into separate project
• Refactor SDK example into UnitySDK project, this project is main SDK project

• Update to Audience Network SDK for Android/iOS SDK 4.14.0

• Update to Facebook SDK for Android/iOS SDK 4.13.2 / 4.13.1

• Update to Audience Network SDK for Android/iOS SDK 4.13.0

• Update to Facebook SDK for Android/iOS SDK 4.12.0

• Editor NPE on init
• NPE when using graph api on web and hitting a url that returns a list instead of a json object.

• Update to Audience Network SDK for Android/iOS SDK 4.12.0

• Automatic activate and deactivate app event logging for Android. Calling activte app is still required for WebGL.

• Update to Facebook SDK for Android/iOS SDK 4.11.0
• isLoggedIn returns false when token is expired
• For some methods the RawResult field for webgl or webplayer has changed.

• Token issued during init on WebGL didn't contain permissions
• Cancel not being set on result for some dialogs on WebGL.
• Error not being set on result for some dialogs on WebGL.
• NPE on Android when Unity activity was killed during login flow

• Update to Audience Network SDK for Android/iOS SDK 4.11.0

• Ability to specify the graph api version though FB.GraphApiVersion

• Update to Facebook SDK for Android v4.9.0
• Update to Facebook SDK for iOS v4.9.1

• In editor cannot call login from outside OnGui

• Update to Audience Network SDK for Android v4.9.0
• Update to Audience Network SDK for iOS v4.9.1

• Moved the location of Unity plugin files, see Upgrade Guide for more information.

• FB.Mobile.RefreshCurrentAccessToken to explicitly refresh access tokens on iOS & Android
• Ability to specify JS SDK locale and debug mode in FB.Init

• Update to Android and iOS SDK 4.8.2

• Crash when Unity activity suspends during login or share via the Facebook app on Android
• File not found issue on version Unity 5.3 when no android manifest exited at plugins/android/AndroidManifest.xml

• Moved the location of Unity plugin files to under Audience Network Folder

• Updated to Android and iOS SDK 4.8.2

• Issue with Android builds where impression callbacks never get triggered when impressions occur. This affects the usage of NativeAdWillLogImpression, AdViewWillLogImpression and InterstitialAdWillLogImpression.
• Race condition that impacted compatibility with Android v4.7+ SDKs
• File not found issue on version Unity 5.3 with missing AndroidManifest.xml

• Issue where get graph requests would fail on webplayer
• Issue where custom app events would fail fail to fire

• Fixed crash due to legacy access token format for apps previously running Facebook SDK for Unity v6.0.0 or earlier
• Fixed access token is now available in the onInitCallback
• Fixed possible duplicate symbol with MakeStringCopy method on iOS

• Texture property to IGraphResult for handling some cases where Graph API redirects to an image. eg: /me/picture
• Editor login retrieves user id and permissions from provided access token

• FB.API calls are now versioned and default to Graph API v2.5
• Updated underlying iOS SDK to 4.7
• Updated underlying Android SDK to 4.7
• Editor dialog windows now have an opaque background
• The SDK download is now packaged as a zip archive. It contains the unitypackage for the Facebook SDK for Unity and now additionaly the Audience Network Unity plugin.

• Filter not being set properly for app_non_user on iOS
• FB.IsInitialized not being set to true inside FB.Init callback

• Audience Network unitypackage in the SDK zip. Refer to the Audience Network Documentation for more information.

• Unity 4 is no longer supported. Unity 5 is required
• Facebook functionality within the Unity Editor is now mocked out, we encourage you test on native platforms (iOS, Android, and Web)
• Full Screen dialogs with Web Player are no longer supported
• SDK has been namespaced to Facebook.Unity
• FB.Login has been split into FB.LoginWithReadPermissions and FB.LoginWithPublishPermissions
• FB.Feed has been replaced with FB.ShareFeed. Note: Consider using FB.ShareLink, which is optimized for mobile sharing
• FB.GetAppLink replaces FB.GetDeepLink and adds support for App Links
• FB.LogAppEvent replaces FB.AppEvents.LogEvent
• FB.LogPurchase replaces FB.AppEvents.LogPurchase
• FBResult has been replaced by typed callbacks for each method
• Callbacks are now typed, eg: IGraphResult for FB.API

• Support for Unity 5
• Support for the WebGL Build Target
• Support for Hybrid Deployment
• FB.ShareLink added
• FB.Mobile.ShareDialogMode added to specify the dialog mode for FB.ShareLink on iOS and Android
• FB.Mobile.AppInvite added support for
  App Invites
• AccessToken class added
• FB.Mobile.FetchDeferredAppLinkData added

• Updated underlying iOS SDK to 4.6
• Updated underlying Android SDK to 4.6
• Minimum Android SDK API is now v15
• Minimum iOS target version is now 7.0
• Building for Web Player no longer uses the integrated plugin

• FB.Init callback not being called
• Lost FB session across game launches
• Lost FB login screen after minimizing the app on Android
• Null Pointer Exception occurring during login on Android
• Login callback not being called when switching back to app on Android
• App freeze when logging in a second time before first login completes on Android
• FB class not found after upgrading from an old version
• Callback not being called after a game group join
• Fixed FB.GetDeepLink on Web

• ReRequesting permissions with iOS
• Android crash when UnityActivity is destroyed in background
• FB.Feed erroneously returning cancelled

• OnInitCompleted called twice on iOS in certain situations
• FB.Feed ignoring 'toId' on Android

• Fixed the iOS 8 keyboard orientation bug

• Updated underlying iOS and Android SDK versions to 3.20
• Now defaults to calling Graph API v2.2

• Support for native Share dialog in Android

• Fix issue in Android where clicking 'login', cancelling, and then clicking 'login' again would cause a crash
• Fix for "null reference" errors showing in console when displaying any FB dialogs while inside the editor
• Canvas login will now re-ask for declined permissions
• Fixed issues caused by compiler #defines on Unity 4.6 beta and 5.0 beta
• Improved p-list handling for iOS build flow

• Updated underlying Android and iOS SDKs to 3.17
• Now defaults to calling API v2.1
• Interactive console: Split login button into "login" and "get publish_permissions" to follow our own recommendations
• Interactive console: added AppRequest filter groups example

• FB.AppRequest signature changed to support filters on mobile

• Games Groups functionality
• Support for multiple app ID's selectable at runtime on iOS

• Windows Phone 8 still unsupported, but the SDK no longer causes build errors on this platform
• Login orientation no longer fixed to portrait on Android

• Underlying iOS, Android and JS SDKs are now post f8 versions. This means SDKs are initialized as using version 2.0 of the graph API.
• PublishInstall replaced with ActivateApp

• Introducing structured requests

• Fixed a minor bug where an Android function would be referenced on all platforms if you defined your own DEBUG compile flag

• The web dialog DLL is now signed by Unity. This is to support the change, new in Unity 4.5, of requiring all DLLs loaded via Security.LoadAndVerifyAssembly() to be signed

• The SDK now allows for runtime specification of an app id for Android through FB.Init

• Fixed a Windows 8 build/compilation bug
• Fixed landscape orientation bug on Android
• Fixed a problem on Android where, if no permissions were being asked for during login, it did not even ask for basic authorization
• Made it safe to use a preprocessor symbol named DEBUG

• The deep link value with which an app is started no longer gets overwritten by later, interapp calls on iOS
• The SDK treats empty login callbacks in iOS as cancelled login attempts

• You can now log into Facebook and get real data from within the Unity editor.
• Support for cold starts on iOS.

• FB.Feed has a working toId field now
• Fixed a bug where FB.AppId could be incorrect at times.
• Fixed a bug on canvas where the centering didn't work in Internet Explorer
• Fixed a bug with feed dialogs displaying incorrectly on Android tablets
• Fixed a bug where FB.Feed callbacks weren't called on Android
• Feed dialogs in iOS using the "toId" field will correctly fall back to web dialogs since native dialogs doesn't support it
• The plist appending has been fixed in ios

• Access tokens on canvas will auto refresh now
• On Android, the Facebook plugin no longer requires its own MainActivity
• Frictionless request will work for Android
• The login screen has been polished up for Android
• Upgrade underlying Android SDK to 3.6.0
• Upgrade underlying iOS SDK to 3.11.0
• We now make access token expiration times accessible
• Total size of the SDK has been trimmed by a few megabytes

• Added some additional error checking for Android key hash setup errors
• Android key hashes are accessible from the SDK as FB.Android.KeyHash
• Added canvas centering and padding

• Fixed a bug in canvas Feed dialog where a post with just an image would break it
• Fixes for Unity 4.3 on iOS and Android
• Url scheme suffixes on iOS
• Will always call the login callback, even if cancelled
• Fixed FB dialog background screen darkening not working on UI elements

• Updated interactive console sample
• Remove older-style auth flow from InteractiveConsole demo
• Updated the Android SDK to 3.5.2

• FBResult.texture fixed on iOS

• Allow programmatic control of FB.Init
• Remove older-style auth flow from InteractiveConsole demo

• FB.API() supports binary data for uploading screenshots
• App Events are now exposed via FB.AppEvents.LogEvent()
• Invoking URL exposed via FB.GetDeepLink()

• Consistent return values for api calls across Android, iOS, and canvas
• "Interactive Console" test app screen size fixed for non retina iPhones
• Added ability to disable context menu on canvas
• Debug logs now much less verbose
• We now use Unity projects to avoid resource id conflicts

• Underlying SDKs updated to 3.8 for iOS and 3.5 for Android

• Re-added Delete method broken in 4.2.1
• Mixed permissions dialog support for Android

• iOS crashed if login button hit more than once while first request was sent
• Fixed a bug where programs built with the SDK could not be debugged with visual studio
• Trimmed newline from the keyhash for Android

• FB.init no longer raises an exception if it can't connect to the internet
• Renamed 'Facebook' game object to 'UnityFacebookGameObject' to reduce chance of name conflict

• Adding JSON to the Facebook namespace, so the SDK works better with other plugins (it is now at Facebook.MiniJSON.Json)
• Adding a "cancelled" callback to the dialogs

• Calling FB.Init() on Android doesn't show the login dialog every time
• Session is properly cached on iOS
• Changing the Multi Friend Selector to only send apprequests when "Done" is clicked
• Fixed FB.Init and FB.Login callback ordering problem

• Call the dialog callback, even when a dialog is cancelled, on mobile platforms
• Clean up the code in the Interactive Console example app

• Correctly handle mixed read/write permissions on iOS
• Smartly merge changes to AndroidManifest.xml rather than simply writing them to a newly-created manifest
• Made default sharing audience "friends" rather than "none" on mobile platforms
• Improve cooperation with other plugins
• Invoke iOS native dialogs, not web dialogs, when available

• Several issues on Android, particularly one that prevented apps from requesting permissions beyond basic authorization
• Build problems preventing the Facebook SDK from working with other plugins

• Reduced package size

• Fixed problem with Graph API POST calls on iOS
• Improved default cross-domain support for Facebook Canvas

• Changed IsLoggedIn from a method to a property, to match the other session properties
• Removed fromID parameter from FB.Feed, as it's not useful in the context of Unity games

• New method FB.Canvas.Pay to invoke the payment dialog on Facebook Canvas
• Improved editor experience: tooltips for Init params

• Issue where FB.Feed failed when given certain toID, 'Link, or actionName parameters