콘텐츠로 이동

빠른 시작

이 문서는 HarmonyOS RUM SDK를 가장 짧은 경로로 연동하여 검증 가능한 데이터 업로드를 빠르게 완료할 수 있도록 안내합니다.

사전 준비

  1. 실제 사용자 모니터링(RUM)에서 HarmonyOS 앱을 생성하고 RUM App ID를 획득하세요.
  2. 데이터 업로드 방식을 확인하세요.
  3. 로컬 환경 배포: datakitUrl 준비
  4. 공용 네트워크 DataWay: datawayUrl 및 clientToken 준비
  5. 설치 방식을 선택하세요.
  6. 타사 저장소가 구성된 경우: ohpm으로 @guancecloud/ft_sdk 직접 설치
  7. 로컬 HAR 사용: ft_sdk.har 다운로드 후 oh-package.json5에서 @guancecloud/ft_sdk를 의존성 이름으로 사용
  8. @kit.NetworkKit 기반 HTTP 인터셉터 체인 기능을 사용하려면 @guancecloud/ft_sdk_ext를 추가로 설치하거나 ft_sdk_ext.har를 다운로드하세요. 해당 기능은 HarmonyOS API 22 이상이 필요합니다.
  9. Native Crash를 수집해야 하는 경우 @guancecloud/ft_native를 추가로 설치하거나 ft_native.har를 다운로드하세요.
  10. 바이트코드 HAR를 사용하는 경우 프로젝트는 HarmonyOS API 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 데이터가 표시되는지 확인하세요.

다음 단계

문서 평가

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