Wails 框架

星期日, 8月 27, 2023 | 3分钟阅读 | 更新于 星期日, 8月 27, 2023

@

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方法一样。 Wails 架构

更多内容参考官方文档

© 2026 我的博客

🌱 Powered by Hugo with theme Dream.

关于这个博客

关于博客

记录软件开发过程的一些知识和技巧,提升自我

关于博主

除了才华一无所有~~ 薪尽自然凉~~ 强迫症患者~~ 热爱古风~~