Android SDK Changelog#

4.2.10#

Release Date: Sep 16, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.10.zip

Fixes/Enhancements:

  • Fixed an issue that prevented users from logging out on older installations after an SDK upgrade.

4.2.9#

Release Date: Sep 9, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.9.zip

Fixes/Enhancements:

  • Added support for layout gravity in XML Scene.

  • Fixed layout processing issues with LinearViewLayoutStrategy.

  • Assigned unique identifiers to Rave UI views by prefixing view IDs with scene names in each view’s contentDescription, enhancing support for test automation.

4.2.8#

Release Date: May 16, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.8.zip

Fixes/Enhancements:

  • Returns the original exception on the RaveConflictResolutionPolicy::onConnectConflict callback function in case it is already an instance of RaveException.

  • Fixed an issue where image assets where not being loaded correctly when the device language was set to Arabic.

4.2.7#

Release Date: May 2, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.7.zip

API/Dependency Updates:

  • Updated Facebook SDK to version 17.0.0.

  • Updated Android Gradle Plugin (AGP) to version 8.4.0.

Fixes/Enhancements:

  • Resolved issues occurring during post-plugin registration when Cross-App-Login is disabled server-side.

  • Fixed formatting issues in the HTTP client User-Agent header for Arabic locales.

4.2.6#

Release Date: Apr 24, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.6.zip

Fixes/Enhancements:

  • Resolved threading issues for RaveTwoFactorAuthenticationPolicy and RaveTwoFactorAuthenticationURLHandler callbacks.

4.2.5#

Release Date: Mar 23, 2024

Download: https://downloads.ravesocial.co/sdk/Android/4.2.5.zip

Fixes/Enhancements:

  • Add check for Cross App Login (CAL) availability to clear CAL data if feature is disabled server-side.

  • Remove the no longer used DeviceIdMigrationAction from the Rave Login System state-machine.

4.2.4#

Release Date: Mar 21, 2024

Download: https://downloads.ravesocial.co/sdk/4.2.4/android.zip

Fixes/Enhancements:

  • Added a custom trust manager to explicitly include the ISRG Root X1 certificate within the SDK’s trust store, addressing connectivity issues on Android devices running versions older than 7 due to recent updates to Rave API’s SSL certificate chain of trust.

  • Updated the network utilities with a new approach to network connectivity checks, enhancing support for newer devices/platforms, including Samsung Instant Play.

API/Dependency Updates:

  • Updated Android Gradle Plugin (AGP) to version 8.3.1.

Deprecations:

  • Replaced co.ravesocial.xmlscene.ui.view.OnLayoutChangeListenerCompatible usages with View.OnLayoutChangeListener.

  • Mark RaveSocial.getVolatileRaveId as deprecated in favor of RaveSocial#setVolatileRaveIdListener.

4.2.3#

Release Date: Dec 5, 2023

Download: https://downloads.ravesocial.co/sdk/4.2.3/android.zip

Fixes/Enhancements:

  • Resolved a bug where invoking RaveUser.isTwoFactorEnabled() could lead to an application crash under specific conditions.

  • Fixed a double counting issue of failed password attempts that contributed to premature account lockout. This affected only scenarios involving user merges when AutoGuestLogin was enabled.

  • Updated Android Gradle Plugin (AGP) to version 8.1.4.

  • Improved server error parsing mechanism to handle API errors that include arguments.

  • Corrected the assignment of parent view LayoutParams in the PSize Attribute.

4.2.2#

Release Date: Nov 14, 2023

Download: https://downloads.ravesocial.co/sdk/4.2.2/android.zip

Fixes/Enhancements:

  • Resolved threading issues for RaveUserUpdateListener callbacks.

4.2.1#

Release Date: Oct 30, 2023

Download: https://downloads.ravesocial.co/sdk/4.2.1/android.zip

New:

  • Increased Android SDK min version to 23 to match BigFish SDK minimum SDK version

Fixes/Enhancements:

  • Resolved data migration issues that previously hindered SDK initialization.

  • Fix threading handling for RaveLoginStatusListener callbacks.

4.2.0#

Release Date: Oct 5, 2023

Download: https://downloads.ravesocial.co/sdk/4.2.0/android.zip

New:

  • Asynchronous Processing: The SDK now handles all operations, including initialization, asynchronously. This improvement eliminates UI thread blocking.

  • Thread-Safe Callbacks: All SDK public method callbacks now execute within the same thread as the original calls, ensuring thread safety and predictable behavior.

Fixes/Enhancements:

  • Reintegrated token storage v3 migration during token retrieval of the Connect Plugins.

Deprecations:

As of v2.8.0, the following settings have been deprecated and have now been removed from the SDK:

Deprecated/Removed Setting

Replacement Setting

RaveSettings.RaveAndroidUseDialogOverlay

RaveSettings.Android.DialogOverlay

RaveSettings.RaveApplicationID

RaveSettings.General.ApplicationID

RaveSettings.RaveServerURL

RaveSettings.General.ServerURL

RaveSettings.RaveAutoSyncInterval

RaveSettings.General.AutoSyncInterval

RaveSettings.RaveAutoGuestLogin

RaveSettings.General.AutoGuestLogin

RaveSettings.RaveAutoCrossAppLogin

RaveSettings.General.AutoCrossAppLogin

RaveSettings.RaveLogLevel

RaveSettings.General.LogLevel

RaveSettings.RaveAllowForceDisconnect

RaveSettings.General.AllowForceDisconnect

RaveSettings.RaveAutoInstallConfigUpdates

RaveSettings.General.AutoInstallConfigUpdates

RaveSettings.RaveNetworkTimeout

RaveSettings.General.NetworkTimeout

RaveSettings.RaveConfigUpdateInterval

RaveSettings.General.ConfigUpdateInterval

RaveSettings.RaveThirdPartySource

RaveSettings.General.ThirdPartySource

RaveSettings.RaveDefaultResourcesPath

RaveSettings.General.DefaultResourcesPath

RaveSettings.RaveAutoSendGiftOnGrantedRequest

RaveSettings.General.AutoSendGiftOnGrantedRequest

RaveSettings.RaveSceneServerHost

RaveSettings.General.SceneServerHost

RaveSettings.RaveFBApplicationId

RaveSettings.Facebook.ApplicationId

RaveSettings.RaveFBReadPermissions

RaveSettings.Facebook.ReadPermissions

RaveSettings.RaveFBAlwaysUseLiveContacts

RaveSettings.Facebook.AlwaysLiveContacts

RaveSettings.RaveIOSBundleName

RaveSettings.IOS.BundleName

RaveSettings.RaveInitGameCenterOnStartUp

RaveSettings.IOS.InitGameCenterOnStartUp

RaveSettings.RaveIOSUseIDFAForDeviceID

RaveSettings.IOS.IDFAForDeviceID

4.1.0#

Release Date: Aug 9, 2023

Download: https://downloads.ravesocial.co/sdk/4.1.0/android.zip

New:

  • Android API 34 support added.

  • Gradle Version upgraded to 8.x.

  • User password change feature introduced.

Fixes/Enhancements:

  • Demo testing scene issues fixed; deprecated content removed.

  • Removed Facebook publishing (Rave’s API) in favor of Facebook Share API.

API/Dependency Updates:

  • Replaced contacts v2 API with standard contacts API.

  • Added support for standard and HOTP email confirmation in Demo.

  • Complete removal of Twitter integration.

Deprecations:

  • Deprecated RaveFriends and RaveFollowers convenience classes.

  • Deprecated user blocking methods.

  • Deprecated RaveSocial’s FileCripter.

4.0.0#

Release Date: Mar 9, 2023

Download: https://downloads.ravesocial.co/sdk/4.0.0/android.zip

Changes:

  • Increased Android SDK min version to 19.

  • Deprecated util classes from core SDK.

  • Cleanup manifest permissions.

  • Removed the following deprecated settings:

    • RaveSettings.General.DefaultNewUserName

    • RaveSettings.RaveFBAutoUpdateContactsOnConnect (replaced by RaveSettings.General.AutoSyncFriends)

    • RaveSettings.General.PhoneContactsUpdateInterval (replaced by RaveSettings.General.ContactsUpdateInterval)

    • RaveSettings.Google.ContactsUpdateInterval (replaced by RaveSettings.General.ContactsUpdateInterval)

    • RaveSettings.Facebook.ContactsUpdateInterval (replaced by RaveSettings.General.ContactsUpdateInterval)

Breaking Changes:

  • Dropped support on Google+, if you are still using Google+ please consider upgrading to the new Google plugin.

3.13.2#

Release Date: Jan 24, 2023

Download: https://downloads.ravesocial.co/sdk/3.13.2/android.zip

Changes:

  • Fix an issue with 2FA data that was preventing SDK to initialize

3.13.1#

Release Date: Jan 10, 2023

Download: https://downloads.ravesocial.co/sdk/3.13.1/android.zip

Changes:

  • Uses encrypted storage for plugin token data on the Android SDK.

  • Remove the dependency on android-priority-jobqueue library in favor of WorkManager, the official deferred task library for Android.

3.13.0#

Release Date: Nov 17, 2022

Download: https://downloads.ravesocial.co/sdk/3.13.0/android.zip

Changes:

  • Adds setting to disable default toast implementations.

  • DEPRECATED: Friends and Followers. Auto-sync reverted back to Rave contacts.

  • DEPRECATED: Clans and Groups. Feature will be removed in a future version.

3.12.0#

Changes:

  • Add support for two-factor authentication on all Rave accounts.

  • Various bug fixes

3.11.1#

Changes:

  • Add Friends and Followers feature.

  • Advanced querying functionality for large friend groups.

  • Syncs friends to multiple lists defined in rave settings on social network connection.

3.10.1#

Changes:

  • Add Clans feature.

  • Full feature clan support. Create, update, search for clans.

  • Set visibility to public or private

  • Invite friends to your clan

  • Different level of permissions for users to allow for basic members, moderators, etc.

  • Moderation feature set to manage your clan.

3.9.18#

Release Date: Mar 21, 2024

Download: https://downloads.ravesocial.co/sdk/3.9.18/android.zip

Fixes/Enhancements:

  • Added a custom trust manager to explicitly include the ISRG Root X1 certificate within the SDK’s trust store, addressing connectivity issues on Android devices running versions older than 7 due to recent updates to Rave API’s SSL certificate chain of trust.

API/Dependency Updates:

  • Updated Android Gradle Plugin (AGP) to version 8.3.1.

3.9.17#

Release Date: March 7, 2023

Download: https://downloads.ravesocial.co/sdk/3.9.17/android.zip

Fixes/Enhancements:

  • Updated the network utilities with a new approach to network connectivity checks, enhancing support for newer devices/platforms, including Samsung Instant Play.

  • Remove ACCESS_NETWORK_STATE permission requirement.

  • Mark RaveSocial.getVolatileRaveId as deprecated in favor of RaveSocial#setVolatileRaveIdListener.

3.9.16#

Release Date: Dec 5, 2023

Download: https://downloads.ravesocial.co/sdk/3.9.16/android.zip

New:

  • Increased Android SDK min version to 23 to match BigFish SDK minimum SDK version

Fixes/Enhancements:

  • Corrected the assignment of parent view LayoutParams in the PSize Attribute.

  • Fix threading issues with displayPendingExceptions

3.9.15#

Release Date: Oct 5, 2023

Download: https://downloads.ravesocial.co/sdk/3.9.15/android.zip

Changes:

  • Asynchronous Processing: The SDK now handles all operations, including initialization, asynchronously. This improvement eliminates UI thread blocking. (Back-ported from 4.2.0)

  • Thread-Safe Callbacks: All SDK public method callbacks now execute within the same thread as the original calls, ensuring thread safety and predictable behavior. (Back-ported from 4.2.0)

3.9.14#

Release Date: Jul 18, 2023

Download: https://downloads.ravesocial.co/sdk/3.9.14/android.zip

Changes:

  • SDK Support for Android API 34

  • SDK Support for Facebook SDK to 15.1.0

3.9.13#

Changes:

  • Fixed a bug where the SDK was getting stuck on initialization on specific devices

3.9.12#

Changes:

  • Hotfix to support new versions of the Facebook v12+ SDK. Removes old AppLink calls that have been removed, modifies share functionality to match the recommended behavior.

3.9.7#

Changes:

  • Update ADK Observer behavior to match the behavior seen on iOS SDK.

3.9.6#

Changes:

  • Update Facebook plugins to support Facebook v6.0+ Plugins containing breaking changes.

  • Various software updates and bug fixes.

3.9.4#

Changes:

  • Added RaveSettings.Google.ReadPermissions setting for Google Sign-In to specify what permissions are requested.

  • Various bug fixes and cleaning.

3.9.3#

Changes:

  • Add support for Facebook version 5.4.1

3.9.2#

Changes:

  • Various bug fixes

3.9.1#

Changes:

  • Added support for versioned and timed leaderboards.

  • Added leaderboard request builder.

  • Wrapped call to save contacts in async task to lower ANR rates. (Zendesk: https://ravehelp.zendesk.com/agent/tickets/481)

  • Added support for an app identifier in Cross App Login data.

  • Added support for Android X

3.8.1#

Changes:

  • Add social plugin for google sign in.

3.7.1#

Changes:

  • Add authentication via email and password.

  • Add support for custom metadata storage for a user.

3.6.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.6.1-516_BF.zip

Changes:

  • Switched from Android ID to Google Advertising ID for Device ID

  • Removed dangerous permission requirement for CAL

  • Removed dangerous permission requirement for bundle download

  • Added support for welcome toast on Android 8

  • Demo ADK dialog bug fix

3.5.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.5.1-477_BF.zip

Changes:

  • Added App Data Key API that returns an ADK when given a UUID. This is ADK lookup for given Rave ID

  • Added App Data Key API that returns ADKs for a friends list

  • Switched to Android Archive (AAR) format

  • Upgraded to Facebook SDK 4.25.0 (Requires Minimum Android SDK 15)

  • Upgraded to Google Play Services 11.0.4

  • Added support for Android Studio 2.3.3

  • Fixed a bug where in some cases the list of game contacts wasn’t being populated correctly

  • Fixed the bug where downloading resource bundles uploaded via Rave portal wasn’t getting downloaded correctly on Android. Remote UI update functionality now works correctly

  • Removed unnecessary usage of GET_ACCOUNTS permission on Android

  • Fixed a bug where SDK initialization was failing when skipPermissionChecks was set to true

  • Add better support for modal dialogs that work well when rotated

3.4.6#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.4.6-419_BF.zip

Changes:

  • Changed assets for social buttons to match updated branding requirements

3.4.5#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.4.5-403_BF.zip

Changes:

  • Fixed an issue with the time out on logging out of Rave with no internet connection

3.4.4#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.4.4-400_BF.zip

Changes:

  • Fixed issue of device ID not being properly created when CrossAppLogin feature is disabled

3.4.3#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.4.3-396_BF.zip

Changes:

  • Added volatileRaveId to RaveSocial (see Android, iOS, and Unity)

  • Improvements to CAL

3.4.2#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.4.2-378_BF.zip

Changes:

  • FBSDK 4.12.0 included in release package

  • Various bug fixes

3.4.1#

DO NOT USE: 3.4.1 SDK Shipped with an issue that required an update. Please use 3.4.2 SDK instead.

Changes:

  • Added app data key management feature

  • Added support for authenticated user merging

  • Calling loginWith, opening RaveLoginScene, or opening RaveSignUpEmailScene while already authenticated will cause an exception

  • Setting up the Big Fish Connect SDK to be able to use the Google Play Services SDK and all its functionalities

  • Added a config option to enable sending session data to Facebook automatically, so that Facebook Ads work correctly for apps that plan to use them

  • Added ability for game to be able to access GoogleApiClientAdded (to enable games to take advantage of the Google Video Recording feature)

  • Added a fix for something potentially causing a memory leak (Zendesk: https://ravehelp.zendesk.com/agent/tickets/182)

  • Added a fix for connectTo() API that was reported (Zendesk: https://ravehelp.zendesk.com/agent/tickets/185)

  • Added the change requested for a confusing message players get when signing into Facebook (Zendesk: https://ravehelp.zendesk.com/agent/tickets/138)

  • Fixed issue where Facebook disassociation button was causing a logout to occur instead of Facebook disassociation (https://ravehelp.zendesk.com/agent/tickets/156)

  • Various bug fixes

3.2.7#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.2.7-348_BF.zip

Changes:

3.2.6#

DO NOT USE: 3.2.6 SDK shipped with an issue that required an update. Please use 3.2.7 or 3.4.2 SDK instead.

Changes:

  • Disabled asserts in SDK and dependencies

  • Fixed 302 auth loop for Facebook login

3.2.1#

DO NOT USE: 3.2.1 SDK shipped with an issue that required an update. Please use 3.2.7 or 3.4.2 SDK instead.

Changes:

  • Removed class RSRestStubEmulator

  • Changed the authentication flow for apps that target API 23

3.1.3#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.1.3-260_BF.zip

Changes:

  • Adds a new bundle without Google support to use with bitcode enabled buidls; Google SDK doesn’t support bitcode.

3.1.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.1.1-235_BF.zip

Changes:

  • Updated Facebook SDK to 4.6

3.0.2#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.0.2-209_BF.zip

Changes:

  • Added FB and Google Client IDs to back-end data for BI

3.0.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.0.1-193_BF.zip

Changes:

  • Refactored handling of service providers

  • Non-authenticated players can now have a Contacts list.

  • Big Fish authentication and player profile changes to accommodate addition of non-authed Contacts list.

  • Updated Find Friends screen to accommodate non-authed contacts.

  • Added ability to create custom game profile UI, and code samples for best practices.

  • Added new strings for Find Friends screen to accomodate non-authed contacts, these require translations.

2.10.7#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.10.7-167_BF.zip

Changes:

  • Various bug fixes

2.10.5#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.10.5-86_BF.zip

Changes:

  • A number of minor bug fixes

2.10.3#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.10.3_BF.zip

Changes:

  • Adds support for custom newsletter on account creation

  • Bug fixes to COPPA floor age, truncation due to localization, Canada’s Anti Spam law support, etc.

  • Removed support for (deprecated) Facebook’s API V1.0

2.10.2#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.10.2_BF.zip

Changes:

  • Implemented new scene flow including new signup callbacks

  • Other minor fixes

2.9.0#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.9.0_BF.zip

Changes:

  • Localization updates

  • Enabled user merging by default

  • Added proguard support

  • Other minor bug fixes

2.8.4#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.8.4_BF.zip

Changes:

  • Localization updates

  • Separated Twitter SDK to allow for optional inclusion

2.8.3#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.8.3_BF.zip

Changes:

  • Resized some views for localization

2.8.2#

Download:

Changes:

  • Updated Facebook and Google to latest SDKs

  • Added complete set of Unity bindings

  • Added transparent user token validation

  • fixed an issue with save button not displaying disabled state correctly

  • Other minor bug fixes

2.8.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.8.1.zip

Changes:

  • Display name no longer requires email to enter

  • Profile picture can be set after display name is set

  • Supports Android 2.3.3+

  • Fixed some rotation issues

2.8.0#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.8.0_BF.zip

Changes:

  • Implemented new Login Scene

  • Implemented Force Login Scene variant

  • Implemented new Account Info Scene

  • Implemented new Find Friends Scene

  • Updated Toast style

  • Changed to native alert dialog style

  • Updated Progress style

  • Added Landscape and Portrait layouts

  • Added Autorotation support

  • Added support for personalizing anonymous accounts (adding personal information without securely logging in)

  • Added ability to disconnect previously connected social network accounts, resolved the issue with accounts being orphaned in some disconnect scenarios

  • Added support for staging and reverting account changes in the profile screen

  • Added full hMID integration to create Big Fish ID accounts for all users playing BFG games

  • Added inferred login support from Facebook (this enables games that previously integrated Facebook to do seamless game updates with Rave SDK such that old players don’t need to log into Facebook again on game update). This includes support for auto-login across Big Fish apps in both online and offline state.

  • Updated Google SDKs

  • Updated Facebook SDKs

  • Added support for Facebook Graph API v2.0

  • Added support for keeping track of Big Fish friends from Facebook with Graph API 2.0 configured apps

  • Added account merging support for anonymous users

  • Added support for listing merged identities

  • Improved built-in experience callbacks

  • Added personalized and authenticated user state

  • Added new UI scaling mode

  • Added a Profile screen configuration to be able to remotely add a section of the screen that asks the player for their date of birth. Potentially needed for COPPA compliance.

  • Added support for Android v5

  • Changed the privacy policy based on feedback from Big Fish legal

  • Added ability to specify whether player account attributes such as display name and profile picture are specified on a per game basis, or if they’re publisher-wide settings

  • Known Issues: The configuration of the Profile page that includes the section to ask player for their date of birth today doesn’t work with 2.3.3 and lower Android versions

2.6.5#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.6.5_BF_With_Unity_Bindings.zip

Changes:

  • Fixed the forgot password interface

2.6.4#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.6.4_BF.zip

Changes:

  • Fixed gift type key mapping

  • Fixed a leaderboard sort issue affecting some leaderboards

  • Fixed a contacts filtering issue affecting some contacts

2.6.3#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.6.3_BF.zip

Changes:

  • Changed default iDFA option to off

  • Verified all upgrade cases from previous versions

  • Verified IDFA to generated ID transition cases

  • Verified anonymous user Rave ID preservation cases

  • Verified facebook and Google auth decline callback cases

  • Hardened several places in code where crashes had been reported via Flurry

  • Updated CAL tool to add notification if it detects it is out of date (please use this)

2.6.1#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.6.1_BF.zip

Changes:

  • Fixed a network performance issue

2.6.0#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.6.0_BF.zip

Changes:

  • Added ascending leaderboard support

  • Fixed some small UI issues

2.5.2#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.5.2_Unity_Bindings.zip

Changes:

  • Fixed a scene pack resource issue

2.5.0#

Changes:

  • Added new user acquisition APIs w/gifting enhancements

  • Added new external contact APIs

  • Reduced size of scene pack

  • Added per-server CAL

  • Fixed a localization issue with button text

  • Added generated device ID support

  • Updated CAL tools