{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/developers/client-sdks/android/upgrade-to-version-6/","result":{"data":{"pageMetadata":{"title":"Upgrade to Version 6","path":"/developers/client-sdks/android/upgrade-to-version-6/","sourceCode":null,"metadataParent":{"title":"Android","path":"/developers/client-sdks/android/","sourceCode":"https://github.com/mParticle/mparticle-android-sdk","hasVersionPicker":null,"metadataChildren":[{"title":"Initialization","path":"/developers/client-sdks/android/initialization/","order":2,"label":null},{"title":"Configuration","path":"/developers/client-sdks/android/configuration/","order":3,"label":null},{"title":"Network Security Configuration","path":"/developers/client-sdks/android/network-security-configuration/","order":3,"label":null},{"title":"Event Tracking","path":"/developers/client-sdks/android/event-tracking/","order":4,"label":null},{"title":"User Attributes","path":"/developers/client-sdks/android/users/","order":5,"label":null},{"title":"IDSync","path":"/developers/client-sdks/android/idsync/","order":6,"label":null},{"title":"Screen Events","path":"/developers/client-sdks/android/screen-tracking/","order":7,"label":null},{"title":"Commerce Events","path":"/developers/client-sdks/android/commerce-tracking/","order":8,"label":null},{"title":"Location Tracking","path":"/developers/client-sdks/android/location/","order":9,"label":null},{"title":"Media","path":"/developers/client-sdks/android/media/","order":10,"label":null},{"title":"Kits","path":"/developers/client-sdks/android/kits/","order":11,"label":null},{"title":"Application State and Session Management","path":"/developers/client-sdks/android/session-management/","order":12,"label":null},{"title":"Data Privacy Controls","path":"/developers/client-sdks/android/data-privacy-controls/","order":13,"label":null},{"title":"Error Tracking","path":"/developers/client-sdks/android/error-and-exception-tracking/","order":14,"label":null},{"title":"Opt Out","path":"/developers/client-sdks/android/opt-out/","order":14,"label":null},{"title":"Push Notifications","path":"/developers/client-sdks/android/push-notifications/","order":15,"label":null},{"title":"WebView Integration","path":"/developers/client-sdks/android/webview-integration/","order":16,"label":null},{"title":"Logger","path":"/developers/client-sdks/android/logger/","order":17,"label":null},{"title":"Preventing Blocked HTTP Traffic with CNAME","path":"/developers/client-sdks/android/prevent-blocked-http-traffic/","order":18,"label":null},{"title":"Workspace Switching","path":"/developers/client-sdks/android/workspace-switching-and-multi-instance-support/","order":18,"label":null},{"title":"Linting Data Plans","path":"/developers/client-sdks/android/linting/","order":19,"label":null},{"title":"Troubleshooting the Android SDK","path":"/developers/client-sdks/android/troubleshooting/","order":20,"label":null},{"title":"API Reference","path":"/developers/client-sdks/android/api-reference/","order":21,"label":null},{"title":"Upgrade to Version 5","path":"/developers/client-sdks/android/upgrade-to-version-5/","order":22,"label":null},{"title":"Upgrade to Version 6","path":"/developers/client-sdks/android/upgrade-to-version-6/","order":23,"label":null},{"title":null,"path":"/developers/client-sdks/android/changelog/","order":null,"label":null}],"metadataParent":{"title":"Client SDKs","path":"/developers/client-sdks/","metadataChildren":[{"title":"Alexa","path":"/developers/client-sdks/alexa/","order":1,"label":null},{"title":"AMP","path":"/developers/client-sdks/amp/","order":null,"label":null},{"title":"Android","path":"/developers/client-sdks/android/","order":null,"label":null},{"title":"Cordova","path":"/developers/client-sdks/cordova/","order":null,"label":null},{"title":"Direct Url Routing","path":"/developers/client-sdks/direct-url-routing/","order":null,"label":null},{"title":"Flutter","path":"/developers/client-sdks/flutter/","order":null,"label":null},{"title":"iOS","path":"/developers/client-sdks/ios/","order":null,"label":null},{"title":"React Native","path":"/developers/client-sdks/react-native/","order":null,"label":null},{"title":"Roku","path":"/developers/client-sdks/roku/","order":null,"label":null},{"title":"Unity","path":"/developers/client-sdks/unity/","order":null,"label":null},{"title":"Web","path":"/developers/client-sdks/web/","order":null,"label":null},{"title":"Xamarin","path":"/developers/client-sdks/xamarin/","order":null,"label":null},{"title":"Xbox","path":"/developers/client-sdks/uwp/","order":null,"label":null}],"metadataParent":{"title":"Developers","path":"/developers/","metadataChildren":[{"title":"API Credential Management","path":"/developers/credential-management/","order":null,"label":null},{"title":"API References","path":"/developers/apis/","order":null,"label":null},{"title":"Client SDKs","path":"/developers/client-sdks/","order":null,"label":null},{"title":"Guides","path":"/developers/guides/","order":null,"label":null},{"title":"Media SDKs","path":"/developers/media-sdks/","order":null,"label":null},{"title":"Quickstart","path":"/developers/quickstart/","order":null,"label":null},{"title":"Server SDKs","path":"/developers/server-sdks/","order":null,"label":null},{"title":"The Developer's Guided Journey to mParticle","path":"/developers/developersjourney/","order":null,"label":null},{"title":"Tools","path":"/developers/tools/","order":null,"label":null}],"metadataParent":null}}}},"markdownRemark":{"html":"

\n \n \n \n \n \n \n \n Migrating from versions < 6.0.0

\n

This guide covers the breaking changes introduced in mParticle Android SDK 6.0.0 and how to migrate your code to the new APIs.

\n
\n

\n \n \n \n \n \n \n \n Removed isAndroidIdDisabled() / androidIdDisabled(boolean)

\n

The isAndroidIdDisabled() method on MParticle and MParticleOptions, and the androidIdDisabled(boolean) builder method on MParticleOptions.Builder, have been removed. These were replaced by inverted equivalents with clearer semantics.

\n

Replace isAndroidIdDisabled() with isAndroidIdEnabled() and invert the logic:

\n

Java:

\n
// Before\nif (MParticle.isAndroidIdDisabled()) { ... }\nif (options.isAndroidIdDisabled()) { ... }\n\n// After\nif (!MParticle.isAndroidIdEnabled()) { ... }\nif (!options.isAndroidIdEnabled()) { ... }
\n

Kotlin:

\n
// Before\nif (MParticle.isAndroidIdDisabled()) { ... }\nif (options.isAndroidIdDisabled()) { ... }\n\n// After\nif (!MParticle.isAndroidIdEnabled()) { ... }\nif (!options.isAndroidIdEnabled()) { ... }
\n

Replace androidIdDisabled(boolean) with androidIdEnabled(boolean) and invert the value:

\n

Java:

\n
// Before\nMParticleOptions.builder(context)\n    .androidIdDisabled(true)\n    .build();\n\n// After\nMParticleOptions.builder(context)\n    .androidIdEnabled(false)\n    .build();
\n

Kotlin:

\n
// Before\nMParticleOptions.builder(context)\n    .androidIdDisabled(true)\n    .build()\n\n// After\nMParticleOptions.builder(context)\n    .androidIdEnabled(false)\n    .build()
\n
\n

\n \n \n \n \n \n \n \n Removed isAutoTrackingEnabled()

\n

The isAutoTrackingEnabled() method on MParticle has been removed. This method always returned false and automatic screen tracking via activity lifecycle hooks has been removed.

\n

Remove any calls to isAutoTrackingEnabled(). If your code depends on this value, note that it was always false — no screen tracking was being performed automatically.

\n

Java:

\n
// Before\nif (MParticle.getInstance().isAutoTrackingEnabled()) {\n    // this block was never executed\n}\n\n// After\n// Remove the call entirely
\n

Kotlin:

\n
// Before\nif (MParticle.getInstance()?.isAutoTrackingEnabled == true) {\n    // this block was never executed\n}\n\n// After\n// Remove the call entirely
\n
\n

\n \n \n \n \n \n \n \n Removed isProviderActive(int)

\n

The isProviderActive(int) method on MParticle has been removed. It has been renamed to isKitActive(int).

\n

Replace isProviderActive(serviceProviderId) with isKitActive(serviceProviderId):

\n

Java:

\n
// Before\nboolean active = MParticle.getInstance().isProviderActive(MParticle.ServiceProviders.APPBOY);\n\n// After\nboolean active = MParticle.getInstance().isKitActive(MParticle.ServiceProviders.APPBOY);
\n

Kotlin:

\n
// Before\nval active = MParticle.getInstance()?.isProviderActive(MParticle.ServiceProviders.APPBOY)\n\n// After\nval active = MParticle.getInstance()?.isKitActive(MParticle.ServiceProviders.APPBOY)
\n
\n

\n \n \n \n \n \n \n \n Removed MPEvent.setInfo() / getInfo() / Builder.info()

\n

The setInfo(Map), getInfo(), and Builder.info(Map) methods on MPEvent have been removed. They have been renamed to setCustomAttributes(), getCustomAttributes(), and Builder.customAttributes().

\n

Replace usages with the new method names:

\n

Java:

\n
// Before\nMPEvent event = new MPEvent.Builder(\"Event Name\", MParticle.EventType.Other)\n    .info(attributes)\n    .build();\nMap<String, String> info = event.getInfo();\nevent.setInfo(attributes);\n\n// After\nMPEvent event = new MPEvent.Builder(\"Event Name\", MParticle.EventType.Other)\n    .customAttributes(attributes)\n    .build();\nMap<String, ?> customAttributes = event.getCustomAttributes();\nevent.setCustomAttributes(attributes);
\n

Kotlin:

\n
// Before\nval event = MPEvent.Builder(\"Event Name\", MParticle.EventType.Other)\n    .info(attributes)\n    .build()\nval info = event.getInfo()\nevent.setInfo(attributes)\n\n// After\nval event = MPEvent.Builder(\"Event Name\", MParticle.EventType.Other)\n    .customAttributes(attributes)\n    .build()\nval customAttributes = event.getCustomAttributes()\nevent.setCustomAttributes(attributes)
\n
\n

\n \n \n \n \n \n \n \n Removed UserAttributeListener

\n

The com.mparticle.UserAttributeListener interface has been removed. It has been replaced by com.mparticle.TypedUserAttributeListener.

\n

The key difference is that onUserAttributesReceived now receives Map<String, Any?> instead of Map<String, String?> for user attribute singles, allowing typed values (numbers, booleans) to be preserved rather than stringified. Additionally, the mpid parameter is non-nullable (Long instead of Long?).

\n

Java:

\n
// Before\nuser.getUserAttributes(new UserAttributeListener() {\n    @Override\n    public void onUserAttributesReceived(\n        @Nullable Map<String, String> userAttributes,\n        @Nullable Map<String, List<String>> userAttributeLists,\n        @Nullable Long mpid\n    ) {\n        // handle attributes\n    }\n});\n\n// After\nuser.getUserAttributes(new TypedUserAttributeListener() {\n    @Override\n    public void onUserAttributesReceived(\n        @NonNull Map<String, ?> userAttributes,\n        @NonNull Map<String, ? extends List<String>> userAttributeLists,\n        long mpid\n    ) {\n        // handle attributes — values may be String, Number, or null\n    }\n});
\n

Kotlin:

\n
// Before\nuser.getUserAttributes(UserAttributeListener { userAttributes, userAttributeLists, mpid ->\n    // userAttributes: Map<String, String?>?\n})\n\n// After\nuser.getUserAttributes(object : TypedUserAttributeListener {\n    override fun onUserAttributesReceived(\n        userAttributes: Map<String, Any?>,\n        userAttributeLists: Map<String, List<String?>?>,\n        mpid: Long\n    ) {\n        // userAttributes values may be String, Number, Boolean, or null\n    }\n})
\n

Note: numeric and boolean attribute values are no longer automatically converted to strings. If you need string values, call .toString() on each value manually.

\n
\n

\n \n \n \n \n \n \n \n Removed UserAliasHandler / IdentityApiRequest.Builder.userAliasHandler()

\n

The com.mparticle.identity.UserAliasHandler interface and the IdentityApiRequest.Builder.userAliasHandler() method have been removed. Use a success listener on the BaseIdentityTask returned by identity API calls instead.

\n

Java:

\n
// Before\nIdentityApiRequest request = IdentityApiRequest.withEmptyUser()\n    .email(\"user@example.com\")\n    .userAliasHandler(new UserAliasHandler() {\n        @Override\n        public void onUserAlias(MParticleUser previousUser, MParticleUser newUser) {\n            // copy attributes from previousUser to newUser\n        }\n    })\n    .build();\nMParticle.getInstance().Identity().login(request);\n\n// After\nIdentityApiRequest request = IdentityApiRequest.withEmptyUser()\n    .email(\"user@example.com\")\n    .build();\nMParticle.getInstance().Identity().login(request)\n    .addSuccessListener(new TaskSuccessListener() {\n        @Override\n        public void onSuccess(IdentityApiResult result) {\n            MParticleUser newUser = result.getUser();\n            MParticleUser previousUser = result.getPreviousUser();\n            if (previousUser != null) {\n                // copy attributes from previousUser to newUser\n            }\n        }\n    });
\n

Kotlin:

\n
// Before\nval request = IdentityApiRequest.withEmptyUser()\n    .email(\"user@example.com\")\n    .userAliasHandler { previousUser, newUser ->\n        // copy attributes from previousUser to newUser\n    }\n    .build()\nMParticle.getInstance()?.Identity()?.login(request)\n\n// After\nval request = IdentityApiRequest.withEmptyUser()\n    .email(\"user@example.com\")\n    .build()\nMParticle.getInstance()?.Identity()?.login(request)\n    ?.addSuccessListener { result ->\n        val newUser = result.user\n        val previousUser = result.previousUser\n        // copy attributes from previousUser to newUser\n    }
\n
\n

\n \n \n \n \n \n \n \n Removed ConsentState.Builder.setCCPAConsent() / removeCCPAConsent()

\n

The setCCPAConsent(CCPAConsent) and removeCCPAConsent() methods on ConsentState.Builder have been removed. They have been renamed to setCCPAConsentState(CCPAConsent) and removeCCPAConsentState().

\n

Java:

\n
// Before\nConsentState state = ConsentState.builder()\n    .setCCPAConsent(CCPAConsent.builder(true).build())\n    .build();\n\nConsentState.builder().removeCCPAConsent();\n\n// After\nConsentState state = ConsentState.builder()\n    .setCCPAConsentState(CCPAConsent.builder(true).build())\n    .build();\n\nConsentState.builder().removeCCPAConsentState();
\n

Kotlin:

\n
// Before\nval state = ConsentState.builder()\n    .setCCPAConsent(CCPAConsent.builder(true).build())\n    .build()\n\nConsentState.builder().removeCCPAConsent()\n\n// After\nval state = ConsentState.builder()\n    .setCCPAConsentState(CCPAConsent.builder(true).build())\n    .build()\n\nConsentState.builder().removeCCPAConsentState()
\n
\n

\n \n \n \n \n \n \n \n Rokt API moved from android-core to rokt-kit

\n

Rokt APIs are now owned by the Rokt kit module. Usage remains the same (MParticle.getInstance().Rokt()); update imports to use the kit package types.

\n

Kotlin:

\n
// Before\nimport com.mparticle.Rokt\n\nval rokt = MParticle.getInstance()?.Rokt()\n\n// After\nimport com.mparticle.kits.Rokt\n\nval rokt = MParticle.getInstance()?.Rokt()
\n

Java:

\n
// Before\ncom.mparticle.Rokt rokt = MParticle.getInstance().Rokt();\n\n// After\ncom.mparticle.kits.Rokt rokt = MParticle.getInstance().Rokt();
\n
\n

\n \n \n \n \n \n \n \n Rokt wrapper types replaced with native Rokt SDK types

\n

The following mParticle wrapper types were removed:

\n\n

Use native Rokt SDK types instead:

\n\n

Kotlin:

\n
// Before\nval callback = object : MpRoktEventCallback { /* ... */ }\nval config = com.mparticle.rokt.RoktConfig.Builder().build()\n\n// After\nval callback = object : com.rokt.roktsdk.Rokt.RoktCallback { /* ... */ }\nval config = com.rokt.roktsdk.RoktConfig.Builder().build()
\n

See Upgrade to Version 5 for the earlier Android SDK migration.

","frontmatter":{"title":"Upgrade to Version 6","order":23,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"August 7, 2026"}}},"pageContext":{"slug":"/developers/client-sdks/android/upgrade-to-version-6/"}},"staticQueryHashes":["2950460867"]}