Documentation > iOS

Download SDK

Latest iOS SDK

Starting with v3.0.0, the SDK adds support for App Extensions and watchOS apps. Starting with v3.1.4, the SDK adds support for tvOS.

  • For just the basic SDK functionality in your main app download here and add to your project.

  • If you also wish to capture custom events from your App Extension target(s) download here and add to your App Extension target(s). Do this in addition to adding the basic SDK to your main app target.

If your main app is also a watchOS Host, and you wish to capture custom events from your watchOS app:

For tvOS, download here and add to your project.

Release details: v3.1.6, Oct 13, 2017
Integration Guide

– Starting with v3.0.0, the Framework supports iOS versions 8 and above, prior SDK versions support iOS versions 7 and above
– CleverTap iOS SDK size: When you build a library in iOS, you must include a build for every architecture supported by iOS. This leads to a perceived large file size. However, at app compilation time Xcode will only build in the required architecture, leading to a vastly smaller compiled file size. The size overhead is only about 150 KB per target after compilation

Release Notes

Oct 13, 2017 (version 3.1.6, r.30106)

— Fixed App Extension deployment target

Sep 19, 2017 (version 3.1.5, r.24897)

— Adds support for iOS 11/ Xcode 9
— Improved debugging mechanism
— Adds support for handling foreground notification

June 29, 2017 (version 3.1.4, r.22904)

— Adds API to record Screen Views.
— Adds tvOS support.
— Adds modulemap for Swift import.

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

— Various performance enhancements.

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

— Various performance enhancements.

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

— Various performance enhancements.

September 23, 2016 (version 3.0.0, r.17417)

— iOS 10/Xcode 8 release, supports iOS versions 8+
— Adds support for Rich Push Notifications, App Extensions and watchOS apps.

August 17, 2016 (version 2.2.2, r.16539)

— Fixes Xcode 8 -> Xcode 7 archiving issue

July 20, 2016 (version 2.2.1, r.15867)

— Patches NSDate handling in onUserLogin.

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

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

June 28, 2016 (version 2.1.2, r.15285)

— Fixes handling of deep links embedded in push notifications on app launch.

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

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

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

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

April 5, 2016 (version 2.0.10, r.13902)

— Adds support for Segment bundled integration.
— Removes support for Segment webhook integration.
— Fixes rare thread deadlock issue.

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

— 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.

February 08, 2016 (version 2.0.7, r.12774)

— Handles obscure exception regarding UIViewController detection.

February 02, 2016 (version 2.0.6, r.12666)

— Fixes extremely rare issue relating to CTTelephonyNetworkInfo

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

— Added setLocation 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 09, 2015 (version 2.0.4)

— Dropped support for iOS 6 – only support 7.0 and above.
— Added optional autoIntegrate method to automatically handle device token registration and push notification/url referrer tracking, and set up a singleton instance of the CleverTap class. This is accomplished by proxying the AppDelegate and “inserting” a CleverTap AppDelegate behind the AppDelegate. The proxy will first call the AppDelegate and then call the CleverTap AppDelegate.
— Added notification of application code of User Profile synchronization via CleverTapSyncDelegate and/or NSNotification broadcast mechanism.
— Added ability to record custom error events: recordErrorWithMessage:(NSString *)message andErrorCode:(int)code.

September 28, 2015 (version 2.0.2)

— Added iOS 9/Xcode 7 bitcode support.

September 03, 2015 (version 2.0.1)

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

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 8185)

— New API: [WizRocket pushInstallReferrerSource:medium:campaign]
— Deprecated [WizRocket notifyViewLoaded:]. View controller tracking is done automatically now

June 03, 2015 (version 7916)

— Enhancement: Support for in-app notification limits
— Enhancement: Better performance in terms of network
— Enhancement: New API for setting the account ID and account token

May 21, 2015 (version 7698)

— Enhancement: Support for previewing in-app notifications

May 07, 2015 (version 7385)

— Bug fix: Xcode 6 removed armv7s from the standard architectures. We’ve added it explicitly back. This caused build failures for apps supporting armv7s

May 01, 2015 (version 7287)

— 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 7223)

— 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

March 13, 2015

— In-app notification support added – no code changes required. Update the framework and test.

February 17, 2015

— SDK now works with Xcode 5 and above. It has been built without the Link Frameworks Automatically build setting.