Hua.Todo/docs/project/v1.2.0-tasks/02-Linux-打包与交付.md

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 可用
• 文档中给出的安装/运行步骤可复现，且与产物一致