mirror of
https://github.com/wavetermdev/wails.git
synced 2026-08-05 13:53:43 -07:00
105 lines
4.5 KiB
Plaintext
105 lines
4.5 KiB
Plaintext
---
|
|
sidebar_position: 5
|
|
---
|
|
|
|
# 项目配置
|
|
|
|
项目配置在项目目录中的 `wails.json` 文件中。 配置的结构是：
|
|
|
|
```json5
|
|
{
|
|
// 项目配置版本
|
|
"version": "",
|
|
// 项目名称
|
|
"name": "",
|
|
// 包含编译资产的目录的相对路径，这通常是推断的并且可以留空
|
|
"assetdir": "",
|
|
// 触发重新加载的附加目录（逗号分隔），这仅用于某些高级资产配置
|
|
"reloaddirs": "",
|
|
// 构建文件所在的目录。默认为“build”
|
|
"build:dir": "",
|
|
// 前端目录的相对路径。默认为“frontend”
|
|
"frontend:dir": "",
|
|
// 安装 Node 依赖的命令，在前端目录运行 - 通常是`npm install`
|
|
"frontend:install": "",
|
|
// 构建资产的命令，在前端目录中运行 - 通常是 `npm run build`
|
|
"frontend:build": "",
|
|
// 此命令已被 frontend:dev:build 取代。如果未指定 frontend:dev:build 将回退到此命令。
|
|
// 如果此命令也未指定，将回退到 frontend:build
|
|
"frontend:dev": "",
|
|
// 此命令是 frontend:build 的 dev 等价物。
|
|
// 如果未指定回退到 frontend:dev
|
|
"frontend:dev:build": "",
|
|
// 此命令是 frontend:install 的 dev 等价物。如果未指定回退到 frontend:install
|
|
"frontend:dev:install": "",
|
|
// 此命令在 `wails dev`上的单独进程中运行。用于第 3 方观察者或启动 3d 方开发服务器
|
|
"frontend:dev:watcher": "",
|
|
// 用于服务资产的第 3 方开发服务器的 URL，比如 Vite。
|
|
// 如果设置为 'auto' 那么 devServerUrl 将从 Vite 输出中推断出来
|
|
"frontend:dev:serverUrl": "",
|
|
// 创建自动生成的 JS 模块的目录的相对路径
|
|
"wailsjsdir": "",
|
|
// 二进制文件的名称
|
|
"outputfilename": "",
|
|
// 开发服务器在检测到资产更改时等待重新加载的默认时间
|
|
"debounceMS": 100,
|
|
// 将 wails 开发服务器绑定到的地址。默认为：localhost:34115
|
|
"devServer": "",
|
|
// 在开发模式下以 shell 样式传递给应用程序的参数
|
|
"appargs": "",
|
|
// 定义是否应该运行构建 Hooks，尽管它们是为主机操作系统以外的操作系统定义的。
|
|
"runNonNativeBuildHooks": false,
|
|
// 构建前 Hooks
|
|
"preBuildHooks": {
|
|
// 在构建指定的 GOOS/GOARCH 之前将执行的命令：${platform} 被替换为“GOOS/GOARCH”。
|
|
// “GOOS/GOARCH” hook 在“GOOS/*”和“*/*” hook 之前执行。
|
|
"GOOS/GOARCH": "",
|
|
// 在指定 GOOS 的构建之前将执行的命令：${platform} 被替换为“GOOS/GOARCH”。
|
|
// “GOOS/*” hook 在“*/*” hook 之前执行。
|
|
"GOOS/*": "",
|
|
// 将在每次构建之前执行的命令：${platform} 替换为“GOOS/GOARCH”。
|
|
"*/*": ""
|
|
},
|
|
// 构建后 Hooks
|
|
"postBuildHooks": {
|
|
// 在构建指定的 GOOS/GOARCH 之后将执行的命令：${platform} 替换为“GOOS/GOARCH”，
|
|
// ${bin} 替换为已编译二进制文件的路径。 “GOOS/GOARCH” hook 在“GOOS/*”和“*/*” hook 之前执行。
|
|
"GOOS/GOARCH": "",
|
|
// 在构建指定的 GOOS 之后将执行的命令：${platform} 替换为“GOOS/GOARCH”，
|
|
// ${bin} 替换为已编译二进制文件的路径。 “GOOS/*” hook 在“*/*” hook 之前执行。
|
|
"GOOS/*": "",
|
|
// 每次构建后将执行的命令：${platform} 替换为“GOOS/GOARCH”，
|
|
// ${bin} 替换为已编译二进制文件的路径。
|
|
"*/*": ""
|
|
},
|
|
// 用于填充 manifest 和版本信息的数据。
|
|
"info": {
|
|
// 公司名称。 默认值：[项目名]
|
|
"companyName": "",
|
|
// 产品名称。 默认值：[项目名]
|
|
"productName": "",
|
|
// 产品版本。默认值：'1.0.0'
|
|
"productVersion": "",
|
|
// 产品的版权。默认值：'Copyright.........'
|
|
"copyright": "",
|
|
// 该应用程序的简短评论。默认值：'Built using Wails (https://wails.app)'
|
|
"comments": ""
|
|
},
|
|
// 'multiple': 每个架构一个安装程序。
|
|
// 'single': 适用于正在构建的所有体系结构的单一通用安装程序。
|
|
// 默认值：'multiple'
|
|
"nsisType": "",
|
|
// 应用程序是否应该被混淆。默认值：false
|
|
"obfuscated": "",
|
|
// 使用 obfuscated 标志时传递给乱码命令的参数
|
|
"garbleargs": ""
|
|
}
|
|
|
|
```
|
|
|
|
该文件将在运行 `wails build` 或 `wails dev` 时，由 Wails CLI 读取。
|
|
|
|
`wails build/dev` 命令中的 `assetdir`、`reloaddirs`、`wailsjsdir`、`debounceMS`、`devserver` 和 `frontenddevserverurl` 标志将覆盖项目配置并作为后续运行的默认值。
|
|
|
|
此文件的 `JSON Schema` 位于 [此处](https://wails.io/schemas/config.v2.json)。
|