OpenCowork
开发指南

构建与打包

构建 OpenCowork 生产版本并打包为各平台安装包。

构建与打包 / Building & Packaging

构建命令 / Build Commands

# 类型检查 + 构建(推荐)
npm run build

# 构建 + 打包 Windows 安装包
npm run build:win

# 构建 + 打包 macOS 安装包
npm run build:mac

# 构建 + 打包 Linux 安装包
npm run build:linux

构建产物 / Build Artifacts

打包完成后,安装包位于 dist/ 目录:

平台文件
WindowsOpenCowork-x.x.x-setup.exe
macOSOpenCowork-x.x.x.dmg
LinuxOpenCowork-x.x.x.AppImage

构建工具 / Build Tools

  • electron-vite:统一的 Vite 构建配置,支持主进程、预加载、渲染进程
  • electron-builder:打包为各平台安装包
  • better-sqlite3:作为外部依赖处理(不打包进 renderer bundle)

自动更新 / Auto Update

OpenCowork 集成了 GitHub Releases 自动更新:

  • 应用启动时检查新版本
  • 后台下载更新包
  • 提示用户重启安装

更新配置在 electron-builder.yml 中:

publish:
  provider: github
  owner: AIDotNet
  repo: OpenCowork

环境变量 / Environment Variables

构建时可以通过环境变量配置:

变量说明
VITE_APP_VERSION应用版本号
GH_TOKENGitHub Token(用于发布 Release)

On this page