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