React Native





Unreal Engine



SDK Installation
AndroidiOSCocosCordovaFlutterIonicReact NativeUnityUnreal Engine 4XamarinSDK Release Changelogs
SDK Conceptual
SDK API reference
SDK Cookbooks
SDK Integrations

iOS SDK Installation


There are three ways to integrate Smartlook into your app:

1. Swift Package Manager

Add this Swift Package –

If you experience "Found an unexpected Mach-O header code: 0x72613c2" error when uploading an archived app to the App Store, please follow this guide.

2. Direct integration

Smartlook can also be added directly to the app project by downloading our latest Smartlook iOS SDK (1.7.10), unzipping the file, and adding Smartlook.xcframework to the Xcode project.

3. Cocoapods

In projects that use Cocoapods, Smartlook can be installed by adding the respective pod into Podfile:

pod Smartlook

Please note that up-to-date Cocopoads version is necessary to build and run applications with Smartlook on computers with Apple Silicon (M1 and later) chips.

Setup and Start Recording

To setup and start recording with Smartlook, Smartlook must be imported and configured, e.g., in AppDelegate and its didFinishLaunching method:

import Smartlook
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
let smartlookConfig = Smartlook.SetupConfiguration(key: "API_KEY")
Smartlook.setupAndStartRecording(configuration: smartlookConfig)
// other initialization stuff
return true

To setup Smartlook, the unique project API key is needed. It can be found in the mobile project settings in the Smartlook Dashboard.

Smartlook now starts recording the app. The recordings will appear in the Smartlook player shortly.

When starting in debug mode, your iOS app may stop for a few seconds after this it will start and print a warning when Smartlook is included.
It is caused by Xcode's Main Thread Checker diagnostics. Read more about why it happens and how to handle it in this Technical Note.

SDK will upload sessions only on WiFi. When uploading on mobile connections is requested, too, it must be enabled in the project settings in the dashboard. More details about the recording process can be found in the Conceptual documentation.

Supported versions

Currently the minimal supported iOS version is 10.

Further Steps

All Smartlook SDK methods are documented in the Smartlook API reference.

Some advanced use-case and troubleshooting case-studies are described in the Cookbooks section of this documentation.

Issues and bugs can be reported in the issue tracker.

Concepts underlying the Smartlook functionality are described in the Conceptual documentation: