Android SDK Changelog

Android SDK Changelog#

See also

Need help upgrading? Check out the Android SDK Upgrade Guide for migration steps, deprecated API details, and best practices to ensure a smooth transition.

4.3.4#

Release Date: Apr 21, 2025

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

Fixes/Enhancements:

  • Migrated PendingActionsSendingService to PendingActionsWorker using WorkManager for Android 12+ background execution compliance.

  • Replaced deprecated RaveSkinUnzippingService and UnzippingAsyncTask with modern WorkManager-based RaveSkinUnzipWorker.

  • Updated RSSkinDownloadResultBroadcastReceiver and RaveNetworkStateCallback to enqueue background jobs via WorkManager.

  • Updated skin download handling to support Android 10+ scoped storage and Android 12+ background execution policies.

  • Added RaveCompat.registerNetworkCallback(...) RaveUtils method to register a network callback compatible with API 23+.

Deprecations:

  • Removed legacy service declarations for PendingActionsSendingService and RaveSkinUnzippingService from AndroidManifest.xml.

  • Removed RaveScheduler and ScheduledTask as they are no longer needed.

  • Deprecated AsyncTask usage for background work.

4.3.3#

Release Date: Apr 9, 2025

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

API/Dependency Updates:

  • Added dependencies:

    • androidx.credentials:credentials:1.5.0

    • androidx.credentials:credentials-play-services-auth:1.5.0

    • com.google.android.libraries.identity.googleid:googleid:1.1.1

  • Updated com.google.android.gms:play-services-auth to 21.3.0

Fixes/Enhancements:

  • Add support for modern Google Sign-In using Android Credential Manager API.

4.3.2#

Release Date: Mar 11, 2025

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

API/Dependency Updates:

  • Facebook SDK updated to version 18.0.2.

Fixes/Enhancements:

  • Fixed Welcome toast displays showing twice during signing.

  • Adjust RaveSocialVolatileRaveId Unity Binding to use volatile ID listener instead.

4.3.1#

Release Date: Feb 21, 2025

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

API/Dependency Updates:

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

  • Facebook SDK updated to version 18.0.1.

Fixes/Enhancements:

  • Restored previous RaveLoginStatusListener behavior during SDK initialization to ensure compatibility with existing integrations. The login listener will now trigger only once during initialization, regardless of network conditions.

  • Facebook Access Token Handling:

    • Added automatic reauthorization for expired data access within a 90-day window.

    • Improved error handling to detect and refresh expired tokens when necessary.

  • Optimized API Requests:

    • Removed redundant Facebook-related data and headers to optimize API requests.

    • Improved error handling during Facebook friend syncing and SDK initialization.

Deprecations:

  • Deprecated the ERROR and NONE states in RaveLoginStatus. These will be removed in a future version.

  • Deprecated the exception parameter in RaveLoginStatusListener.onLoginStatusChanged listener. This parameter is no longer used and will always be null. Method signature will be updated in future versions.

  • Removed deprecated preference APIs and migrated to AndroidX Preference Library (1.2.1) for better compatibility.

4.3.0#

Release Date: Jan 21, 2025

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

API/Dependency Updates:

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

Fixes/Enhancements:

  • Introduced a new offline mode for the SDK to improve resilience under poor network conditions.

  • Adjusted HTTP connection and read timeouts to enhance performance and responsiveness.

  • Enhanced NetworkUtils to provide more detailed network capability checks, including validated internet detection.

  • Improved network connection handling for more reliable online/offline detection.

  • Fixed typos and improved logging in network-related classes for better error reporting.

  • Added server error parsing support to handle new API error formats.

  • Enhanced user data synchronization and cache management mechanisms.

  • Disabled Facebook Advertiser ID collection in the Demo Application.

Deprecations:

  • Deprecated NetworkAvailableBroadcastReceiver and replaced it with a modern network callback API for improved reliability.

4.2.13#

Release Date: Nov 2, 2024

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

API/Dependency Updates:

  • Added support for specifying an asset path as image for upload.

Fixes/Enhancements:

  • Fixed an issue where contacts source was incorrectly mapped during Facebook/Google contacts sync.

Deprecations:

  • Remove method RaveContacts.setPhoneBookAutoUpdate, which was deprecated in favor of simply using the phonebook plugin.

4.2.12#

Release Date: Oct 24, 2024

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

API/Dependency Updates:

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

Fixes/Enhancements:

  • Extended the custom SSL trust manager to all Android versions, ensuring compatibility for newer devices (including Amazon) that may not have ISRG Root X1 in their system trust store.

4.2.11#

Release Date: Sep 27, 2024

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

Fixes/Enhancements:

  • Alter the VERBOSE log level to have lower priority than DEBUG to align with other Rave SDKs.

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

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

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#

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#

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#

Changes:

  • Changed assets for social buttons to match updated branding requirements

3.4.5#

Changes:

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

3.4.4#

Changes:

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

3.4.3#

Changes:

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

  • Improvements to CAL

3.4.2#

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

  • 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.5#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.2.5-102.zip

3.1.2#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_3.1.2-78.zip

2.10.6#

Download: https://downloads.ravesocial.co/sdk/RaveSocial_2.10.6-38.zip

2.10.1#

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

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

Contents