빠른 시작¶

본 문서는 HarmonyOS RUM SDK의 최단 접근 경로를 제공하여, 신속하게 검증 가능한 데이터 업로드를 완료할 수 있도록 안내합니다.

사전 준비¶

1. RUM에서 HarmonyOS 애플리케이션을 생성하고 RUM App ID를 획득합니다.
2. 업로드 방식을 확인합니다.
   • 로컬 환경 배포: datakitUrl 준비
   • 공용 DataWay: datawayUrl 및 clientToken 준비
3. 설치 방식을 선택합니다.
   • 타사 저장소가 이미 구성된 경우: ohpm을 통해 @guancecloud/ft_sdk 직접 설치
   • 로컬 HAR 사용: ft_sdk.har를 다운로드하고, oh-package.json5에서 @guancecloud/ft_sdk를 종속성 이름으로 사용
4. @kit.NetworkKit 기반의 HTTP 인터셉터 체인 기능을 사용하려면 @guancecloud/ft_sdk_ext를 추가로 설치하거나 ft_sdk_ext.har를 다운로드합니다.
5. Native Crash 수집이 필요한 경우, @guancecloud/ft_native를 추가로 설치하거나 ft_native.har를 다운로드합니다.
6. 바이트코드 HAR 사용 시, 프로젝트는 HarmonyOS API Level 12 이상이어야 하며, 루트 디렉터리의 build-profile.json5에서 useNormalizedOHMUrl을 활성화해야 합니다. 전체 구성 및 난독화 설명은 바이트코드 HAR 빌드 구성을 참고하세요.

연동 단계¶

1. 타사 저장소를 사용하는 경우, ohpm install @guancecloud/ft_sdk를 실행합니다.
2. 로컬 HAR를 사용하는 경우, HAR 파일을 프로젝트 libs 디렉터리에 넣고 oh-package.json5에서 scoped 종속성을 선언합니다. ft_sdk_ext.har도 함께 사용한다면, 프로젝트 루트 디렉터리의 oh-package.json5에서 overrides를 사용하여 @guancecloud/ft_sdk를 로컬 HAR로 재작성한 후 ohpm install을 실행합니다.
3. 애플리케이션 시작 시 FTSDKConfig를 초기화합니다.
4. FTRUMConfig를 초기화하여 View, Action, Resource, ANR 및 Crash 수집을 활성화합니다.
5. 디버그 로그를 활성화하고, 앱을 실행하여 페이지 열기 또는 네트워크 요청을 한 번 트리거합니다.
6. 콘솔로 돌아가 RUM 데이터가 성공적으로 업로드되었는지 확인합니다.

최소 종속성 방식¶

• ohpm을 통해 핵심 SDK를 설치합니다.

ohpm install @guancecloud/ft_sdk

• 로컬 HAR를 사용하는 경우, oh-package.json5에 최소 종속성을 추가합니다.

{
  "dependencies": {
    "@guancecloud/ft_sdk": "file:../libs/ft_sdk.har"
  }
}

최소 종속성 방식으로 먼저 연동하여 기본 데이터 업로드를 확인한 후, 필요에 따라 확장 패키지를 추가하는 것을 권장합니다.

최소 초기화 예시¶

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';

import { FTSDK, FTSDKConfig, FTRUMConfig, EnvType, SDKLogLevel } from '@guancecloud/ft_sdk/Index';


export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 로컬 환경 배포 시 FTSDKConfig.builder(datakitUrl)로 변경 가능
    const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
      .setDebug(true)
      .setSdkLogLevel(SDKLogLevel.D)
      .setServiceName('Your-App-Name')
      .setEnv(EnvType.PROD);

    FTSDK.install(sdkConfig, this.context);

    const rumConfig = new FTRUMConfig()
      .setRumAppId('your-app-id')
      .setSamplingRate(1.0)
      .setEnableTraceUserAction(true)
      .setEnableTraceUserView(true)
      .setEnableTraceUserResource(true)
      .setEnableTrackAppANR(true)
      .setEnableTrackAppCrash(true);

    FTSDK.installRUMConfig(rumConfig);
  }
}

연동 성공 여부 확인¶

1. setDebug(true)를 활성화한 상태로 유지합니다.
2. 페이지를 열거나 네트워크 요청을 한 번 실행합니다.
3. hilog에서 [FT-SDK]를 검색하여 SDK 초기화 및 데이터 업로드 프로세스가 정상적인지 확인합니다.
4. Guance 콘솔로 돌아가 해당 RUM 데이터가 나타나는지 확인합니다.

다음 단계¶

• 전체 연동 설명: 애플리케이션 연동 참고
• 기존 HAR 마이그레이션 설명: 기존 설정 마이그레이션 참고
• SDK 초기화 파라미터: SDK 초기화 참고
• RUM 상세 설정 및 수동 수집: RUM 설정 참고
• Log 및 Trace: Log 설정, Trace 설정 참고
• WebView 시나리오: WebView 데이터 모니터링 참고