콘텐츠로 이동

빠른 시작

이 문서는 iOS/tvOS/macOS RUM SDK의 최단 연동 경로를 제공하여, 최소한의 단계로 검증 가능한 데이터 보고를 완료할 수 있도록 돕습니다.

앱은 Agent 자동 연동과 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.

사전 준비

SDK 1.6.8+의 최소 배포 버전은 iOS 15, tvOS 15, macOS 12입니다. 기존 프로젝트를 업그레이드하는 경우 먼저 1.6.8 업그레이드 요구 사항을 확인하세요.

시작하기 전에 다음 준비를 완료하세요.

  1. 실제 사용자 모니터링(RUM)에서 iOS, tvOS 또는 macOS 앱을 생성하고 RUM App ID를 확보합니다.
  2. 보고 주소와 인증 방식을 확인합니다.
  3. 로컬 환경 배포: datakitUrl 준비
  4. 공용 네트워크 DataWay: datawayUrl과 clientToken 준비
  5. 프로젝트에 SDK 설치가 완료되었는지 확인합니다. Swift Package Manager 사용을 권장하며 CocoaPods, Carthage도 호환됩니다.

연동 단계

  1. 프로젝트에 GuanceSDK를 설치합니다.
  2. 앱 시작 시 FTSDKConfig를 초기화합니다.
  3. FTRumConfig를 초기화하고 View, Action, Resource, 크래시 및 프리즈 수집을 활성화합니다.
  4. 디버그 로그를 활성화하고 앱을 실행하여 페이지 열기 또는 네트워크 요청을 한 번 발생시킵니다.
  5. 콘솔과 Guance 플랫폼에서 데이터가 정상적으로 보고되었는지 확인합니다.

SDK 설치

설치 방법은 앱 연동을 참고하세요.

빠르게 검증만 하려는 경우 Swift Package Manager를 우선 사용하고, 기존 의존성 관리 제약이 있는 경우에만 CocoaPods 또는 Carthage를 선택하세요.

최소 초기화 예시

iOS/tvOS는 일반적으로 AppDelegate에서 초기화합니다. macOS에서는 처음 표시되는 NSViewController의 viewDidLoad 메서드와 NSWindowController의 windowDidLoad 메서드 호출이 AppDelegate의 applicationDidFinishLaunching보다 먼저 실행됩니다. 첫 번째 뷰의 라이프사이클 수집 이상을 방지하려면 main.m 또는 main.swift에서 SDK를 초기화하는 것이 좋습니다.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 로컬 환경 배포 시 [[FTSDKConfig alloc] initWithDatakitUrl:datakitUrl] 사용
    FTSDKConfig *config = [[FTSDKConfig alloc] initWithDatawayUrl:datawayUrl clientToken:clientToken];
    config.enableSDKDebugLog = YES;
    [FTMobileAgent startWithConfigOptions:config];

    FTRumConfig *rumConfig = [[FTRumConfig alloc] initWithAppid:appid];
    rumConfig.enableTraceUserView = YES;
    rumConfig.enableTraceUserAction = YES;
    rumConfig.enableTraceUserResource = YES;
    rumConfig.enableTrackAppFreeze = YES;
    rumConfig.enableTrackAppCrash = YES;
    rumConfig.enableTrackAppANR = YES;
    [[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];
    return YES;
}
// main.m 파일
#import <Cocoa/Cocoa.h>
#import <GuanceSDK/GuanceSDK.h>
int main(int argc, const char * argv[]) {
    @autoreleasepool {
        // 로컬 환경 배포 시 [[FTSDKConfig alloc] initWithDatakitUrl:datakitUrl] 사용
        FTSDKConfig *config = [[FTSDKConfig alloc] initWithDatawayUrl:datawayUrl clientToken:clientToken];
        config.enableSDKDebugLog = YES;
        [FTSDKAgent startWithConfigOptions:config];

        FTRumConfig *rumConfig = [[FTRumConfig alloc] initWithAppid:appid];
        rumConfig.enableTraceUserView = YES;
        rumConfig.enableTraceUserAction = YES;
        rumConfig.enableTraceUserResource = YES;
        rumConfig.enableTrackAppFreeze = YES;
        rumConfig.enableTrackAppCrash = YES;
        rumConfig.enableTrackAppANR = YES;
        rumConfig.errorMonitorType = FTErrorMonitorAll;
        rumConfig.deviceMetricsMonitorType = FTDeviceMetricsMonitorAll;
        [[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
    }
    return NSApplicationMain(argc, argv);
}
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 로컬 환경 배포 시 FTSDKConfig(datakitUrl: datakitUrl) 사용
    let config = FTSDKConfig(datawayUrl: datawayUrl, clientToken: clientToken)
    config.enableSDKDebugLog = true
    FTMobileAgent.start(withConfigOptions: config)

    let rumConfig = FTRumConfig(appid: appid)
    rumConfig.enableTraceUserView = true
    rumConfig.enableTraceUserAction = true
    rumConfig.enableTraceUserResource = true
    rumConfig.enableTrackAppFreeze = true
    rumConfig.enableTrackAppCrash = true
    rumConfig.enableTrackAppANR = true
    FTMobileAgent.sharedInstance().startRum(withConfigOptions: rumConfig)
    return true
}
import Cocoa
import GuanceSDK
let delegate = AppDelegate()
NSApplication.shared.delegate = delegate

// 로컬 환경 배포 시 FTSDKConfig(datakitUrl: datakitUrl) 사용
let config = FTSDKConfig(datawayUrl: datawayUrl, clientToken: clientToken)
config.enableSDKDebugLog = true
FTSDKAgent.start(withConfigOptions: config)

let rumConfig = FTRumConfig(appid: appid)
rumConfig.enableTraceUserView = true
rumConfig.enableTraceUserAction = true
rumConfig.enableTraceUserResource = true
rumConfig.enableTrackAppFreeze = true
rumConfig.enableTrackAppCrash = true
rumConfig.enableTrackAppANR = true
rumConfig.errorMonitorType = .all
rumConfig.deviceMetricsMonitorType = .all
FTSDKAgent.sharedInstance().startRum(withConfigOptions: rumConfig)

_ = NSApplicationMain(CommandLine.argc, CommandLine.unsafeArgv)

Swift를 사용하는 경우 먼저 main.swift 파일을 생성하고 AppDelegate.swift의 @main 또는 @NSApplicationMain을 삭제하세요.

위 예시는 최소 RUM 연동을 충족하며 크래시 및 프리즈 감지가 기본으로 활성화됩니다. 로컬 환경 배포를 사용하는 경우 initWithDatawayUrl:clientToken: / FTSDKConfig(datawayUrl:clientToken:)을 initWithDatakitUrl: / FTSDKConfig(datakitUrl:)로 교체하세요. FTMobileConfig는 현재도 호환되어 사용할 수 있지만, 새 코드에서는 FTSDKConfig 사용을 권장합니다. macOS는 현재 Alpha 버전으로, 모든 iOS 기능의 지원을 보장하지 않습니다.

선택 사항: Log 및 Trace 초기화

로그 수집 또는 분산 추적이 추가로 필요한 경우 다음 초기화를 이어서 추가할 수 있습니다.

FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc] init];
loggerConfig.enableCustomLog = YES;
loggerConfig.enableLinkRumData = YES;
[[FTMobileAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];

FTTraceConfig *traceConfig = [[FTTraceConfig alloc] init];
traceConfig.enableAutoTrace = YES;
traceConfig.enableLinkRumData = YES;
[[FTMobileAgent sharedInstance] startTraceWithConfigOptions:traceConfig];
let loggerConfig = FTLoggerConfig()
loggerConfig.enableCustomLog = true
loggerConfig.enableLinkRumData = true
FTMobileAgent.sharedInstance().startLogger(withConfigOptions: loggerConfig)

let traceConfig = FTTraceConfig()
traceConfig.enableAutoTrace = true
traceConfig.enableLinkRumData = true
FTMobileAgent.sharedInstance().startTrace(withConfigOptions: traceConfig)

연동 성공 여부 확인

  1. enableSDKDebugLog = YES/true를 활성화한 상태로 앱을 실행합니다.
  2. 페이지를 열거나 URLSession 네트워크 요청을 한 번 발생시킵니다.
  3. Xcode 콘솔에서 SDK 초기화 및 데이터 동기화 관련 로그가 출력되는지 확인합니다.
  4. Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 표시되는지 확인합니다.

추가로 문제를 진단해야 하는 경우 문제 해결을 확인하세요.

다음 단계

문서 평가

이 페이지가 도움이 되었나요?