ZeroLaunch-rs 自动化构建工具

October 5, 2025 · View on GitHub

这是一个用于自动化构建 ZeroLaunch-rs 项目的强大工具，支持构建安装包版本和便携版本，包括 x64 和 ARM64 架构，并提供灵活的架构选择功能。

🚀 功能特性

✨ 架构选择：支持选择性构建特定架构（x64、ARM64 或全部）
🧠 AI 特性开关：支持构建完全体（启用 AI）或精简版（关闭 AI）
📦 多版本支持：安装包版本和便携版本
🏗️ 多架构支持：x64 和 ARM64 架构
📁 自动打包：便携版本自动打包为 ZIP 文件
🧹 智能清理：清理构建产物和临时文件
⚡ 高效构建：可选择性构建，节省时间

📋 使用方法

基本命令

构建所有版本（默认：所有架构 & 同时构建启用/关闭 AI 两种模式）

cargo run --bin xtask build-all

仅构建启用 AI 的完全体（只生成含 AI 版本）

cargo run --bin xtask build-all --ai enabled

仅构建关闭 AI 的精简版

cargo run --bin xtask build-all --ai disabled

构建安装包（默认：启用 AI）

cargo run --bin xtask build-installer

构建安装包版本（显式关闭 AI）

cargo run --bin xtask build-installer --ai disabled

构建安装包版本（默认：所有架构，默认启用 AI）

cargo run --bin xtask build-installer

构建便携版本（默认：所有架构，默认启用 AI）

cargo run --bin xtask build-portable

构建便携版本（关闭 AI）

cargo run --bin xtask build-portable --ai disabled

清理构建产物

cargo run --bin xtask clean

🎯 架构选择功能

仅构建 x64 架构

# 构建所有版本的 x64 架构
cargo run --bin xtask build-all --arch x64

# 仅构建 x64 安装包
cargo run --bin xtask build-installer --arch x64

# 仅构建 x64 便携版
cargo run --bin xtask build-portable --arch x64

仅构建 ARM64 架构

# 构建所有版本的 ARM64 架构
cargo run --bin xtask build-all --arch arm64

# 仅构建 ARM64 安装包
cargo run --bin xtask build-installer --arch arm64

# 仅构建 ARM64 便携版
cargo run --bin xtask build-portable --arch arm64

构建所有架构（显式指定）

# 明确指定构建所有架构
cargo run --bin xtask build-all --arch all

🤖 AI 特性开关

当前默认策略：

build-installer / build-portable 不加 --ai 参数时 = 启用 AI（完全体）
如需精简 Lite 版，加 --ai disabled
build-all 默认同时构建 enabled + disabled 两种产物，可改为单一模式

# 构建默认完全体（启用 AI）
cargo run --bin xtask build-installer

# 构建精简版（关闭 AI）
cargo run --bin xtask build-installer --ai disabled

# 便携版默认同样启用 AI
cargo run --bin xtask build-portable

# 构建便携版精简版
cargo run --bin xtask build-portable --ai disabled

# build-all 默认同时构建启用与关闭 AI 的两个版本，可显式限制
cargo run --bin xtask build-all --ai both

📖 参数说明

参数	简写	可选值	默认值	说明
`--arch`	`-a`	`x64`, `arm64`, `all`	`all`	指定构建的目标架构
`--ai`	-	`enabled`, `disabled`, `both`(仅 `build-all`)	`enabled`（`build-all` 默认 `both`）	是否启用 AI 特性：安装包/便携版默认构建启用 AI；Lite 需显式 `--ai disabled`

💡 使用场景示例

# 快速构建：仅构建当前平台的 x64 便携版
cargo run --bin xtask build-portable -a x64

# 发布准备：构建所有版本的所有架构（包含启用/关闭 AI）
cargo run --bin xtask build-all

# 测试构建：仅构建 ARM64 安装包
cargo run --bin xtask build-installer --arch arm64

# 清理后重新构建 x64 版本
cargo run --bin xtask clean
cargo run --bin xtask build-all -a x64

📦 构建产物

安装包版本

构建完成后，安装包会自动移动到项目根目录：

zerolaunch-rs_0.5.1_x64-setup.exe / ZeroLaunch_0.5.1_x64_en-US.msi 等 —— 启用 AI 的完全体命名（示例）
zerolaunch-rs_lite_0.5.1_x64-setup.exe / ZeroLaunch_lite_0.5.1_x64_en-US.msi 等 —— 关闭 AI 的精简版命名（示例）
ARM64 架构的安装包命名同理，会在架构字段前插入 _lite

便携版本

便携版会打包成 ZIP 文件并放置在项目根目录：

ZeroLaunch-portable-0.5.1-x64.zip - 启用 AI 的 x64 便携版 ZIP 包
ZeroLaunch-portable-lite-0.5.1-x64.zip - 关闭 AI 的 x64 便携版 ZIP 包
ZeroLaunch-portable-0.5.1-arm64.zip / ZeroLaunch-portable-lite-0.5.1-arm64.zip - ARM64 架构同理

便携版 ZIP 包包含：

主程序可执行文件
icons/ 文件夹（图标资源）
locales/ 文件夹（国际化文件，如果存在）

🔧 故障排除

常见问题

ARM64 构建失败

# 安装 ARM64 目标平台
rustup target add aarch64-pc-windows-msvc

构建时间过长
- 使用架构选择功能仅构建需要的架构
- 确保系统有足够的内存和存储空间
权限问题
- 确保对项目目录有写权限
- 在 Windows 上可能需要管理员权限

📄 许可证

本项目遵循与 ZeroLaunch-rs 主项目相同的许可证。

提示：首次构建可能需要较长时间，因为需要下载依赖和编译。建议使用架构选择功能来加速开发过程中的构建。