DESK auto-instrumentation for iOS

The instrumentation steps for iOS can also be performed for instrumenting tvOS apps.

To set up user experience monitoring on your iOS apps, you can use either CocoaPods or Carthage. You can also follow the manual approach, although we recommend that you use either CocoaPods or Carthage.

Independent of the selected approach, you must add the generated application and environment IDs to your project’s Info.plist file so that your iOS mobile app can send monitoring data to your DESK monitoring environment.

Set up OneAgent with CocoaPods

From the navigation menu, select Applications.
Select your mobile application.
Select the Browse [...] menu button at the top-right corner, and then select Edit.
From the settings menu, select Instrumentation.
Select Apple iOS.
Select the CocoaPods tab and insert DESK as a library dependency within the CocoaPods Podfile specification. This can be done by either using DESK as a dynamic framework or as a static library.

Use DESK as a framework Use DESK as a static library

You can set up DESK as a dynamic framework by adding the DESK pod to your Podfile. Ensure that you uncomment the #use_frameworks! line.

Example:

  # Uncomment this line to define a global platform for your project
  # platform :ios, '9.0'
  target 'DemoApp' do
    # Uncomment this line if you're using Swift or want to use dynamic frameworks
    use_frameworks!
    # Pods for DemoApp
    pod 'DESK', '~> 8.181'
  end

You can set up DESK as a static library by adding the pod DESK/lib to your Podfile. Ensure to comment out the use_frameworks! line.

Example:

  # Uncomment this line to define a global platform for your project
  # platform :ios, '7.0'
  target 'DemoApp' do
    # Uncomment this line if you're using Swift or want to use dynamic frameworks
    # use_frameworks!
    # Pods for DemoApp
    pod 'DESK/lib', '~> 8.181'
  end

Note:

For iOS 8+ apps, use the framework.
For iOS 6+ apps, use the static library.
If you’re using Hockeyapp with DESK, include DESK as a framework to avoid symbol clashes. See the framework example provided earlier in this topic.

For further information about Podfiles, see the Podfile Syntax Reference.

CocoaPods automatically adds DESK to your iOS project during the build process.

Set up OneAgent with Carthage

Add the following to your Carthfile: binary "https://files.desk.com/mobileagent/carthage/desk.json"

Set up OneAgent manually

From the navigation menu, select Applications.
Select your mobile application.
Select the Browse [...] menu button at the top-right corner, and then select Edit.
From the settings menu, select Instrumentation.
Select Apple iOS.
Select the Developer tab and follow the instructions provided on that page.