Native 지원

최근 업데이트 2026. 10. 03.

1. iOS Native 지원

1.1 iOS 프로젝트 빌드

• 빌드 준비

  • Web 플랫폼 앱을 게시하고 게시 파일 경로를 기록합니다

• 빌드 설정

  • Menu > Tools > App Build 화면을 엽니다
  • 프로젝트 유형으로 XCode iOS를 선택하고 Standalone에 체크합니다
  • 리소스 경로로 Web 플랫폼 앱의 게시 경로를 선택합니다

1.2 iOS 프로젝트 설정

• iOS 프로젝트 의존성 파일 추가

  • LayaProxyApi.h
  • LayaProxyApi.mm
  • ThinkingSDK.framework

• Build Settings 설정

  • Other Linker Flags에 -ObjC 추가

2. Android Native 지원

2.1 Android 프로젝트 빌드

• 빌드 준비

  • Web 플랫폼 앱을 게시하고 게시 파일 경로를 기록합니다

• 빌드 설정

  • Menu > Tools > App Build 화면을 엽니다
  • 프로젝트 유형으로 Android studio를 선택하고 Standalone에 체크합니다
  • 리소스 경로로 Web 플랫폼 앱의 게시 경로를 선택합니다

2.2 Android 프로젝트 설정

• Android 표시 모드의 app 프로젝트에서 의존성 파일 LayaProxyApi.java를 demo에 추가합니다(아래 그림 참고)

• 프로젝트의 app/libs 디렉터리에 ThinkingSDK.aar를 복사합니다

• Module 아래의 build.gradle 파일에 의존성을 추가합니다. 기존 fileTree 의존성의 include에 '*.aar'를 추가하면 되며, 기존의 '*.jar'는 그대로 유지해야 합니다

dependencies {
    ...
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
}

3. Native 지원 활성화

SDK를 초기화할 때 config에 enableNative: true를 추가하면 Native 지원이 활성화됩니다.

// TA SDK 설정 객체
var config = {
  appId: "YOUR_APPID", // 프로젝트 APP ID
  serverUrl: "YOUR_SERVER_URL", // 전송 주소
  enableNative: true, // Native 코드 호출 허용
  autoTrack: {
    appShow: true, // 시작 이벤트 자동 수집
    appHide: true, // 종료 이벤트 자동 수집
    appClick: true, // 클릭 이벤트 자동 수집(native에서만 적용)
    appView: true, // 페이지 조회 이벤트 자동 수집(native에서만 적용)
    appCrash: true, // 크래시 이벤트 자동 수집(native에서만 적용)
    appInstall: true // 설치 이벤트 자동 수집(native에서만 적용)
  }
};

// 초기화
TDAnalytics.init(config);
// 간단한 이벤트 전송, 이벤트 이름은 test_event
TDAnalytics.track({
    eventName: "test_event"
});