1. Download the latest version of Ubertesters SDK for iOS

• Download ubertesters.sdk.ios.zip and unzip it
• Add UbertestersSDK.framework to your project

2. Go to ‘Build Phases’ -> ‘Link Binary With Libraries’ to add the following frameworks

1. UIKit.framework
2. CoreGraphics.framework
3. CoreTelephony.framework
4. SystemConfiguration.framework
5. CoreLocation.framework
6. AdSupport.framework
7. OpenGLES.framework
8. QuartzCore.framework
9. libsqlite3.0.tbd

3. Set up Xcode project

• In your Xcode right click on.plist file and select Open As -> Source Code.
• Add the following lines of code.

<key>ubertesters_organization_token</key>
    <string>{your_ubertesters_organization_sdk_token}</string>
<key>LSApplicationQueriesSchemes</key>
<array>
   <string>ubertesters</string>
</array>
<key>NSPhotoLibraryUsageDescription</key>
<string>To use photos as issue attachments.</string>

• Open https://dashboard.ubertesters.com/projects and select your project, go to SDK Integration.

  

• Copy “Ubertesters Organization SDK Token” from SDK Integration page and replace {your_ubertesters_organization_sdk_token} in .plist file with it.

4. Modify your Application Delegate file:

• Import Ubertesters to your project *-Bridging-Header.h file. Here is an article that describes what the “Bridging Header” is.

  #import <UbertestersSDK/Ubertesters.h>

• Initialize Ubertesters SDK in your app delegate file.

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
      	Ubertesters.shared().initialize()
      	return true
  }
  

Additional Setup

Initialize Ubertesters with different options

It is possible to initialize Ubertesters in 2 ways:

1. Using initializer with the default parameters. When you are using the initializer with the default parameters – UbertestersActivationModeWidget for activation mode and UbertestersLockingModeDisableUbertesters for locking mode:

   Ubertesters.shared().initialize()

2. Using customized initializer

   Ubertesters.shared().initialize(with: UbertestersOptions(UbertestersActivationModeWidget.rawValue | UbertestersActivationModeWidget.rawValue))

Ubertesters options

The customized initializer is used with the Ubertesters SDK options which determine the behavior of Ubertesters widget (with the help of which you call the bug reporting screen) and the behavior of the Ubertesters app when the build/app is not available in Ubertesters system. According to their functions, all the options can be divided in two groups: Activation mode options and Locking mode options.

You can use the following options for the customized initializer:

Locking mode options:

NB: Ubertesters SDK is used for beta-testing. Please make sure you’ve removed Ubertesters SDK before publishing your app to App Store.

NB: Make sure you are using Apple LLVN compiler 4.2 and greater. Go to BuildSettings of your target and find BuildOptions. There will be row Compiler for C/C++/Objective-C.

Ubertesters SDK API methods

API methods allow the developers to call additional methods and customize our SDK according to their needs.

Remote Logging

To perform remote logging you can use the UTLog method. UT log is a function with a text and a log level. Remote logging allows you to send an important system event information to Ubertesters server dedicating to storing and archiving this data. You can check the sent logs in your Ubertesters account in Activity > Session > Session Tracking

UTLog methods:

To add UTLog, please use the following line:

Ubertesters.shared().utLog("text message", with: UTLogLevelInfo)

API methods used with UbertestersActivationModeManual

These methods allow to specify the behavior of Ubertesters bug submission screen in case Manual mode is used.

Disable Crash Handler

Example:

Ubertesters.shared().disableCrashHandler()