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 平台说明。