# MPM 설치

React Native, Cordova 환경에서 설치하시는 경우, 아래 페이지에서 설치 방법을 확인해 주세요.

* [React Native 환경에서 SDK 설치](https://docs.imqa.io/imqa-guide/installation/react-native/ios)
* [Cordova 환경에서 SDK 설치](https://docs.imqa.io/imqa-guide/installation/cordova/ios)

{% hint style="warning" %}
\[지원 OS] iOS 9.0 이상 (WebView Crash 수집의 경우 iOS 11.0 이상) / Xcode 최신 버전
{% endhint %}

{% hint style="warning" %}
IMQA 프로젝트 페이지에서 iOS 프로젝트 생성 후 <mark style="color:red;">프로젝트 키 발급 받으신 이후</mark>에 설치를 진행해주세요.
{% endhint %}

## 1. 프레임워크 설치

### **프레임워크 설치**

IMQA MPM SDK는 2가지 방식으로 SDK를 설치 방법을 제공하고 있습니다. 사용하고 계신 환경에 맞춰서 설치를 진행해 주세요.

### XCFrameworks

1\. IMQA github에서 최신 SDK 파일을 다운로드 받아주세요. \
&#x20;  \[[최신 iOS MPM SDK 다운로드하기](https://github.com/onycom-imqa/IMQA-MPM-Release/releases/download/v3.27.0/IMQAMPMAgent.zip)]

2\. 위 링크를 통해 프레임워크를 다운로드 후, Targets > \[Project Name] > General > Frameworks, Libraries, and Embedded Content로 옮겨주세요.

3\. IMQAMpmAgent의 Embed Option을 Embed & Sign으로 변경해 주세요.

4\. SDK 설치는 마무리 되었습니다.

### **CocoaPods 방식**

1\. 프로젝트 Podfile에 다음과 같이 작성합니다.&#x20;

```
use_frameworks!
pod 'IMQAMPMAgent', '3.27.0'
```

2\. 터미널에서 해당 프로젝트 위치에서 pod install을 실행해 주세요.

3\. SDK 설치는 마무리 되었습니다.

## 2. 프로젝트 설정

### **Objective-C 프로젝트 설정**

Targets > \[Project Name] > Build Settings > Build Options에서 Always Embed Swift Standard Libraries를 YES로 변경해 주세요.

## 3. Objective-C 환경 초기화 코드

### AppDelegate.m Header 설정

프로젝트 AppDelegate.m에서 IMQAMpmAgent 헤더를 추가합다.

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

```
#import <IMQAMPMAgent/IMQAMPMAgent.h>
```

{% endcode %}

### AppDelegate.m 실행 코드 설정

프로젝트 AppDelegate.m에서 application: didFinishLaunchingWithOptions:에 IMQAMpmAgent를 초기화합니. 프로젝트 키는 IMQA 사이트에서 프로젝트를 생성한 후 발급 받으실 수 있습니다.

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

```swift
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    NSString* PROJECT_KEY = @"<PROJECT_KEY>"; 
    IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:PROJECT_KEY]; 
    [[IMQAMpm sharedInstance] runWithConfig:mpmConfig];
    
    return YES;
}
```

{% endcode %}

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

```swift
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    NSString* PROJECT_KEY = @"<PROJECT_KEY>"; 
    IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:PROJECT_KEY]; 
    [[IMQAMpm sharedInstance] runWithConfig:mpmConfig];
    
    return YES;
}
```

{% endcode %}

* **Objective-C 설정 방법**

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

```objectivec
NSString* imqaUrl = @"https://custom-url"; 
IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:PROJECT_KEY]; 
mpmConfig.api_url = imqaUrl;
```

{% endcode %}

* **Swift 설정 방법**

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

```swift
let imqaUrl = "https://custom-url" 
let mpmConfig = IMQAConfig(PROJECT_KEY) 
mpmConfig.api_url = imqaUrl
```

{% endcode %}

## 4. Swift 환경 초기화 코드

### AppDelegate.swift Header 설정

프로젝트 AppDelegate.swift에서 IMQAMpmAgent 헤더를 추가합니다.

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

```swift
import IMQAMPMAgent
```

{% endcode %}

### AppDelegate.swift 실행 코드 설정

프로젝트 AppDelegate.swift에서 application: didFinishLaunchingWithOptions:에 IMQAMpmAgent를 초기화 니다. 프로젝트 키는 IMQA 사이트에서 프로젝트를 생성한 후 발급 받으실 수 있습니다.

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

```swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.
        
    let PROJECT_KEY = ""
    let mpmConfig = IMQAConfig(PROJECT_KEY) 
    IMQAMpm.sharedInstance.run(config: mpmConfig)
        
    return true
}
```

{% endcode %}