Installing Omnissa Intelligence SDK for iOS

Add the Omnissa Intelligence SDK Swift Package Manager (SPM) package from this URL: https://github.com/euc-releases/ws1-intelligencesdk-sdk-ios.git

Basic Setup¶

Obtain your app ID from Omnissa Intelligence platform. Please check Omnissa Intelligence SDK Data for Apps for more information.

1. Import the Omnissa Intelligence SDK header.¶

For Objective-C apps, import the Omnissa Intelligence SDK header in your application delegate’s implementation file.

#import <WS1IntelligenceSDK/WS1Intelligence.h>

For Swift applications, place this import in your bridging-header.h file.

import WS1IntelligenceSDK

2. Enable Omnissa Intelligence SDK.¶

Call enableWithAppID in your AppDelegate’s application:didFinishLaunchingWithOptions: method.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [WS1Intelligence enableWithAppID:@"YOUR APP ID GOES HERE"];
  // other code for your app
  return YES;
}

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
  WS1Intelligence.enable(withAppID: "YOUR APP ID GOES HERE")
  // other code for your app
  return true
}

Register your app at the Omnissa Intelligence portal to get an App ID to be used in place of "YOUR APP ID GOES HERE".

Setup Automatic dSYM Uploads.¶

• Download WS1IntelligenceSDKDSYMUpload.zip and expand the zip file.
• Place the 2 files in an appropriate place in your project.
• In your Xcode application target’s “Build Phases” tab, add a new Run Script phase.

• Copy and paste the script code below into the Run Script phase, then update the path components to the directory you chose.

APP_ID="<YOUR_APP_ID>"
CREDENTIALS_FILE="${SRCROOT}/<PATH_TO_CREDENTIALS_FILE>"
source "${SRCROOT}/<PATH_TO_SCRIPT>/dsym_upload.sh"

You will need to add the included xcfilelist file in the ‘Input File Lists’ section.

$(SRCROOT)/<PATH_TO_SCRIPT>/dsym_upload.xcfilelist

When you build your Xcode application, the dSYM files for your application (and any dependent modules to which you added the Run Script) will be uploaded to Omnissa Intelligence and become available for crash symbolication.

Generate dSYM Files in Build¶

DWARF dSYM file generation can be toggled in the build options for the target. If you attempt to run the script without dSYM generation enabled, then the script will fail. Select ‘DWARF with dSYM File’ to generate the dSYM file.

Generate Credentials File from Omnissa Intelligence Platform¶

• Log into the Omnissa Intelligence Platform and click the "Service Accounts" menu.

• At the top of the page, click the "Add" button to add a new account.

• Name the service account as desired.

• Click "GENERATE CLIENT SECRET" button.

• Save the .json file to your source repository and amend the path in the Xcode Script Phase

Common dSYM Upload Issues¶

• HTTP 403 Authentication Error

This most often occurs due to a missing, expired, or incorrect credentials file. Ensure that the correct credentials file is being used. This type of authentication error can also occur if the script is obtaining an incorrect app ID. Please verify in the logs that the correct app ID is being used.

• PROTOCOL_ERROR Failure during cURL Upload

It has been observed that the default cURL version which ships with current OSX builds may exhibit a known issue when uploading dSYM files. If you experience problems during the upload phase of the script, try to upgrade to a newer version. cURL version 7.69.1 and above has been verified to resolve this problem.

HTTP/2 stream 1 was not closed cleanly: PROTOCOL_ERROR (err 1)

• The dSYM upload script causes Xcode build to fail

The script will cause a build failure by default. This behavior is possible to disable by toggling a flag inside the script itself. You may wish to change this setting if you are building without internet access, or for other similar reasons. Note that crash symbolication cannot be completed without a matching dSYM for a particular build of an app.

REQUIRE_UPLOAD_SUCCESS=${REQUIRE_UPLOAD_SUCCESS:=0}

Your app is now integrated with Omnissa Intelligence! Additional features require adding more code to your project.

Interoperability with other SDKs¶

Recommended initialization orders:

Crashlytics:¶

Omnissa Intelligence SDK should be initialized before Crashlytics

Objective-C

[WS1Intelligence enableWithAppID:@"YOUR APP ID GOES HERE"];

// Initialize Crashlytics

Swift

WS1Intelligence.enable(withAppID: "YOUR APP ID GOES HERE")

// Initialize Crashlytics

AppDynamics:¶

AppDynamics should be initialized before Omnissa Intelligence SDK

Objective-C

// Initialize AppDynamics

[WS1Intelligence enableWithAppID:@"YOUR APP ID GOES HERE"];

Swift

// Initialize Crashlytics

WS1Intelligence.enable(withAppID: "YOUR APP ID GOES HERE")

New Relic:¶

Omnissa Intelligence SDK should be initialized before New Relic

Objective-C

[WS1Intelligence enableWithAppID:@"YOUR APP ID GOES HERE"];

// Initialize New Relic

Swift

WS1Intelligence.enable(withAppID: "YOUR APP ID GOES HERE")

// Initialize New Relic