跳至主要内容
版本: v2.9.0

安装

支持的平台​

  • Windows 10/11 AMD64/ARM64
  • MacOS 10.13+ AMD64
  • MacOS 11.0+ ARM64
  • Linux AMD64/ARM64

依赖项​

Wails 在安装之前需要一些常见的依赖项

  • Go 1.20+
  • NPM (Node 15+)

Go​

从 Go 下载页面 下载 Go。

确保您遵循官方的 Go 安装说明。您还需要确保您的 PATH 环境变量也包含 ~/go/bin 目录的路径。重启您的终端并进行以下检查

  • 检查 Go 是否已正确安装: go version
  • 检查 "~/go/bin" 是否在您的 PATH 变量中: echo $PATH | grep go/bin

NPM​

从 Node 下载页面 下载 NPM。最好使用最新版本，因为我们通常会针对最新版本进行测试。

运行 npm --version 进行验证。

平台特定依赖项​

您还需要安装平台特定的依赖项

Wails 需要安装 WebView2 运行时。一些 Windows 安装已经安装了它。您可以使用 wails doctor 命令进行检查。

可选依赖项​

  • UPX 用于压缩您的应用程序。
  • NSIS 用于生成 Windows 安装程序。

安装 Wails​

运行 go install github.com/wailsapp/wails/v2/cmd/wails@latest 以安装 Wails CLI。

注意：如果您遇到类似于以下错误

....\Go\pkg\mod\github.com\wailsapp\wails\[email protected]\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found

请检查您是否已安装 Go 1.18+

go version

系统检查​

运行 wails doctor 将检查您是否已安装正确的依赖项。如果没有，它将建议缺少什么以及如何解决任何问题。

wails 命令似乎不见了？​

如果您的系统报告 wails 命令丢失，请确保您已正确遵循 Go 安装指南。通常，这意味着您用户主目录中的 go/bin 目录不在 PATH 环境变量中。您通常还需要关闭并重新打开任何打开的命令提示符，以便命令提示符反映安装程序对环境所做的更改。