iOS UIKit quick start
Target Platforms
This quick start guide shows you how to get Heap setup in an iOS, iPadOS, or Catalyst application that primarily uses the UIKit framework for creating the user interface.
After completing the setup process, you'll be able to:
- Take full advantage of the Heap API to track custom events and manage user identity.
- Automatically capture a wide variety of user interactions with no additional code required.
If you're using Heap Classic and thinking of switching to our latest offerings, check out the full breakdown of the differences between our SDKs here.
Before you begin
This guide assumes you are using Xcode with either Swift Package Manager or CocoaPods to manage external dependencies. If you're not currently using either, you can learn more at Apple's Package Manager documentation and CocoaPods.org.
Add the SDK to your application with Swift Package Manager
Unified SDK
These instructions install our new Unified SDK which includes product analytics powered by Heap and digital experience analytics powered by Contentsquare.
- In Xcode, open the package manager however you're accustomed to. The most direct path is navigating to File ā Add Packagesā¦ in the menu.
- Paste https://github.com/ContentSquare/apple-sdk.git into the Search or Enter Package URL text field at the top right corner of the dialog.
- Select a Dependency Rule. We recommend Up to Next Major Version.
- Click Add Package.
- In the next dialog, confirm that the checkbox next to Contentsquare is checked and that it will be added to your app target.
- Click Add Package.
- After the dialog closes, you can optionally confirm that HeapIOSAutocapture, HeapSwiftCore, and SwiftProtobuf now appear in the Package Dependencies section of the Project Navigator.
- Before continuing, build your app target to help Swift resolve the modules.
Add the SDK to your application with CocoaPods
- Add
pod 'ContentsquareSDK', '~> 0.1'
to your app target in yourPodfile
. - Run
pod install
within your project directory. - Before continuing, build your app target to help Swift resolve the modules.
Start the SDK
To enable Heap and start automatically tracking supported user events, register the autocapture SDK and call startRecording
. This can go anywhere in your app, but we recommend doing this in the application(_:,didFinishLaunchingWithOptions:)
method of your appās UIApplicationDelegate
object to make sure tracking starts, no matter how your app is opened.
import HeapSwiftCore
import HeapIOSAutocapture
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Replace YOUR_APP_ID with your Heap app ID of the environment you wish to send data to.
Heap.shared.startRecording("YOUR_APP_ID")
Heap.iOSAutocaptureSource.register(isDefault: true)
return true
}
}
Once tracking has started, youāre able to take full advantage of Heapās API to identify users, track custom events, and more. Heap will also automatically start tracking a wide range of user interactions, view controller changes, and app version changes without any additional code.
What next?
To find out how to take full advantage of the Heap API to enhance your data capture, check out our mobile tracking guides here.
Updated 2 months ago