iOS

UXCam iOS SDK Installation & Quick Start

pod version

By default, we generate a schematic representation on the iOS apps to visualize in-app behavior, without recording the app’s screen. The reason we do this is to comply with Apple's guidelines. You can find more information about this here.

📘

Minimum iOS version updates:

From v3.6.11, minimum iOS version that we support is iOS 12 and Xcode 14.3.1 (that will be migrated to Xcode 15 as required by Apple)

SDK Integration

Swift Package Manager (SPM)

If the integration is being made with SPM (Swift Package Manager), please integrate UXCam with the following:

<p align="center" style="font-size: 13px">Specify the ‘Exact version’ 3.5.0 <br/> URL: https://github.com/uxcam/ios-sdk
</p>

Specify the ‘Exact version’
URL: https://github.com/uxcam/uxcam-ios-sdk

Cocoapods

📘

You’ll need to have CocoaPods installed. If you haven’t already, see this page for installation details. If this is your first pod, run pod init to create the Podfile

  • Add to the Podfile
pod 'UXCam', "~> x.x.x"
  • Run pod install in the project directory to download dependency.

Imports and Initialization


  • Import UXCam header at the top of your AppDelegate
import UXCam
#import <UXCam/UXCam.h>

Add these calls at the first line of your application:didFinishLaunchingWithOptions: method.

Your app-key is available on the dashboard


  • Create a configuration object
let configuration = UXCamConfiguration(appKey: "YourAppKey")
UXCamConfiguration *configuration = [[UXCamConfiguration alloc] initWithAppKey:@"YourAppKey"];

If you want to, you can set some options when creating the configuration object, like enabling or disabling the automatic screen tagging, advanced gestures, crash handling or network logging.

To view their definitions, check below

  • Then, start the SDK with your configuration object
UXCam.optIntoSchematicRecordings()
UXCam.start(with: configuration)
[UXCam optIntoSchematicRecordings];
[UXCam startWithConfiguration: configuration];

Available Configuration Options:

enableAutomaticScreenNameTagging
Used to disable automatic screen tagging if manual tagging of the screens will be done, default is true

enableAdvancedGestureRecognition
Control the gesture recognizers used by UXCam. Set TRUE to enable the full range of gesture recognizers (the default) or FALSE to limit it to basic gestures.

enableCrashHandling:
Crash handling is enabled by default, to let you capture all the sessions with crashes and see the corresponding crash logs.

enableNetworkLogging
Enable or disable capturing logs. If FALSE, UXCam will not capture any network logs until it is set to TRUE again.


👍

That completes the integration process.
Your session will be shown on the dashboard within a few seconds after the app goes in the background.
You can optionally use the API's for customizations such as identifying users from your database with UXCam, tagging sessions or hiding sensitive views.

🚧

Important: Based on the SDK version you will require a certain XCode version. See more.

📘

SDK Updates

To check all the information on the fixes and improvements on the latest versions of the SDK, please visit this page.


Video Tutorial


What’s Next