Release 工作流文档

概述

该工作流用于自动化构建和发布 Claude AI Installer 应用程序，支持 Windows、macOS 和 Linux 三个平台。

工作流采用模块化设计，按平台拆分为独立的构建工作流，由主 Release 工作流统一调用。

工作流文件结构

文件	说明
`release.yml`	主工作流，负责调用各平台构建并创建 Release
`build-windows.yml`	Windows 平台构建
`build-macos-arm64.yml`	macOS ARM64 平台构建 (Apple Silicon)
`build-macos-x64.yml`	macOS x64 平台构建 (Intel)
`build-linux.yml`	Linux 平台构建

触发条件

release.yml（主工作流）

on:
  workflow_dispatch:  # 手动触发，用于集成测试
  push:
    tags:
      - 'v*'

推送以 v 开头的 tag 时自动触发（如 v1.0.0、v2.1.3）
支持手动触发用于测试

各平台构建工作流

on:
  workflow_dispatch:  # 手动触发，用于单独调试
  workflow_call:      # 被其他工作流调用

支持被 release.yml 调用
支持手动触发用于单独调试

工作流程图

┌─────────────────────┐
│   推送 v* 标签       │
│   或手动触发         │
└──────────┬──────────┘
           ▼
┌─────────────────────────────────────────────────────────────────────┐
│                         release.yml                                  │
├─────────────────────────────────────────────────────────────────────┤
│  调用各平台构建工作流（并行执行）                                      │
│  ┌─────────────┬─────────────┬─────────────┬─────────────┐          │
│  │ build-      │ build-      │ build-      │ build-      │          │
│  │ windows.yml │ macos-      │ macos-      │ linux.yml   │          │
│  │             │ arm64.yml   │ x64.yml     │             │          │
│  │  Windows    │  macOS      │  macOS      │   Linux     │          │
│  │    x64      │  ARM64      │   x64       │    x64      │          │
│  └─────────────┴─────────────┴─────────────┴─────────────┘          │
└─────────────────────────────────────────────────────────────────────┘
           │
           ▼
┌─────────────────────┐
│  release job        │
│  - 下载所有构建产物  │
│  - 创建 GitHub Release │
│  - 上传安装包        │
└─────────────────────┘

各工作流详细说明

build-windows.yml

运行环境: windows-latest

Target: x86_64-pc-windows-msvc

步骤	说明
Checkout code	检出代码
Setup Node.js	配置 Node.js 20，启用 npm 缓存
Install Rust toolchain	安装 Rust 工具链及 Windows target
Cache Rust	缓存 Cargo 依赖加速构建
Install dependencies	执行 `npm ci` 安装依赖
Build application	执行 `node scripts/build.js --target x86_64-pc-windows-msvc`
Upload artifacts	上传构建产物到 `artifacts-win`

build-macos-arm64.yml

运行环境: macos-latest

Target: aarch64-apple-darwin

步骤	说明
Checkout code	检出代码
Setup Node.js	配置 Node.js 20，启用 npm 缓存
Install Rust toolchain	安装 Rust 工具链及 ARM64 target
Cache Rust	缓存 Cargo 依赖加速构建
Install dependencies	执行 `npm ci` 安装依赖
Build application	执行 `node scripts/build.js --target aarch64-apple-darwin`
Upload artifacts	上传构建产物到 `artifacts-mac-arm64`

build-macos-x64.yml

运行环境: macos-latest

Target: x86_64-apple-darwin

步骤	说明
Checkout code	检出代码
Setup Node.js	配置 Node.js 20，启用 npm 缓存
Install Rust toolchain	安装 Rust 工具链及 x64 target
Cache Rust	缓存 Cargo 依赖加速构建
Install dependencies	执行 `npm ci` 安装依赖
Build application	执行 `node scripts/build.js --target x86_64-apple-darwin`
Upload artifacts	上传构建产物到 `artifacts-mac-x64`

build-linux.yml

运行环境: ubuntu-22.04

Target: x86_64-unknown-linux-gnu

步骤	说明
Checkout code	检出代码
Setup Node.js	配置 Node.js 20，启用 npm 缓存
Install Rust toolchain	安装 Rust 工具链及 Linux target
Cache Rust	缓存 Cargo 依赖加速构建
Install Linux dependencies	安装系统依赖（使用缓存）：libwebkit2gtk-4.1-dev, libayatana-appindicator3-dev, librsvg2-dev, patchelf, libgtk-3-dev
Install dependencies	执行 `npm ci` 安装依赖
Build application	执行 `node scripts/build.js --target x86_64-unknown-linux-gnu`
Upload artifacts	上传构建产物到 `artifacts-linux`

release.yml - release job

依赖: build-windows, build-macos-arm64, build-macos-x64, build-linux

运行环境: ubuntu-latest

权限: contents: write

步骤	说明
Download all artifacts	下载所有平台的构建产物（pattern: `artifacts-*`）并合并
List artifacts	列出产物文件（调试用）
Create Release	使用 `softprops/action-gh-release@v1` 创建 GitHub Release 并上传文件

构建矩阵总览

平台	运行环境	Target	Artifact 名称
Windows	`windows-latest`	`x86_64-pc-windows-msvc`	`artifacts-win`
macOS ARM	`macos-latest`	`aarch64-apple-darwin`	`artifacts-mac-arm64`
macOS Intel	`macos-latest`	`x86_64-apple-darwin`	`artifacts-mac-x64`
Linux	`ubuntu-22.04`	`x86_64-unknown-linux-gnu`	`artifacts-linux`

发布产物

平台	文件	说明
Windows	`*-win-x64-setup.exe`	NSIS 安装程序（推荐）
	`*-win-x64-portable.exe`	便携版
	`*-win-x64.msi`	MSI 安装程序
macOS	`*-mac-arm64.dmg`	Apple Silicon (M1/M2/M3)
	`*-mac-x64.dmg`	Intel
Linux	`*-linux-x64.deb`	Debian/Ubuntu
	`*-linux-x64.rpm`	Fedora/RHEL/CentOS
	`*-linux-x64.AppImage`	通用 AppImage

签名密钥配置

Tauri 应用签名私钥从项目中的 .keys/tauri-signing.key 文件读取。

优先级：

如果项目中存在 .keys/tauri-signing.key 文件，优先使用该文件内容
否则回退到 TAURI_SIGNING_PRIVATE_KEY 环境变量（来自 Secrets）

所需 Secrets

名称	用途
`TAURI_SIGNING_PRIVATE_KEY`	Tauri 应用签名私钥（备用，当 `.keys/tauri-signing.key` 不存在时使用）
`TAURI_SIGNING_PRIVATE_KEY_PASSWORD`	签名私钥密码（当前为空）
`GITHUB_TOKEN`	GitHub Release 创建（自动提供）

使用方法

发布新版本

# 创建并推送版本标签
git tag v1.0.0
git push origin v1.0.0

工作流将自动执行构建并创建 Release。

手动触发完整构建

在 GitHub Actions 页面，选择 Release 工作流，点击 "Run workflow"。

单独调试某平台构建

在 GitHub Actions 页面，选择对应平台的工作流，点击 "Run workflow"：

Build Windows - Windows x64 构建
Build macOS ARM64 - macOS Apple Silicon 构建
Build macOS x64 - macOS Intel 构建
Build Linux - Linux x64 构建

RELEASE-WORKFLOW.md 11 KB Permalink Lịch sử Raw