跳到主要内容
版本:下个版本 🚧

项目配置

项目配置在项目目录中的 wails.json 文件中。 配置的结构是:

{
// 项目配置版本
"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 buildwails dev 时,由 Wails CLI 读取。

wails build/dev 命令中的 assetdirreloaddirswailsjsdirdebounceMSdevserverfrontenddevserverurl 标志将覆盖项目配置并作为后续运行的默认值。

此文件的 JSON Schema 位于 此处