Electron 애플리케이션 연동¶
Electron 페이지 데이터는 Renderer의 Browser SDK가 수집하며, 독립적으로 업로드하거나 Native Bridge를 통해 네이티브 SDK로 전달할 수 있습니다.
연동 방식 선택¶
- Browser 독립 업로드: 페이지 모니터링만 필요하며, Browser SDK가 Session과 업로드를 관리합니다. Browser 독립 연동을 참조하세요.
- Native Bridge: 네이티브 SDK가 Session, 샘플링, 컨텍스트, 업로드를 통합 관리해야 하는 경우 아래의 연동 모드를 선택하세요.
한 페이지에서는 한 가지 방식만 사용하며, 두 방식의 초기화 설정을 함께 사용할 수 없습니다.
Native Bridge 모드 선택¶
| 모드 | 사용 사례 | 연동 문서 |
|---|---|---|
전체 모드(managed) |
애플리케이션이 Electron이며 Adapter가 Native SDK를 초기화하고 종료합니다 | 빠른 시작 |
혼합 모드(external) |
네이티브 호스트가 이미 Native SDK를 연동했으며 Electron이 기존 인스턴스에 연결합니다 | Windows 호스트, macOS 호스트 |
하나의 Electron 프로세스에서는 한 가지 모드만 사용하며, 두 모드는 Preload, 창 및 Renderer 설정을 공유합니다.
지원 범위 및 버전¶
Native Adapter는 Windows(x64, x86 / ia32, arm64)와 macOS(x64, arm64)를 지원하며 Linux는 지원하지 않습니다. Electron 호환 범위는 ^22.3.27 || 43.x이며, 중간 메이저 버전은 아직 검증되지 않았습니다.
Adapter, Browser SDK, Native SDK는 각각 버전을 별도로 관리합니다. 함께 사용되는 Native SDK 버전은 설치된 Adapter의 package.json.nativeRuntime을 기준으로 합니다.
운영 체제 요구 사항, 런타임 설치 및 패키징 방법은 Windows 플랫폼 설명 및 macOS 플랫폼 설명을 참조하세요.