Version 4.4.1

This updates the AppStateManager to maintain a WeakReference to the current Activity, and updates the background/foreground logic to use the state of that WeakReference to determine if there is an active Activity. This makes it so that the SDK can be initialized in any Activity (ie not the launch Activity), and will properly interpret if we're in the foreground or background. Prior to this, a counter was used which was unable to handle the case where we're told than an Activity is stopping that we've never actually seen before.

Generally speaking the mParticle SDK should be initialized as early as possible, ideally in the Application#onCreate method. This update makes it possible to initialize the SDK later if absolutely necessary in your app.

Version 4.4.0

Deferred Deep Link API

Version 4.4.0 introduces a new API to serve as an integration-agnostic abstraction to query and react to deferred deep links.

Sample Usage

MParticle.getInstance().checkForDeepLink(new DeepLinkListener() {
            @Override
            public void onResult(DeepLinkResult deeplinkResult) {
                //a deep link could contain the link itself that can be parsed and reacted to.
                if (deeplinkResult.getLink() != null && deeplinkResult.getLink().contains("/example/path")) {
                    //send user to intended path
                }
                //a deep link may also contain a set of keys/values, depending on the integration
                if (deeplinkResult.getParameters() != null && deeplinkResult.getParameters().get("my_custom_key").equals("custom value")) {
                    //send user to intended path
                }
            }

            @Override
            public void onError(DeepLinkError deeplinkError) {
                //if an integration has an error, it will be surfaced via a DeepLinkError.
                Log.d("my log tag", deeplinkError.toString());
            }
});

Tune Kit

Version 4.4.0 also adds the Tune Kit, which will respond to calls to the above API. The Tune Kit does not actually wrap the Tune SDK - it only contains a small subset of customized Tune classes required to call their deep link webservice.

Updated Branch Metrics Kit

Version 4.4.0 also updates the Branch Kit to respond to the above API, so Branch Metrics-specific implementations are no longer necessary.

Updated Kits

Version 4.4.0 also updates the following kits to their latest respective SDKs:

• Kochava SDK is now 20160105
• Flurry SDK is now 6.2.0
• Branch SDK is now 1.10.5
• Adjust SDK is now 4.2.3
• Appboy SDK is now 1.12.0

Version 4.3.0

Crittercism Kit

Support for Crittercism is now live! We've added a Kit for Crittercism so you can take full advantage of every Crittercism feature, including service monitoring. Configure your Crittercism settings in the mParticle dashboard and add the com:mparticle:android-kit-crittercism artifact to your app to get started.

Version 4.2.0

Wootric Kit

Support for Wootric is now live! Wootric is a fully-native, in-app survey tool. Configure your Wootric settings in the mParticle dashboard and add the com:mparticle:android-kit-wootric artifact to your app to get started.

Programmatic API key/secret

This release also introduces several new MParticle#start() overloads to let you specify your mParticle key and secret programmatically, rather than using resource files:

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MParticle.start(this, "<API key>","<API secret>");
    }
}

Reminder

Starting with release 4.1.0, all mParticle Android artifacts are synced to Maven Central.

Version 4.1.0

This release support a new integration: SimpleReach, contains a few bug fixes, and adds some new unit tests.

• Support MPEvent objects with the logScreen API. This is primarily to allow for custom flags on screen view events, which is required by SimpleReach.
• Bugfix: CommerceEvents now create and maintain their own reference to a list of Product objects. This fixes a bug whereby clearing the Cart changes CommerceEvents that have yet to be logged.

Maven Central

As of version 4.1.0, mParticle deploys signed artifacts to Maven Central! You can remove your references to our maven.mparticle.com server.

Version 4.0.0 - Initial Open Source Release

This is the initial open source release of the mParticle kit implementations, and it's tied to release 4.0.0 of the core mParticle SDK. Highlights of this release from the previous 3.x release are:

• Support for Localytics
• Support for Flurry
• Support for choosing which kits you'd like to include in your app, or none at all
• Removal of the previously-deprecated MPProduct class and related APIs, check out our shiny new enhanced eCommerce APIs here: http://docs.mparticle.com/#ecommerce