SuperAPI AI 工具集

wails

编程与开发

查看项目

更新于 10-15 19:50

技能介绍

用途:Wails 是用 Go 编写、以 WebView 作为前端的桌面应用框架。本技能覆盖 Wails 应用的搭建、开发、运行时 API 与构建流程,适合应用创建、本地开发、构建问题排查与 CLI 使用。

前提与初始化:需要 Go 1.21+、Node/NPM 及平台依赖(xcode、WebView2、GTK/WebKit)。安装命令:go install github.com/wailsapp/wails/v2/cmd/wails@latest。用 wails doctor 检查依赖,用 wails init -n myproject -t <template> 创建项目并选择模板。

开发与构建:wails dev 启动开发模式,浏览器开发服务器地址为 http://localhost:34115;wails build 生成生产二进制,Linux 新发行版可能需要 -tags webkit2_41。CLI 还支持 wails generate module 重新生成 wailsjs,以及 wails generate template 生成模板。

主要能力:运行时 API 分事件(EventsOn、EventsOnce、EventsOnMultiple、EventsOff、EventsEmit)、日志(LogTrace 至 LogFatal、LogSetLogLevel)、窗口、对话框与菜单(仅 Go)、浏览器打开、剪贴板、屏幕列表、文件拖放(需 EnableFileDrop)。Go 绑定方法经自动生成的 wailsjs 模块暴露给 JS。

配置与集成:wails.json 可设置前端目录与构建脚本、assetdir、dev server URL、构建标签、hooks、协议与文件关联等。默认注入 /wails/ipc.js 与 /wails/runtime.js,可用 meta 标签关闭自动注入改手动注入。外部开发服务器需配置 frontend:dev:watcher 与 frontend:dev:serverUrl。

限制与注意:菜单与消息对话框仅 Go 可用;路由建议使用 hash 路由;无边框窗口用 --wails-draggable:drag/no-drag;混淆构建用 -obfuscated,并依赖生成的 wailsjs 绑定。具体版本、平台差异与签名打包细节建议查阅官方文档。