命令行

命令行

Wails CLI 有许多用于管理项目的命令。 所有命令都以此方式运行：

wails <命令> <标志>

初始化

wails init 用于生成项目。

示例： wails init -n test -d mytestproject -g -ide vscode -q

这将在 “mytestproject” 目录生成一个名为 “test” 的项目，初始化 git，生成 vscode 项目文件并静默执行。

可以在 此处 找到有关在 Wails 中使用 IDE 的更多信息。

远程模板

支持远程模板（托管在 GitHub ）并且可以使用模板项目的 URL 进行安装。

示例： wails init -n test -t https://github.com/leaanthony/testtemplate[@v1.0.0]

可以在 此处 找到社区维护的模板列表

注意

Wails 项目不维护也不对第 3 方模板负责

如果您不确定某个模板，请检查 package.json 和 wails.json 中安装的模块和运行的脚本。

构建

wails build 用于将您的项目编译为生产可用的二进制文件。

有关 webview2 标志的详细描述，请参阅 Windows 系统指南。

如果您更喜欢使用标准 Go 工具进行构建，请参阅 手动构建指南。

示例：

wails build -clean -o myproject.exe

信息

在 Mac 上，应用程序将被绑定到 Info.plist，而不是 Info.dev.plist。

苹果芯片上的 UPX

在苹果芯片上使用 UPX 相关的 问题。

Windows 上的 UPX

一些防病毒软件供应商误将 upx 压缩的二进制文件标记为病毒，请查看相关 问题。

平台

支持的平台有：

诊断检查

wails doctor 将运行诊断程序以确保您的系统已准备好进行开发。

示例：

Wails CLI v2.0.0-beta

Scanning system - Please wait (this may take a long time)...Done.

System
------
OS:             Windows 10 Pro
Version:        2009 (Build: 19043)
ID:             21H1
Go Version:     go1.18
Platform:       windows
Architecture:   amd64

Dependency      Package Name    Status          Version
----------      ------------    ------          -------
WebView2        N/A             Installed       93.0.961.52
npm             N/A             Installed       6.14.15
*upx            N/A             Installed       upx 3.96

* - Optional Dependency

Diagnosis
---------
Your system is ready for Wails development!

开发

wails dev 用于以 “实时开发” 模式运行您的应用。 这意味着：

• 应用程序的 go.mod 将被更新为与 Wails CLI 相同的版本
• 应用程序被编译并自动运行
• 一个观察者被启动，如果它检测到您的 go 文件的变化，它将触发您的开发应用程序的重新构建
• 启动一个网络服务器 http://localhost:34115，通过 http 为您的应用程序（不仅仅是前端）提供服务。 这允许您使用您喜欢的浏览器开发扩展
• 所有应用程序资源都从磁盘加载。 如果它们被更改，应用程序将自动重新加载（而不是重新构建）。 所有连接的浏览器也将重新加载
• 生成的 JS 模块提供以下内容：
• 带有自动生成的 JSDoc 的 Go 方法的 JavaScript 包装器，提供代码提示
• 您的 Go 结构的 TypeScript 版本，可以构建并传递给您的 go 方法
• 生成第二个 JS 模块，为运行时提供包装器 + TS 声明
• 在 macOS 上，它将应用程序捆绑到一个 .app 文件中并运行它。 开发模式将使用 build/darwin/Info.dev.plist 。

示例：

wails dev -assetdir ./frontend/dist -wailsjsdir ./frontend/src -browser

此命令将执行以下操作：

• 构建应用程序并运行它（更多细节在 这里）
• 在 ./frontend/src 中生成 Wails JS 模块
• 监听 ./frontend/dist 中文件的更新并在更改时重新加载
• 打开浏览器并连接到应用程序

有更多关于在现有框架脚本中使用此功能的 信息。

生成

模板

Wails 使用模板来生成项目。 wails generate template 命令有助于构建模板，以使它可以用于生成项目。

有关创建模板的更多详细信息，请参阅 模板指南。

模块

wails generate module 命令允许您为应用程序手动生成 wailsjs 目录。

更新

wails update 将更新 Wails CLI 的版本。

版本

wails version 仅输出当前的 CLI 版本。