콘텐츠로 이동

빠른 시작

이 문서는 0.3.0 이상 버전의 최단 연동 경로를 제공합니다. 전체 설치 및 호스트 통합 설명은 애플리케이션 연동을 참조하세요.

애플리케이션은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.

일반 uni-app

1. 모듈 설치

동일한 버전의 릴리스 패키지에 포함된 다음 디렉터리를 프로젝트에 복사합니다. 버전은 0.3.0 이상이어야 합니다:

uni_modules/
├── GC-JSPlugin
└── GC-UniPlugin

nativeplugins/GCUniPlugin은 더 이상 설치하지 않습니다.

2. Bridge 로드 및 API 가져오기

애플리케이션 진입점에서 setup.js를 한 번 로드합니다:

import '@/uni_modules/GC-UniPlugin/setup.js';

import {
    mobileAgent,
    rum,
    logger,
    tracer
} from '@/uni_modules/GC-UniPlugin';

import {
    gcErrorTracking,
    gcViewTracking,
    gcResourceTracking
} from '@/uni_modules/GC-JSPlugin';

3. 초기화

mobileAgent.sdkConfig({
    datakitUrl: 'YOUR_DATAKIT_URL',
    debug: true,
    env: 'prod'
});

rum.setConfig({
    androidAppId: 'YOUR_ANDROID_APP_ID',
    iOSAppId: 'YOUR_IOS_APP_ID',
    harmonyAppId: 'YOUR_HARMONY_APP_ID'
});

logger.setConfig({
    enableCustomLog: true,
    enableLinkRumData: true
});

tracer.setConfig({
    traceType: 'ddTrace',
    enableLinkRUMData: true
});

gcErrorTracking.startTracking();
gcResourceTracking.startTracking();

실제 배포 플랫폼에 해당하는 RUM App ID만 입력하면 됩니다. 퍼블릭 DataWay를 사용하는 경우 datakitUrl을 datawayUrl 및 clientToken으로 대체합니다.

4. View 자동 수집 활성화

Vue 2에서는 루트 인스턴스를 생성하기 전에 호출해야 합니다:

gcViewTracking.startTracking();

Vue 3에서는 createSSRApp()가 반환하는 애플리케이션 인스턴스를 전달해야 합니다:

import App from './App';
import { createSSRApp } from 'vue';

export function createApp() {
    const app = createSSRApp(App);
    gcViewTracking.startTracking(app);
    return { app };
}

권장 초기화 순서는 다음과 같습니다:

mobileAgent.sdkConfig
  -> rum.setConfig
  -> logger.setConfig / tracer.setConfig
  -> GC-UniSessionReplay.setConfig(선택 사항)
  -> gcErrorTracking / gcResourceTracking / gcActionTracking
  -> gcViewTracking

호스트 App + uni 미니프로그램

uni 미니프로그램 프로젝트에는 GC-JSPlugin만 설치합니다:

import {
    mobileAgent,
    rum,
    logger,
    tracer,
    gcErrorTracking,
    gcViewTracking,
    gcResourceTracking
} from '@/uni_modules/GC-JSPlugin';

Native SDK, RUM, Log, Trace는 호스트 App이 uni 미니프로그램을 열기 전에 초기화합니다. uni 미니프로그램은 JS 수집기를 시작하고 런타임 API를 호출하는 역할만 합니다. 예:

mobileAgent.bindRUMUserData({
    userId: 'USER_ID'
});

mobileAgent.appendBridgeContext({
    wgt_id: 'YOUR_WGT_ID'
});

gcErrorTracking.startTracking();
gcResourceTracking.startTracking();

iOS 호스트에서 이미 Native Resource 자동 수집을 활성화한 경우 중복 수집을 피하기 위해 gcResourceTracking.startTracking({ enableIOS: false })를 대신 호출합니다.

호스트 App에 해당 모듈이 등록되어 있지 않으면 이러한 호출은 안전하게 no-op으로 폴백되므로 일반 베이스에서 uni 미니프로그램 페이지를 디버깅할 수 있습니다. 네이티브 경로는 호스트 확장이 통합된 호스트 App에서 검증해야 합니다.

다음 단계

문서 평가

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