跳转到主要内容

​
💡 构建产物路径

平台构建产物路径
Windows[项目根目录]/packages/desktop/src-tauri/target/release/bundle/msi/xxx.msi
Windows[项目根目录]/packages/desktop/src-tauri/target/release/bundle/nsis/xxx.exe
macOS[项目根目录]/packages/desktop/src-tauri/target/release/bundle/dmg/
macOS 安装提示如果提示包已损坏，请在终端中输入以下命令，然后输入密码回车即可重新打开：
sudo xattr -r -d com.apple.quarantine [安装包路径]

​
图标修改

官方推荐使用 icns-generator 工具生成图标。
1

安装工具

安装官方图标生成工具：
npm install -g icns-generator
检查是否安装成功（输出版本号 1.1.x 则说明安装成功）：
icns-generator --version
2

准备图标

创建一个名为 icons 的目录，将准备好的图标（png/jpg/jpeg，建议 1024x1024）命名为 icon.png 放入该目录。
3

生成图标

在终端进入 icons 目录并执行：
icns-generator --input icon.png
执行后会生成 output 目录，包含以下文件：
icons
├── icon.iconset
│   ├── icon_32x32.png
│   ├── icon_128x128.png
│   ├── icon_128x128@2x.png
│   └── icon_xxx.png
└── icons
    ├── 32x32.png
    ├── 128x128.png
    ├── 128x128@2x.png
    ├── xxx.png
    ├── icon.ico
    └── icon.icns（macOS专属，Windows系统不会生成）
4

替换图标

复制以下文件至 [项目根目录]/packages/desktop/src-tauri/icons 目录下替换默认图标：
  • icon.ico
  • icon.icns（Windows 不需要）
  • icon_32x32.png
  • icon_128x128.png
  • icon_128x128@2x.png
5

重新构建

修改完成后需要重新构建才能生效：
pnpm build:desktop

​
修改配置

​
修改窗口标题与应用包名

如果你想修改桌面应用窗口标题（以及应用包名），请编辑 src-tauri/tauri.conf.json：
src-tauri/tauri.conf.json
{
  "productName": "BuildingAI",
  "app": {
    "windows": [
      {
        "title": "BuildingAI"
      }
    ]
  }
}
  • 修改 productName 可以更改系统与安装器里显示的应用名称。
  • 修改 app.windows[0].title 可以更改窗口标题栏中显示的标题。
修改完成后执行构建： 
pnpm build:desktop

​
打包线上部署地址

如果想让桌面应用打开一个线上网站（例如 https://你的项目线上部署地址）：
  1. 编辑 src-tauri/tauri.conf.json：
src-tauri/tauri.conf.json
{
  "build": {
    "devUrl": "http://localhost:4090",
    "frontendDist": "https://你的项目线上部署地址",
    "beforeDevCommand": "pnpm run prepare",
    "beforeBuildCommand": "pnpm run prepare"
  }
}
  1. 执行构建：
pnpm build:desktop
此时 frontendDist 是 URL，prepare-frontend.js 会跳过修改，直接使用远程地址。

​
打包本地静态资源

如果想把前端构建产物一起打包进桌面应用：
  1. 设置 src-tauri/tauri.conf.json 中的 frontendDist 为本地目录路径：
src-tauri/tauri.conf.json
{
  "build": {
    "devUrl": "http://localhost:4090",
    "frontendDist": "../../../public/web",
    "beforeDevCommand": "pnpm run prepare",
    "beforeBuildCommand": "pnpm run prepare"
  }
}
  1. 执行构建：
pnpm build:desktop
此时 frontendDist 是本地目录，prepare-frontend.js 会自动在 public/web 和 public 之间选择，并写回配置。

​
项目配置详解

桌面应用的核心配置在 src-tauri/tauri.conf.json 中，主要字段说明如下：
  • $schema：Tauri 配置的 schema 地址，用于 IDE 校验和自动补全。
  • productName：应用产品名称，安装器和系统中显示的名称。
  • version：应用版本号字符串。
  • identifier：应用唯一标识（类似 bundle id），如 buildingai.desktop。
  • build.devUrl：开发模式加载的地址（通常是本地 dev server）。
  • build.frontendDist：
    • 设置为远程 URL 时，桌面应用会直接打开线上网站；
    • 设置为本地目录时，会把静态资源打包到应用中。
  • build.beforeDevCommand：启动开发调试前执行的命令（例如前端预处理）。
  • build.beforeBuildCommand：构建桌面安装包前执行的命令。
  • app.windows：窗口配置列表：
    • title：窗口标题。
    • width / height：初始窗口宽高。
    • minWidth / minHeight：窗口最小尺寸限制。
    • devtools：开发环境是否允许打开 DevTools。
    • center：启动时是否居中显示窗口。
  • app.security.csp：Content Security Policy，null 表示使用 Tauri 默认策略。
  • bundle.active：是否启用打包（生成安装包）。
  • bundle.targets：打包目标平台（例如 all 表示所有支持的平台）。
  • bundle.icon：不同平台和分辨率使用的图标文件列表。
根据需要调整这些字段后，执行以下命令重新构建桌面应用： 
pnpm build:desktop