빠른 시작¶
이 문서는 0.3.0 이상 버전의 최단 연동 경로를 제공합니다. 전체 설치 및 호스트 통합 설명은 애플리케이션 연동을 참조하세요.
애플리케이션은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.
일반 uni-app¶
1. 모듈 설치¶
동일한 버전의 릴리스 패키지에 포함된 다음 디렉터리를 프로젝트에 복사합니다. 버전은 0.3.0 이상이어야 합니다:
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에서는 루트 인스턴스를 생성하기 전에 호출해야 합니다:
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에서 검증해야 합니다.