Documentation > Android

Download SDK

Latest Android SDK

Release Notes

October 8, 2017 (version 3.1.7, r.30107)

— Fixed deep link handling issue for devices below Android N

September 21, 2017 (version 3.1.6, r.24944)

— Android O support for Push Notifications
— Improved debugging mechanism
— Various performance enhancements

June 30, 2017 (version 3.1.4, r.22917)

— Custom sound, call to action buttons & priority for push notifications

January 30, 2017 (version 3.1.2, r.19738)

— Various performance enhancements.

December 14, 2016 (version 3.1.1, r.19081)

— Various performance enhancements.

October 20, 2016 (version 3.1.0, r.17925)

— Various performance enhancements.

August 31, 2016 (version 3.0.0, r.16949)

— Adds FCM support.
— Updates GCM handling, please note the AndroidManifest.xml requirements have changed if using GCM, please refer to the documentation.

July 18, 2016 (version 2.2.0, r.15783)

— Adds onUserLogin API to support multiple distinct user profiles per device.
— Adds getLocation API.

June 24, 2016 (version 2.1.3, r.15220)

— Sending non primitive values for profile/event properties doesn’t abort the entire push (just skips that particular property).

June 15, 2016 (version 2.1.2, r.15078)

— Updates to support google play privacy constraints

June 6, 2016 (version 2.1.1, r.14954)

— Fixes in-app notification blacklist bug

May 8, 2016 (version 2.1.0, r.14475)

— Adds support for dashboard analytics on specific InApp Notification button clicks.

April 20, 2016 (version 2.0.11, r.14202)

— Multi-value profile property handling improvements

April 6, 2016 (version 2.0.10, r.13912)

— Adds support for Segment bundled integration.
— Removes support for Segment webhook integration.
— Improved Uninstall tracking support.

March 14, 2016 (version 2.0.9, r.13514)

— Adds support for migrating from push notifications.
— Adds support for multi-value (array) user profile properties.
— Adds support for In-App Notification display frequency capping.
— Note: To support multi-value user profile properties, CleverTap.profile.getProperty(key) now returns an Object, rather than a String.

January 09, 2016 (version 2.0.5, r.12220)

— Added updateLocation API: if your application is collecting location you can pass it to CleverTap for, among other things, more fine-grained geo-targeting and segmentation purposes.
— Added support for Segment webhook/server-side integration.

December 16, 2015 (version 2.0.4)

— Fixed inapp activity exclude feature

December 09, 2015 (version 2.0.3)

— Added SyncListener to notify application code of User Profile synchronization updates
— Added ability to push custom error events: clevertap.event.pushError(String, int)
— Removed clevertap.profile.pushGraphUser(com.facebook…)
— Requires update to Android Support Library v4, revision 23.1.1

September 03, 2015 (version 2.0.1)

— We’re now CleverTap! All the existing APIs have been changed from WizRocket to CleverTap.

August 13, 2015 (version 9093)

— Added helpers to determine whether or not a GCM payload is from WizRocket, and if it is to be shown

July 13, 2015 (version 8334)

— Additional method to retrieve UTM data

July 10, 2015 (version 8309)

— New API’s for data retrieval

July 01, 2015 (version 8188)

— New API: WizRocketAPI.pushInstallReferrer("source", "medium", "campaign")

June 30, 2015 (version 8170)

— Bug fix: GCM sender ID wasn’t being read correctly from the AndroidManifest.xml. Please prepend id: to the list of GCM sender IDs

June 26, 2015 (version 8144)

— Bug fix: App Launched was being recorded from background calls to the SDK.

June 23, 2015 (version 8121)

— This version is not backward compatible with the previous versions. Please read the upgrade notes carefully.
— Auto conversion of fields in event properties (such as converting “123” to an integer) has now been removed
— Enhancement: Support for preventing in-app notification from being displayed on particular activities (such as splash activities)
— Deprecation: Enums API
— Enhancement: New Application class that simplifies integration
— Bug fix: Duplicate install referrers due to multiple receivers present in the AndroidManifest
— Bug fix: Install referrer wasn’t being attributed to the App Launched event
— Removed WizRocketAPI.activityResumed()
— Removed WizRocketAPI.activityPaused()
— Removed WizRocketAPI.initPushHandling()
— Removed WizRocketAPI.pushDeepLink()
— Removed WizRocketAPI.event.hasDeepLink()
— Removed WizRocketAPI.event.pushNotificationEvent()
— Enhancement: Instead of a proxied deep link open, it’s now direct

Upgrade Notes
— If wr.initPushHandling() was being used, remove it and add the following to your AndoidManifest.xml inside the tags: <meta-data android:name="GCM_SENDER_ID" android:value="id: 1234567890 "/>
— Replace 1234567890 with your own GCM sender ID
— Remove all calls to the aforementioned APIs which have been removed
— Add the following attribute to your tag: android:name=""
— If you’ve already got a custom Application class, call ActivityLifecycleCallback.register(this); before super.onCreate() in your custom Application class.

June 10, 2015 (version 7987)

— Bug fix: In-app notifications weren’t being rendered correctly on Moto G = Second generation

June 03, 2015 (version 7918)

— Enhancement: Support for in-app notification limits
— Enhancement: New API for setting the account ID and account token

May 21, 2015 (version 7681)

— Bug fix: Phone number handling
— Enhancement: Support for previewing in-app notifications

May 08, 2015 (version 7402)

— Feature: When a notification is received, play the default sound (optional – can be set from the dashboard)

May 01, 2015 (version 7286)

Feature: When a profile field is set, it will override the corresponding Facebook field (e.g.: When Name is set using the profile push API, it will override the Facebook name)

April 28, 2015 (version 7213)

— Bug fix: Phone numbers weren’t being sent correctly from the SDK. This caused the phone numbers not to be shown in the user’s profile

April 20, 2015 (version 7048)

— Support for pushing a Facebook user’s JSONObject (from Facebook SDK version 4 onwards)

March 25, 2015 (version 6615)

— Bug fix: Opening notifications while the app was running didn’t deliver the key/value pairs to the app.

March 13, 2015 (version 6296)

— Support for custom notification icon added

March 9, 2015 (version 6157)

— Introduced support for In-app notifications. Please refer to the integration guide to enable In-app notifications in your mobile application.

February 20, 2015 ( version 5855)

— Support for attaching an image to a push notification

February 7, 2015

  • READ_PHONE_STATE permission is now optional.