Installing Crash SDK

If you add IMQA Crash to an iOS project, you can check the performance issues of the application, which occur in the app developed with Objective-C or Swift, in various viewpoints.

The latest update guide will be updated at https://github.com/onycom-imqa/IMQA-Crash-Release.

[Supported OS] iOS 9.0 and later / latest version of Xcode

Please install Crash SDK after creating an iOS project at the IMQA project page and receiving the project key.

1. SDK embedded framework method

You can install the IMQA Crash SDK using one of the following two methods. You can select your preferred installation method according to your environment.

XCFrameworks

1. Download the latest SDK file using the link below: [https://github.com/onycom-imqa/IMQA-Crash-Release/releases/download/v3.9.0/IMQACrashAgent.zip]

2. Extract the downloaded file and drag and move the IMQACrashAgent.framework file to Targets > [Project Name] > General > Frameworks, Libraries, and Embedded Content.

3. Now, SDK installation is complete.

CocoaPods method

1. Enter the following statement in Podfile: (Please add it to the source part.)

pod 'IMQACrashAgent', '~> 3.24.1'

2. Run “pod install” at the project directory in the terminal.

3. Now, the SDK installation is complete.

2. Codes for initializing the Objective-C environment

Setting the AppDelegate.m header

Add the IMQACrashAgent header to AppDelegate.m.

AppDelegate.m

#import <IMQACrashAgent/IMQACrash.h>

Setting the AppDelegate.m execution code

Initialize IMQACrashAgent in application: didFinishLaunchingWithOptions: at AppDelegate.m. didFinishLaunchingWithOptions: You can receive PROJECT_KEY after creating a project on the IMQA website.

AppDelegate.m

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  NSString* PROJECT_KEY = @"<PROJECT_KEY>";
  IMQACrashConfiguration* crashConfig = [[IMQACrashConfiguration alloc] initWithApiKey:PROJECT_KEY];
  [IMQACrash startWithConfiguration:crashConfig];

  return YES;
}

3. Codes for initializing the Swift environment

<project_name>-bridging-header.h

Add the IMQA Crash bridge header to the project.

<project_name>-bridging-header.h

#import <IMQACrashAgent/IMQACrash.h>

Setting the AppDelegate.swift execution code

Initialize IMQMCrashAgent in application: didFinishLaunchingWithOptions: at AppDelegate.swift. You can receive PROJECT_KEY after creating a project on the IMQA website.

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    let PROJECT_KEY = ""
    let crashConfig = IMQACrashConfiguration(PROJECT_KEY)
    IMQACrash.start(with: crashConfig)

    return true
}