ClaudeCodeInstaller/scripts

构建与发布脚本

本目录包含 Claude AI Installer 的构建和发布脚本。

两种使用方式

1. 只构建，不发布

npm run build:win      # 仅构建 Windows
npm run build:mac      # 仅构建 macOS
npm run build:linux    # 仅构建 Linux
npm run build:all      # 构建所有平台

只生成安装包到 release/ 目录，不修改版本号，不创建 Git tag。

2. 发布（包含构建）

npm run release:patch  # 更新版本 → 构建 → 创建 tag
npm run release:minor  # 次版本发布
npm run release:major  # 主版本发布

完整流程：更新版本号 → 构建所有平台 → 生成发布说明 → 创建 Git tag。

简单来说：

• build.js = 单纯构建
• release.js = 更新版本 + 构建 + 发布相关操作

---

快速开始

# 进入项目目录
cd ApqInstaller

# 安装依赖
npm install

# 构建当前平台
npm run build:win      # Windows
npm run build:mac      # macOS
npm run build:linux    # Linux
npm run build:all      # 所有平台

脚本说明

build.js - 构建脚本

多平台构建脚本，用于编译和打包应用。

用法

node scripts/build.js [选项]

选项

选项	简写	说明	默认值
--platform	-p	目标平台: win, mac, linux, all	当前平台
--arch	-a	目标架构: x64, arm64, all	当前架构
--publish	-P	发布模式: always, onTag, never	never
--skip-build	-	跳过前端构建，仅打包	-
--help	-h	显示帮助信息	-

示例

# 构建 Windows 版本
node scripts/build.js -p win

# 构建 macOS ARM64 版本
node scripts/build.js -p mac -a arm64

# 构建所有平台
node scripts/build.js -p all

# 跳过前端构建，仅打包
node scripts/build.js -p win --skip-build

---

release.js - 发布脚本

自动化发布脚本，按以下顺序执行：

1. 更新版本号（可选）
2. 构建所有平台安装包
3. 生成发布说明
4. 创建 Git tag（可选）
5. 推送到远程（可选）

用法

node scripts/release.js [版本] [选项]

版本参数

参数	说明	示例
patch	补丁版本 +1	0.0.1 → 0.0.2
minor	次版本 +1	0.0.1 → 0.1.0
major	主版本 +1	0.0.1 → 1.0.0
x.y.z	指定版本号	1.2.3

选项

选项	简写	说明
--tag	-t	创建 Git tag
--push	-	推送 tag 到远程仓库
--platform	-p	指定平台 (逗号分隔)
--dry-run	-	仅显示操作，不实际执行
--help	-h	显示帮助信息

示例

# 更新补丁版本并构建
node scripts/release.js patch

# 设置版本为 1.0.0 并创建 tag
node scripts/release.js 1.0.0 --tag

# 更新次版本，仅构建 Windows 和 macOS
node scripts/release.js minor -p win,mac

# 完整发布流程：更新版本、构建、创建 tag、推送
node scripts/release.js patch --tag --push

# 预览发布操作（不实际执行）
node scripts/release.js patch --dry-run

---

NPM Scripts

在 package.json 中预定义了以下命令：

构建命令

命令	说明
npm run build:win	构建 Windows 版本
npm run build:mac	构建 macOS 版本
npm run build:linux	构建 Linux 版本
npm run build:all	构建所有平台

发布命令

命令	说明
npm run release	发布（不更新版本）
npm run release:patch	发布补丁版本 + 创建 tag
npm run release:minor	发布次版本 + 创建 tag
npm run release:major	发布主版本 + 创建 tag

---

构建产物

构建完成后，安装包会输出到 release/ 目录：

Windows

格式	文件名	说明
NSIS	Claude AI Installer-x.x.x-win-x64-nsis.exe	安装程序
Portable	Claude AI Installer-x.x.x-win-x64-portable.exe	便携版

macOS

格式	文件名	说明
DMG	Claude AI Installer-x.x.x-mac-x64-dmg.dmg	Intel 版
DMG	Claude AI Installer-x.x.x-mac-arm64-dmg.dmg	Apple Silicon 版
ZIP	Claude AI Installer-x.x.x-mac-x64-zip.zip	Intel 压缩包
ZIP	Claude AI Installer-x.x.x-mac-arm64-zip.zip	Apple Silicon 压缩包

Linux

格式	文件名	说明
AppImage	Claude AI Installer-x.x.x-linux-x64-AppImage.AppImage	通用格式
DEB	Claude AI Installer-x.x.x-linux-x64-deb.deb	Debian/Ubuntu
RPM	Claude AI Installer-x.x.x-linux-x64-rpm.rpm	Fedora/RHEL

---

跨平台构建注意事项

在 Windows 上构建

• Windows: 原生支持
• macOS: 不支持（需要 macOS 系统）
• Linux: 需要 WSL 或 Docker

在 macOS 上构建

• Windows: 需要安装 Wine (brew install --cask wine-stable)
• macOS: 原生支持
• Linux: 原生支持

在 Linux 上构建

• Windows: 需要安装 Wine
• macOS: 不支持（需要 macOS 系统）
• Linux: 原生支持

使用 CI/CD 构建所有平台

推荐使用 GitHub Actions 等 CI/CD 服务在各自平台的 runner 上构建：

# .github/workflows/build.yml 示例
jobs:
  build:
    strategy:
      matrix:
        os: [windows-latest, macos-latest, ubuntu-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm install
      - run: npm run build

---

发布流程

标准发布流程

1. 确保所有更改已提交

2. 运行发布命令：

   npm run release:patch  # 或 minor/major
   

3. 检查 release/ 目录中的构建产物

4. 手动推送（如果没有使用 --push）：

   git push && git push --tags
   

5. 在 GitHub 创建 Release，上传构建产物

自动发布流程

# 一键完成：更新版本 → 构建 → 创建 tag → 推送
node scripts/release.js patch --tag --push

---

故障排除

构建失败

1. 确保已安装所有依赖：npm install
2. 清理旧的构建文件：删除 dist/ 和 dist-electron/ 目录
3. 检查 Node.js 版本（推荐 18+）

图标问题

确保以下图标文件存在：

• Windows: public/icons/win/icon.ico
• macOS: public/icons/mac/icon.icns
• Linux: public/icons/png/ (包含各尺寸 PNG)

签名问题

• Windows: 需要代码签名证书（可选）
• macOS: 需要 Apple Developer 证书进行公证（发布到 App Store 必需）