macOS 兼容矩阵
口径说明
融云公开文档不覆盖 macOS 原生 SDK 与桌面交付链（dmg / 代码签名 / 公证 / 分发 / Gatekeeper）；本页为本项目按 Apple 与 Electron 官方实践补齐的接入文档。
融云官网的 Electron 支持表只列到 Electron 20.0.x，且 5.8.3 起已改为 N-API、不再与 Electron 版本强绑定；因此本页用“实测矩阵”替代过期的版本表，约束维度是 macOS 版本 × 架构 × Electron 主版本。
实测矩阵
| macOS | 架构 | Electron 35 | 说明 |
|---|---|---|---|
| macOS 11 Big Sur | x64 | 本机实测 | 最低支持版本；Intel 构建验证 |
| macOS 11 Big Sur | arm64 | CI 构建验证 | macos-14 runner；Apple Silicon 原生 |
| macOS 12 Monterey | x64 / arm64 | 支持（x64 实测 / arm64 CI） | — |
| macOS 13 Ventura | x64 / arm64 | 支持（x64 实测 / arm64 CI） | — |
| macOS 14 Sonoma | x64 / arm64 | 支持（x64 实测 / arm64 CI） | — |
| macOS 15 Sequoia | x64 / arm64 | x64 本机实测；arm64 CI | 当前开发机（Intel）验证版本 |
版本约束
| 项 | 约束 | 说明 |
|---|---|---|
| macOS 最低版本 | 11.0 | 低于此版本不保证可运行；可在 Info.plist 用 `LSMinimumSystemVersion` 声明 |
| Electron | 35.x（基线） | 升级大版本需回归 preload 安全设置、原生依赖与签名 |
| Node.js | 22.5+ | 构建与主进程运行时 |
| CPU 架构 | x64 / arm64 | x64 本机实测；arm64 由 CI 构建验证；Apple Silicon 可通过 Rosetta 运行 x64 |
| 磁盘 | ≥ 500 MB 安装空间 | 本地库随消息量增长 |
验证环境
| 项 | 值 |
|---|---|
| 主机 | macOS 15 (x86_64) |
| Electron | 35.0.1 |
| Node | 22 |
| 日期 | 2026-10-29 |
架构选择建议
- 只发 arm64：Apple Silicon 用户体积最小，但 Intel 用户无法安装。
- 只发 x64：Intel 可用，Apple Silicon 走 Rosetta（性能与兼容性略差）。
- 分架构 dmg（推荐）：用户下载对应架构，体积与性能最优。
- universal：单包覆盖两种架构，体积约翻倍、构建更慢，适合内部分发。