Clash Party 桌面客户端打包指南：从源码到全平台安装包

clash-party/
├─ public/                # 静态资源（图标、网页入口文件等）
├─ src/                   # 前端代码（Vue/React + TypeScript）
│   ├─ renderer/          # 渲染进程（UI）
│   └─ main/              # 主进程（Electron 主入口）
├─ build/                 # 打包脚本、electron-builder 配置
├─ electron-builder.yml   # electron‑builder 配置文件
├─ package.json
└─ ...                    # 其他

# 1. 克隆仓库
git clone https://github.com/zdltech8989/clash-party.git
cd clash-party

# 2. 安装依赖。这里推荐使用 pnpm（速度更快），也可以用 npm/yarn
# 如果系统没有 pnpm，先装一下：
npm i -g pnpm

# 安装项目依赖
pnpm install

# 生产环境构建（默认输出到 dist/renderer）
pnpm run build:renderer
# 也可能是：
# pnpm run build   # 如果 package.json 中只有一个 build 脚本

appId: com.zdltech.clash-party
productName: Clash Party
copyright: © 2024 zdltech
directories:
  output: release   # 打包产物的输出目录
  buildResources: build   # 图标、NSIS 脚本等资源所在目录
files:
  - dist/**        # 前端编译产物
  - src/main/**    # Electron 主进程源码
  - node_modules/**  # 依赖
  - package.json
  - !**/*.map      # 可选：不打包 source map
  - !test/**       # 不打包测试代码
win:
  target:
    - nsis
    - zip
  icon: build/icon.ico
mac:
  target:
    - dmg
    - zip
  icon: build/icon.icns
linux:
  target:
    - AppImage
    - deb
    - rpm
  icon: build/icon.png

{
  "scripts": {
    "build": "pnpm run build:renderer && electron-builder",
    "build:win": "pnpm run build && electron-builder --win",
    "build:mac": "pnpm run build && electron-builder --mac",
    "build:linux": "pnpm run build && electron-builder --linux",
    "publish": "electron-builder --publish always"
  }
}

# 1. 完整构建（自动执行 renderer 构建 + electron-builder）
pnpm run build:win
# 或者逐步：
pnpm run build:renderer   # 只编译前端
pnpm run build:win        # 只执行 electron-builder

pnpm run build:mac

pnpm run build:linux

sudo apt install -y \
  libgtk-3-0 libnotify4 libnss3 libxss1 libasound2 \
  libx11-xcb1 libxkbfile1 libsecret-1-0 \
  fakeroot rpm # 若要生成 .deb/.rpm

name: Build & Release

on:
  push:
    tags:
      - "v*"

jobs:
  build-windows:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'pnpm'
      - name: Install pnpm
        run: npm i -g pnpm
      - name: Install deps
        run: pnpm install
      - name: Build & Package
        run: pnpm run build:win
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: windows
          path: release/*

  build-mac:
    runs-on: macos-14   # Apple Silicon, 仍然可以运行 Intel 二进制
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'pnpm'
      - name: Install pnpm
        run: npm i -g pnpm
      - name: Install deps
        run: pnpm install
      - name: Build & Package
        env:
          CSC_LINK: ${{ secrets.MAC_CERT_P12 }}
          CSC_KEY_PASSWORD: ${{ secrets.MAC_CERT_PASSWORD }}
          APPLE_ID: ${{ secrets.APPLE_ID }}
          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
        run: pnpm run build:mac
      - uses: actions/upload-artifact@v4
        with:
          name: macos
          path: release/*

  build-linux:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'pnpm'
      - name: Install pnpm
        run: npm i -g pnpm
      - name: Install deps
        run: pnpm install
      - name: Install Linux build tools
        run: |
          sudo apt-get update
          sudo apt-get install -y libgtk-3-0 libnotify4 libnss3 libxss1 libasound2 fakeroot rpm
      - name: Build & Package
        run: pnpm run build:linux
      - uses: actions/upload-artifact@v4
        with:
          name: linux
          path: release/*

# 1️⃣ 克隆仓库
git clone https://github.com/zdltech8989/clash-party.git
cd clash-party

# 2️⃣ 安装 pnpm + 依赖
npm i -g pnpm
pnpm install

# 3️⃣ 前端编译（一次即可，所有平台共用）
pnpm run build:renderer

# 4️⃣ 打包 Windows （本机）
pnpm run build:win

# 5️⃣ 打包 macOS（交叉，需 wine）
sudo apt-get install -y wine64
pnpm run build:mac --win

# 6️⃣ 打包 Linux（本机）
pnpm run build:linux

# 7️⃣ 查看产物
ls release/