IMQA GUIDE
IMQA자주 묻는 질문개발자 포럼Release Note
KOR
KOR
  • Introduction
    • IMQA 바로가기
    • IMQA 알아보기
    • IMQA 문의하기
  • Installation
    • IMQA 시작하기
    • IMQA 설치 매뉴얼
    • Android
      • 지원 환경
      • 설치 전 확인 사항
      • Sample 앱 테스트
      • MPM 설치
      • MPM 설정
      • Crash 설치
      • Crash 설정
      • 릴리즈 노트
    • iOS
      • 지원 환경
      • 설치 전 확인 사항
      • Sample 앱 테스트
      • MPM 설치
      • MPM 설정
      • Crash 설치
      • Crash 설정
      • 릴리즈 노트
    • React Native
      • Android
      • iOS
      • React Native Library 설정
    • Cordova
      • Android
      • iOS
    • Morpheus
      • Android
      • iOS
    • W Hybrid
    • Web (WPM)
  • User Guide
    • MPM 사용하기
      • 프로젝트 리스트
      • 성능 대시보드
      • A/B 대시보드
      • 화면 성능 분석
      • 성능 상세 분석
      • 행동분석
      • 지역 분석
      • 통계
      • 보고서
      • 알림
      • 관리
    • Crash 사용하기
      • 프로젝트 리스트
      • 대시보드
      • 에러 상세
      • 에러 검색
      • 통계
      • 설정
    • WPM 사용하기
      • 시작하기
      • 프로젝트 리스트
      • 성능 대시보드
      • 페이지 성능 분석
      • 성능 상세 분석
      • 행동분석 역추적
      • 통계
      • 보고서
      • 알림
      • 관리
    • WCrash 사용하기
      • 시작하기
      • 프로젝트 리스트
      • 대시보드
      • 에러 상세
      • 에러 검색
      • 통계
    • IMQA 데이터 읽기
      • MPM - 1. 실시간 모니터링
      • MPM - 2. 전체 모니터링(통계)
      • MPM - 3. 웹뷰 타임라인
      • WPM 데이터 읽기
      • Crash 데이터 읽기
      • WCrash 데이터 읽기
    • IMQA 활용하기
  • FAQ
    • 자주 묻는 질문
      • IMQA 서비스 소개
      • 타 서비스와의 차이점
      • 회원 가입・관리
      • Crash・MPM 설치하기
      • 프로젝트 설정・관리
      • Crash 사용 관련
      • MPM 사용 관련
      • 알림 설정
      • 데이터 이해하기
      • 데이터 수집 / 확인 / 사용량
      • 개인 정보・보안
      • 기타 문의
Powered by GitBook
On this page
  • 1. 공통
  • MPM Module install
  • 2. 프로젝트 설정
  • 3. 상세 설정
  • 수집 주기 설정
  • 네트워크 수집 설정
  • 수집 데이터 확인
  • 4. 네트워크 수집 (NSURLSession 또는 URLSession 을 사용하는 경우)
  • 5. dSYM 설정
  1. Installation
  2. React Native

iOS

React Native 환경에서 SDK 설치

이 문서는 React Native 환경에서 IMQA SDK를 적용하는 방법을 제공합니다.

1. 공통

MPM Module install

React native 환경에서 IMQA SDK 적용을 위해 아래 명령어를 통해 패키지를 설치해주어야 합니다.

npm 명령어 사용시
 npm install imqa-react-native-agent --save
 npx pod-install
yarn 명령어 사용시
 yarn add imqa-react-native-agent
 npx pod-install

2. 프로젝트 설정

1. ImqaSettings.h 파일을 생성 후 아래 내용을 입력합니다.

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN
@interface ImqaSetting : NSObject
- (void) IMQASetting;
@end
NS_ASSUME_NONNULL_END

2. ImqaSettings.m 파일을 생성 후 아래 내용을 입력합니다.

#import "ImqaSetting.h"
#import <IMQAMPMAgent/IMQAMPMAgent.h>

@implementation ImqaSetting
- (void) IMQASetting{
  
  if (([NSUserDefaults.standardUserDefaults objectForKey:@"serverUrl"] == nil)) {
    [NSUserDefaults.standardUserDefaults setObject:@"https://collector.imqa.io" forKey: @"serverUrl"];
  }
  
  if (([NSUserDefaults.standardUserDefaults objectForKey:@"projectKey"] == nil)) {
    [NSUserDefaults.standardUserDefaults setObject:@"" forKey: @"projectKey"];
  }
  
  NSString* PROJECT_KEY = [NSUserDefaults.standardUserDefaults objectForKey:@"projectKey"];
  NSString* API_URL = [NSUserDefaults.standardUserDefaults objectForKey:@"serverUrl"];
  NSLog(@"[IMQA] setAgentConfig : %@ %@", PROJECT_KEY, API_URL);
  IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:PROJECT_KEY];
  mpmConfig.api_url = API_URL;
  [[IMQAMpm sharedInstance] runWithConfig:mpmConfig];
}
@end

3. AppDelegate.h 파일에서 아래 1개를 임포트하세요.

#import "ImqaSetting.h"

4. AppDelegate.m 파일에서 - (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions 함수 가장 상단에 아래 코드를 추가합니다.

ImqaSetting* is = [ImqaSetting new];
[is IMQASetting];

3. 상세 설정

iOS MPM 프레임워크에는 다양한 설정을 지원하고 있습니다.

수집 주기 설정

IMQA MPM 프레임워크가 데이터를 저장하는 주기와 수집하는 주기에 대해서 초 단위로 설정할 수 있습니다.

  • Objective-C 설정 방법

ImqaSettings.m
IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"];
mpmConfig.dump_interval = 10; // 성능 데이터 덤프를 뜨는 주기 (sec)
mpmConfig.save_interval = 60; // 성능 데이터를 수집서버로 전송하는 주기 (sec)

네트워크 수집 설정

IMQA MPM 프레임워크에서는 네트워크 수집에 대해서 수집 여부를 설정 할 수 있습니다. 또한, 특정 URL 에 대한 수집을 무시할 수 있는 기능을 제공하고 있어, 보안이 필요한 URL은 무시 할 수 있습니다.

  • Objective-C 설정 방법

ImqaSettings.m
IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"];
mpmConfig.useNetworkCollect = YES; // YES: 수집함, NO: 수집안함
mpmConfig.ignoreUrl = @[@"https://url1.com", @"http://url.com"]; // 특정 URL 무시 Array

수집 데이터 확인

IMQA MPM 프레임워크에서 수집하고 있는 데이터가 궁금한 경우 자체 옵션을 통해서 데이터를 Console 로 확인 하실 수 있습니다.

  • Objective-C 설정 방법

ImqaSettings.m
IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"];
mpmConfig.downloadDumpData = YES;

4. 네트워크 수집 (NSURLSession 또는 URLSession 을 사용하는 경우)

NSURLSession 또는 URLSession을 이용하여 네트워크를 통신하는 경우에 일부 상황에서 네트워크 수집을 위해 설정이 필요합니다.

  • Objective-C 설정 방법

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration ephemeralSessionConfiguration]; // or default
configuration.protocolClasses = [[IMQAMpm sharedInstance] imqaURLSessionProtocol];
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration];

5. dSYM 설정

Last updated 1 year ago

iOS의 Symbolication(기호화) 적용이 된 앱의 경우, dSYM 설정을 통해 클래스 명과 함수 명을 확인할 수 있습니다. ‘'을 참고하세요.

iOS > MPM 설정 > dSYM 설정