Go wv(WebView2) GUI框架介绍和使用

说明

wv(webview2) 是Go语言基于LCL和WebView2基础上封装的框架,用于开发Windows GUI软件。

介绍

LCL(Lazarus Component Library) :跨平台原生UI组件库.

wv(WebView2): Microsoft Edge WebView2 控件允许在本机应用中嵌入 web 技术(HTML、CSS 以及 JavaScript)。 WebView2 控件使用 Microsoft Edge 作为绘制引擎,以在本机应用中显示 web 内容

WebView2使用 [WebView4Delphi] 得益于封装(https://github.com/salvadordf/WebView4Delphi) ,并做为LCL中的一个控件使用.

限制

依赖

  • Golang >= 1.20
  • Webview2 运行时环境, Windows10/11一搬不需要安装
  • liblcl.dll LCL控件库动态链接库, 绑定库.

环境准备

创建目录并初始化Golang为工作空间

  • mkdir demoworkspace
  • cd demoworkspace
  • go work init

获取&克隆 lclwv 仓库

go 复制代码
go work use lcl
go work use wv

获取 WebView2 和 liblcl.dll

说明

  • 创建任意目录并设置到 ENERGY_HOME 环境变量, 并将两个动态链接库放置到该环境变量目录
  • 或把两个动态链接库放置到Go编译的二进制.exe同一目录

环境总结

  1. 将lcl和wv仓库克隆到本地的Golang工作空间目录
  2. 下载依赖的动态链接库 WebView2 和 liblcl.dll
  3. Golang >= 1.20

创建自己应用

在工作空间目录 demoworkspace 创建自己的Go项目做为GUI应用, 并添加到工作空间

go 复制代码
mkdir demo
cd demo
go mod init demo
cd ../
go work use demo
示例代码
go 复制代码
package main

import (
	"fmt"
	"github.com/energye/lcl/api/libname"
	"github.com/energye/lcl/lcl"
	"github.com/energye/lcl/tools/exec"
	"github.com/energye/lcl/types"
	"github.com/energye/wv/wv"
	"path/filepath"
)

var (
	mainForm TMainForm    // 主窗口
	load     wv.IWVLoader // webview2 loader
)

func main() {
	wv.Init(nil, nil)
	load = wv.GlobalWebView2Loader()
	liblcl := libname.LibName
	webView2Loader, _ := filepath.Split(liblcl)
	webView2Loader = filepath.Join(webView2Loader, "WebView2Loader.dll")
	load.SetUserDataFolder(filepath.Join(exec.CurrentDir, "EnergyCache"))
	load.SetLoaderDllPath(webView2Loader)
	if load.StartWebView2() {
		// 底层库全局异常
		lcl.Application.SetOnException(func(sender lcl.IObject, e lcl.IException) {
			fmt.Println("全局-底层库异常:", e.ToString())
		})
		lcl.Application.Initialize()
		lcl.Application.SetMainFormOnTaskBar(true)
		lcl.Application.CreateForm(&mainForm)
		lcl.Application.Run()
	}
}

type TMainForm struct {
	lcl.TForm
	windowParent wv.IWVWindowParent
	browser      wv.IWVBrowser
}

func (m *TMainForm) FormCreate(sender lcl.IObject) {
	m.SetCaption("Go wv(Webview2) - demo") // 窗口标题
	m.SetBounds(0, 0, 800, 600)            // 窗口大小
	m.WorkAreaCenter()                     // 屏幕居中
	// webview2 window组件
	m.windowParent = wv.NewWVWindowParent(m)
	m.windowParent.SetParent(m)
	m.windowParent.SetAlign(types.AlClient)
	// webview2 browser组件
	m.browser = wv.NewWVBrowser(m)
	m.browser.SetDefaultURL("https://www.baidu.com") // 指定一个要加载的地址
	m.browser.SetOnAfterCreated(func(sender lcl.IObject) {
		// browser创建完成后刷新 window组件大小
		m.windowParent.UpdateSize()
	})
	// 设置browser到window parent
	m.windowParent.SetBrowser(m.browser)
	// 窗口显示事件, 创建browser
	m.SetOnShow(func(sender lcl.IObject) {
		if load.InitializationError() {
		} else {
			if load.Initialized() {
				m.browser.CreateBrowser(m.windowParent.Handle(), true)
			}
		}
	})
}
Go WebView2效果

Go WebView2 架构

相关推荐
萧鼎1 小时前
深入理解 Python Scapy 库:网络安全与协议分析的瑞士军刀
开发语言·python·web安全
bobz9653 小时前
5070 Ti CodeLlama 7B > Mistral 7B > Qwen3 8B
后端
阿拉丁的梦3 小时前
教程1:用vscode->ptvsd-创建和调试一个UI(python)-转载官方翻译(有修正)
开发语言·python
木宇(记得热爱生活)3 小时前
一键搭建开发环境:制作bash shell脚本
开发语言·bash
麦兜*3 小时前
Spring Boot 集成 Docker 构建与发版完整指南
java·spring boot·后端·spring·docker·系统架构·springcloud
Cisyam^3 小时前
Go环境搭建实战:告别Java环境配置的复杂
java·开发语言·golang
程序视点3 小时前
2025最佳图片无损放大工具推荐:realesrgan-gui评测与下载指南
前端·后端
IAR Systems4 小时前
在IAR Embedded Workbench for Arm中实现Infineon TRAVEO™ T2G安全调试
开发语言·arm开发·安全·嵌入式软件开发·iar
jayzhang_5 小时前
SPARK入门
大数据·开发语言
蹦极的考拉5 小时前
网站日志里面老是出现{pboot:if((\x22file_put_co\x22.\x22ntents\x22)(\x22temp.php\x22.....
android·开发语言·php