콘텐츠로 이동

빠른 시작

본 문서는 0.3.0 이상 버전에 대한 최단 접근 경로를 제공합니다. 전체 설치 및 호스트 통합에 대한 자세한 내용은 애플리케이션 연동을 참조하세요.

일반 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에 해당 모듈이 등록되지 않은 경우, 이러한 호출은 안전하게 무효 처리되어 일반 베이스에서 uni 미니 프로그램 페이지를 디버깅하는 데 편리합니다. 기본 링크는 호스트 확장이 통합된 호스트 App에서만 확인해야 합니다.

다음 단계

문서 평가

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