信创系统兼容性规范
本文档记录司册应用在信创环境下的兼容性要求和适配指南。
目标平台
操作系统
- 统信 UOS - V20 及以上版本
- 银河麒麟 - V10 SP1 及以上版本
CPU 架构
| 架构 | 国产芯片 | 优先级 |
|---|---|---|
| x86_64 | 海光、兆芯 | 高 |
| ARM64 | 飞腾、鲲鹏 | 高 |
| LoongArch64 | 龙芯 3A6000 | 中 |
Tauri 信创适配
系统依赖
统信 UOS / 银河麒麟（Debian 系）：
bash
sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-devRust 目标配置
bash
# 添加 ARM64 目标
rustup target add aarch64-unknown-linux-gnu
# 添加 LoongArch 目标（实验性）
rustup target add loongarch64-unknown-linux-gnu构建命令
bash
# ARM64 构建（飞腾、鲲鹏）
pnpm tauri build --target aarch64-unknown-linux-gnu
# x86_64 构建（海光、兆芯）
pnpm tauri build --target x86_64-unknown-linux-gnu打包格式
- 优先格式:
.deb- 统信 UOS / 麒麟均为 Debian 系 - 备选格式:
.AppImage- 通用 Linux 格式
已知问题与解决方案
1. WebKitGTK 兼容性
问题: 部分信创系统 WebKitGTK 版本过旧
解决方案:
- 开发时测试目标系统的 WebKitGTK 版本
- 避免使用过新的 CSS 特性（如
@property、color-mix()需要 Safari 16.4+） - Tauri v2 要求 WebKitGTK 4.1+
2. GPU 渲染
问题: 信创环境 GPU 驱动可能不完善
解决方案:
- 提供软件渲染降级选项
- 测试
--disable-gpu启动参数兼容性
3. 字体渲染
问题: 国产系统字体库可能缺失
解决方案:
- 应用内置常用中文字体
- 使用 Tailwind CSS 的
font-sans等系统字体栈
4. 沙箱机制
问题: 信创系统对沙箱支持可能有限
解决方案:
- 测试 Tauri 的安全策略在目标系统的表现
- 必要时调整
tauri.conf.json中的安全配置
测试矩阵
| 系统 | x86_64 | ARM64 | LoongArch |
|---|---|---|---|
| 统信 UOS V20 | 待测试 | 待测试 | 待测试 |
| 麒麟 V10 SP1 | 待测试 | 待测试 | 待测试 |
开发优先级
- 优先开发平台: Windows、macOS
- 次要适配平台: 统信 UOS、银河麒麟