ShaoHua
42 lines
1.6 KiB
Markdown
42 lines
1.6 KiB
Markdown
# 02 - Linux：打包、依赖与交付产物
|
||
|
||
## 目标
|
||
|
||
- 为 Linux 提供可安装/可分发的交付产物，并尽量做到“用户机器无需手动补大量依赖即可运行”
|
||
- 明确最低支持发行版范围（建议 Ubuntu LTS 作为基线）与依赖策略（WebView 运行时/字体/输入法等）
|
||
|
||
## 范围
|
||
|
||
- 构建脚本与产物输出
|
||
- 运行时依赖打包策略（尤其是 WebView 相关）
|
||
- 基础安装/运行说明（README / docs 更新）
|
||
|
||
## 依赖
|
||
|
||
- 依赖 `01-*`（Avalonia 入口与 WebView 方案已定、并能在开发机运行）
|
||
|
||
## 交付形式（PRD 约束）
|
||
|
||
- 优先提供一种“自包含”官方安装方式（AppImage/Flatpak 二选一，建议先做一条跑通）
|
||
- 同时保留 `.deb` 或 `.tar.gz` 作为补充分发形式（以脚本产出为准）
|
||
|
||
## 实施步骤（建议）
|
||
|
||
1. 确定 Linux 发行版基线与运行时依赖清单
|
||
- 记录：最低 glibc、Wayland/X11、WebView 运行时依赖、字体包
|
||
2. 选择并落地一种自包含交付形式
|
||
- AppImage：偏“拎包即用”，对依赖捆绑要求高
|
||
- Flatpak：沙盒与运行时生态更成熟，但需要 manifest 与权限策略
|
||
3. 补充 `.deb` 或 `.tar.gz`
|
||
- `.deb`：适合 Ubuntu/Debian 系；需要 desktop entry、图标、依赖声明
|
||
- `.tar.gz`：最通用；需要启动脚本与依赖说明
|
||
4. 增加启动前自检（可选但推荐）
|
||
- 发现关键依赖缺失时给出清晰错误提示与修复建议
|
||
|
||
## 验收标准
|
||
|
||
- 产物可在“干净环境”（尽量接近用户机）安装/运行
|
||
- 启动后 WebView 能渲染前端，且本地 API 可用
|
||
- 文档中给出的安装/运行步骤可复现，且与产物一致
|
||
|