# 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>.

{% hint style="warning" %}
\[Supported OS] iOS 9.0 and later / latest version of Xcode
{% endhint %}

{% hint style="warning" %}
Please install Crash SDK after creating an iOS project at the IMQA project page and receiving the project key.
{% endhint %}

## &#x20;<a href="#framework" id="framework"></a>

## 1. SDK embedded framework method <a href="#framework" id="framework"></a>

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** <a href="#xcframework" id="xcframework"></a>

1\. Download the latest SDK file using the link below:\
&#x20;  **\[**[**https://github.com/onycom-imqa/IMQA-Crash-Release/releases/download/v3.9.0/IMQACrashAgent.zip**](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 <a href="#cocoapods" id="cocoapods"></a>

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 <a href="#objective-c" id="objective-c"></a>

### Setting the AppDelegate.m header <a href="#appdelegate-m" id="appdelegate-m"></a>

Add the IMQACrashAgent header to AppDelegate.m.

{% code title="AppDelegate.m" %}

```swift
#import <IMQACrashAgent/IMQACrash.h>
```

{% endcode %}

### Setting the AppDelegate.m execution code <a href="#appdelegate-m-code" id="appdelegate-m-code"></a>

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

{% code title="AppDelegate.m" %}

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

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

  return YES;
}
```

{% endcode %}

## 3. Codes for initializing the Swift environment <a href="#swift" id="swift"></a>

### \<project\_name>-bridging-header.h  <a href="#project-name" id="project-name"></a>

Add the IMQA Crash bridge header to the project.

{% code title="\<project\_name>-bridging-header.h" %}

```
#import <IMQACrashAgent/IMQACrash.h>
```

{% endcode %}

### Setting the AppDelegate.swift execution code <a href="#appdelegate-swift-code" id="appdelegate-swift-code"></a>

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

{% code title="AppDelegate.swift" %}

```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
} 
```

{% endcode %}