Wails是一个使用Go和Web技术编写跨平台桌面应用的框架
一、功能
- 原生菜单、对话框、主题和半透明
- Windows、macOS和linux支持
- 内置Svelte、React、Preact、Vue、Lit和Vanilla JS的模板
- 从JavaScript轻松调用Go方法
- 自动将Go结构体转换为TypeScript模块
- Windows上不需要CGO或外部DLL
- 使用Vite的实时开发模式
- 可以轻松创建、构建和打包应用的强大命令行工具
- 丰富的运行时库
- 使用Wails构建的应用程序兼容Apple和Microsoft商店
二、安装
支持的平台
- Windows 10/11 AMD64/ARM64
- MacOS 10.13+ AMD64
- MacOS 11.0+ ARM64
- Linux AMD64/ARM64
依赖
- Go 1.18+
- NPM (Node 15+)
运行命令go version和npm --version检查依赖是否安装,除了以上外,还需要安装特定平台的依赖:
- Windows平台需要WebView2(系统默认安装)
- Macos平台需要安装xcode命令行工具
- Linux 需要标准的gcc构建工具以及libgtk3和libwebkit 还可选以下依赖
- UPX:用于压缩您的应用程序
- NSIS:用于生成Windows安装程序
安装Wails
go install github.com/wailsapp/wails/v2/cmd/wails@latest
运行wails doctor将检查您是否安装了正确的依赖项
三、开发
1、初始化项目
CLI已安装,可以使用wails init命令生成一个新项目
wails init -n myproject -t react
除了react外,还支持更多前端框架:Svelte、React、Vue、Preact、Lit、Vanilla
项目结构概要
- /main.go 主应用
- /frontend/ 前端项目文件
- /build/ 项目构建目录
- /build/appicon.png 应用程序图标
- /build/darwin/ Mac特定的项目文件
- /build/windows/ Windows特定的项目文件
- /wails.json 项目配置
- /go.mod Go module文件
- /go.sum Go module校验文件
接下来可以修改go程序和前端代码实现功能,使用wails dev在开发模式下运行您的应用程序
2、编译项目
运行wails build编译项目并将构建的可用于生产的二进制文件保存在build/bin目录中,更多可选参数:
-platform:为指定的平台(逗号分割)构建,如:windows/arm64、windows/arm64
-upx:使用“upx”压缩最终二进制文件
-clean:清理build/bin目录
四、原理
Wails应用程序是一个带有一个webkit前端的标准的Go应用程序。 应用程序的Go部分由应用程序代码和一个运行时库组成,该库提供了许多有用的操作,例如控制应用程序窗口。前端是一个webkit窗口,将显示前端资源。前端还可以使用运行时库的JavaScript版本。最后,可以将Go方法绑定到前端,这些将显示为可以调用的JavaScript方法,就像它们是原生JavaScript方法一样。

更多内容参考官方文档