@yufengtadian/freedom-cli 1.12.1 → 1.12.12

package/templates/go/pkg/freedom/window_windows.go

@@ -3,9 +3,16 @@
 package freedom
 
 import (
+	"bytes"
+	"encoding/base64"
+	"encoding/binary"
 	"fmt"
+	"image"
+	"image/color"
+	"image/png"
 	"syscall"
-	"unsafe"
+
+	"golang.org/x/sys/windows"
 )
 
 // 进程级 DPI 感知：让窗口坐标 / WebView 渲染统一按物理像素工作。
@@ -27,6 +34,7 @@ func init() {
 
 var (
 	user32win = syscall.NewLazyDLL("user32.dll")
+	kernel32  = syscall.NewLazyDLL("kernel32.dll")
 
 	procGetWindowLongPtr = user32win.NewProc("GetWindowLongPtrW")
 	procSetWindowLongPtr = user32win.NewProc("SetWindowLongPtrW")
@@ -35,22 +43,41 @@ var (
 	procSetWindowPos     = user32win.NewProc("SetWindowPos")
 	procSetWindowText    = user32win.NewProc("SetWindowTextW")
 	procPostMessage      = user32win.NewProc("PostMessageW")
+	procGetModuleHandle  = kernel32.NewProc("GetModuleHandleW")
+	procLoadImage        = user32win.NewProc("LoadImageW")
+	procGetSystemMetrics = user32win.NewProc("GetSystemMetrics")
+	procSendMessage      = user32win.NewProc("SendMessageW")
+	procReleaseCapture   = user32win.NewProc("ReleaseCapture")
+	procGetWindowRect    = user32win.NewProc("GetWindowRect")
+	procMonitorFromWindow = user32win.NewProc("MonitorFromWindow")
+	procGetMonitorInfo   = user32win.NewProc("GetMonitorInfoW")
+	procMoveWindow       = user32win.NewProc("MoveWindow")
+
+	procDestroyIcon = user32win.NewProc("DestroyIcon")
 
 	dwmapi                     = syscall.NewLazyDLL("dwmapi.dll")
 	procDwmExtendFrameIntoArea = dwmapi.NewProc("DwmExtendFrameIntoClientArea")
 )
 
 const (
-	wsCaption   = 0x00C00000 // WS_CAPTION = WS_BORDER | WS_DLGFRAME
-	wsSysMenu   = 0x00080000
+	wsCaption    = 0x00C00000 // WS_CAPTION = WS_BORDER | WS_DLGFRAME
+	wsSysMenu    = 0x00080000
 	wsThickFrame = 0x00040000
 
-	wmClose     = 0x0010 // WM_CLOSE：请求窗口正常关闭（触发 GoWnd 的关闭回调）
-	swHide      = 0
-	swShow      = 5
-	swMinimize  = 6
-	swRestore   = 9
-	swMaximize  = 3
+	wmClose   = 0x0010 // WM_CLOSE：请求窗口正常关闭（触发 GoWnd 的关闭回调）
+	wmSetIcon = 0x0080 // WM_SETICON：设置窗口大/小图标（ICON_BIG=1 / ICON_SMALL=0）
+
+	rtIcon     = 3 // RT_ICON 资源类型（rcedit 注入图标二进制）
+	swHide     = 0
+	swShow     = 5
+	swMinimize = 6
+	swRestore  = 9
+	swMaximize = 3
+
+	smCXIcon  = 11 // SM_CXICON
+	smCYIcon  = 12 // SM_CYICON
+	smCXSmall = 13 // SM_CXSMICON
+	smCYSmall = 14 // SM_CYSMICON
 
 	swpFrameChanged = 0x0020
 	swpNoMove       = 0x0002
@@ -82,7 +109,8 @@ func refreshFrame(hwnd uintptr) {
 }
 
 // windowControl 处理前端 window.freedom.window.* 请求（Windows 实现）。
-func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{}, error) {
+func windowControl(a *App, action string) (interface{}, error) {
+	hwnd := a.WindowHandle()
 	if hwnd == 0 {
 		return nil, fmt.Errorf("window not ready")
 	}
@@ -91,16 +119,16 @@ func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{},
 		procShowWindow.Call(hwnd, swMinimize)
 		return nil, nil
 	case "maximize":
-		procShowWindow.Call(hwnd, swMaximize)
+		maximizeWindow(hwnd)
 		return nil, nil
 	case "unmaximize", "restore":
-		procShowWindow.Call(hwnd, swRestore)
+		restoreWindow(hwnd)
 		return nil, nil
 	case "toggleMaximize":
-		if isZoomed(hwnd) {
-			procShowWindow.Call(hwnd, swRestore)
+		if isWindowMaximized(hwnd) {
+			restoreWindow(hwnd)
 		} else {
-			procShowWindow.Call(hwnd, swMaximize)
+			maximizeWindow(hwnd)
 		}
 		return nil, nil
 	case "close":
@@ -109,14 +137,101 @@ func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{},
 		procPostMessage.Call(hwnd, wmClose, 0, 0)
 		return nil, nil
 	case "isMaximized":
-		return isZoomed(hwnd), nil
+		return isWindowMaximized(hwnd), nil
 	case "isFrameless":
-		return mode == TitleBarFrameless || mode == TitleBarHidden, nil
+		return a.cfg.TitleBar == TitleBarFrameless, nil
+	case "appIcon":
+		// 从 exe 内嵌图标（PE 资源 ID=1）提取，转为 PNG data URL 供前端标题栏显示。
+		// 不依赖 resources 文件夹里的任何图标文件。
+		return exeAppIconDataURL(), nil
+	case "startDrag":
+		// 前端标题栏 mousedown 时发起窗口拖动（WM_NCLBUTTONDOWN + HTCAPTION）。
+		// 相比 -webkit-app-region: drag，可保留双击最大化 / 右键菜单等页面事件。
+		procReleaseCapture.Call()
+		procSendMessage.Call(hwnd, 0x00A1 /*WM_NCLBUTTONDOWN*/, 2 /*HTCAPTION*/, 0)
+		return nil, nil
 	default:
 		return nil, fmt.Errorf("unknown window action %q", action)
 	}
 }
 
+// maximizeWindow 最大化窗口。
+// 直接走系统 SW_MAXIMIZE：壳层（webview_go fork）在 WndProc 的 WM_GETMINMAXINFO 中
+// 已把无边框窗口的最大化边界限定到监视器工作区（rcWork），
+// 因此"最大化 = 铺满任务栏上方的工作区"，而非 F11 式整屏全屏。
+func maximizeWindow(hwnd uintptr) {
+	procShowWindow.Call(hwnd, swMaximize)
+}
+
+// restoreWindow 还原窗口（系统 SW_RESTORE，恢复到最大化前的位置与尺寸）。
+func restoreWindow(hwnd uintptr) {
+	procShowWindow.Call(hwnd, swRestore)
+}
+
+// isWindowMaximized 判断窗口当前是否处于最大化状态。
+func isWindowMaximized(hwnd uintptr) bool {
+	return isZoomed(hwnd)
+}
+
+// exeIconData 读取当前 exe 内嵌的 RT_ICON 资源原始字节（rcedit 注入时资源 ID=1）。
+// 不依赖 RT_GROUP_ICON 的 ID（rcedit 固定写入 0，而 LoadImageW 按硬编码 ID 加载会失败），
+// 直接取 RT_ICON 二进制，兼容任意注入工具。
+// 使用 x/sys/windows 类型化 API（LoadResourceData 直接返回字节副本，无需 unsafe 指针转换）。
+func exeIconData() []byte {
+	var hInst windows.Handle
+	if err := windows.GetModuleHandleEx(0, nil, &hInst); err != nil {
+		return nil
+	}
+	// FindResourceW(hModule, MAKEINTRESOURCE(1), MAKEINTRESOURCE(RT_ICON))
+	resInfo, err := windows.FindResource(hInst, windows.ResourceID(1), windows.ResourceID(rtIcon))
+	if err != nil {
+		return nil
+	}
+	data, err := windows.LoadResourceData(hInst, resInfo)
+	if err != nil {
+		return nil
+	}
+	return data
+}
+
+// isPNG 判断字节流是否为 PNG 编码（rcedit 注入的 .ico 内嵌 PNG 时 RT_ICON 数据即 PNG）。
+func isPNG(b []byte) bool {
+	return len(b) >= 8 && b[0] == 0x89 && b[1] == 'P' && b[2] == 'N' && b[3] == 'G'
+}
+
+// loadExeIcon 从 exe 内嵌的 RT_GROUP_ICON 资源加载 HICON。
+// rcedit 注入的 group icon 资源 ID 固定为 0（LoadImageW 需按该 ID 加载；
+// 历史按 ID=1 硬编码导致加载失败，故此处显式用 0）。
+// 调用方用完须 procDestroyIcon 释放；加载失败返回 0。
+func loadExeIcon(cx, cy uintptr) uintptr {
+	hInst, _, _ := procGetModuleHandle.Call(0)
+	if hInst == 0 {
+		return 0
+	}
+	// LoadImageW(hInst, MAKEINTRESOURCE(0), IMAGE_ICON, cx, cy, LR_DEFAULTCOLOR)
+	r, _, _ := procLoadImage.Call(hInst, 0, 1 /*IMAGE_ICON*/, cx, cy, 0 /*LR_DEFAULTCOLOR*/)
+	return r
+}
+
+// exeAppIconDataURL 从当前 exe 的 PE 资源图标（rcedit 注入的 RT_ICON）提取为 PNG data URL。
+// 无法提取时返回空字符串（前端隐藏图标）。
+func exeAppIconDataURL() string {
+	data := exeIconData()
+	if len(data) == 0 {
+		return ""
+	}
+	// rcedit 注入 .ico 内嵌 PNG 时，RT_ICON 数据即 PNG 字节，直接编码
+	if isPNG(data) {
+		return "data:image/png;base64," + base64.StdEncoding.EncodeToString(data)
+	}
+	// 非 PNG（BMP/DIB）：纯 Go 解析像素并编码为 PNG，无需 GDI 绘制
+	img, err := dibToPNG(data)
+	if err != nil {
+		return ""
+	}
+	return "data:image/png;base64," + base64.StdEncoding.EncodeToString(img)
+}
+
 func isZoomed(hwnd uintptr) bool {
 	r, _, _ := procIsZoomed.Call(hwnd)
 	return r != 0
@@ -130,21 +245,121 @@ func (a *App) applyTitleBar() {
 	}
 	switch a.cfg.TitleBar {
 	case TitleBarFrameless:
-		// 完全无边框：去掉标题栏 / 系统菜单，客户区铺满整个窗口。
-		// 最小化 / 最大化 / 关闭按钮由前端自绘（window.freedom.window.*）。
+		// 完全无边框：去掉标题栏 / 系统菜单 / 可调边框（WS_THICKFRAME）。
+		// - 标题栏与系统原生最小化 / 最大化 / 关闭按钮均不存在，由前端自绘
+		//   （window.freedom.window.*）接管；
+		// - 去掉 WS_THICKFRAME 是最大化行为正确的关键：只要该位存在，系统在
+		//   WM_GETMINMAXINFO 之后仍会按 AdjustWindowRectEx 追加标题栏 + 边框空间，
+		//   导致最大化窗口溢出工作区、盖住任务栏（F11 全屏感）；
+		// - 边缘拖拽 resize 由壳层 WndProc 的 WM_NCHITTEST 手动实现（返回 HT* 边界值），
+		//   不依赖 WS_THICKFRAME。
 		style := getWindowStyle(hwnd)
-		style &^= wsCaption | wsSysMenu
+		style &^= wsCaption | wsSysMenu | wsThickFrame
 		setWindowStyle(hwnd, style)
 		refreshFrame(hwnd)
-	case TitleBarHidden:
-		// 隐藏标题栏视觉但保留系统原生按钮：DWM 玻璃扩展。
-		// 标题栏区域透明化并并入客户区，右上角的最小化 / 最大化 / 关闭按钮
-		// 由 DWM 继续原生绘制，标题文字置空。
-		m := margins{cxLeftWidth: 0, cxRightWidth: 0, cyTopHeight: 0, cyBottomHeight: 1}
-		procDwmExtendFrameIntoArea.Call(hwnd, uintptr(unsafe.Pointer(&m)))
-		// 标题文字一并清除，标题栏区域只保留系统按钮
-		procSetWindowText.Call(hwnd, uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr(""))))
+	default: // TitleBarNative：补齐系统原生标题栏与可调边框。
+		// webview_go 底层创建的窗口默认 style 不含 WS_CAPTION（见 WebView2 窗口创建），
+		// 因此 native 模式必须显式补回标题栏 / 系统菜单 / 可调边框，
+		// 否则窗口会表现为无边框（无原生三按钮、不可拖拽调整大小）。
+		style := getWindowStyle(hwnd)
+		style |= wsCaption | wsSysMenu | wsThickFrame
+		setWindowStyle(hwnd, style)
 		refreshFrame(hwnd)
-	default: // TitleBarNative：不处理
 	}
 }
+
+// setWindowIcon 把 exe 内嵌的应用程序图标同步到窗口标题栏与任务栏：
+//   - native 模式：标题栏图标（ICON_SMALL）与任务栏 / Alt-Tab 图标（ICON_BIG）均来自 exe 图标，
+//     保证「标题栏图标 = exe 图标」；
+//   - frameless 模式：无标题栏，但任务栏 / Alt-Tab 仍显示 exe 图标。
+//
+// 图标经 LoadImageW 从 PE 资源 RT_GROUP_ICON(ID=0) 加载（rcedit 注入的 group icon ID=0），
+// 不依赖 resources 文件夹里的任何图标文件。
+func (a *App) setWindowIcon() {
+	hwnd := a.WindowHandle()
+	if hwnd == 0 {
+		return
+	}
+	cxIcon, _, _ := procGetSystemMetrics.Call(smCXIcon)
+	cyIcon, _, _ := procGetSystemMetrics.Call(smCYIcon)
+	cxSmall, _, _ := procGetSystemMetrics.Call(smCXSmall)
+	cySmall, _, _ := procGetSystemMetrics.Call(smCYSmall)
+	big := loadExeIcon(cxIcon, cyIcon)
+	small := loadExeIcon(cxSmall, cySmall)
+	if big != 0 {
+		procSendMessage.Call(hwnd, wmSetIcon, 1 /* ICON_BIG */, big)
+		procDestroyIcon.Call(big)
+	}
+	if small != 0 {
+		procSendMessage.Call(hwnd, wmSetIcon, 0 /* ICON_SMALL */, small)
+		procDestroyIcon.Call(small)
+	}
+}
+
+// dibToPNG 将 ICO 内嵌的 DIB 图像（BITMAPINFOHEADER 起始的裸 DIB，即 rcedit 注入
+// 非 PNG .ico 时的 RT_ICON 数据）纯 Go 解析为 PNG 字节，替代原 GDI
+// CreateDIBSection+DrawIconEx 绘制路径（消除对 gdi32/user32 绘图 API 的依赖）。
+// 支持 32/24 bpp；透明由 AND mask 决定（对应位=1 表示透明）。
+func dibToPNG(data []byte) ([]byte, error) {
+	if len(data) < 40 {
+		return nil, fmt.Errorf("DIB too short: %d bytes", len(data))
+	}
+	biSize := binary.LittleEndian.Uint32(data[0:4])
+	if biSize < 40 {
+		return nil, fmt.Errorf("unsupported BITMAPINFOHEADER size %d", biSize)
+	}
+	width := int(binary.LittleEndian.Uint32(data[4:8]))
+	heightRaw := int32(binary.LittleEndian.Uint32(data[8:12]))
+	bitCount := binary.LittleEndian.Uint16(data[14:16])
+	if width <= 0 || heightRaw == 0 {
+		return nil, fmt.Errorf("bad dimensions %dx%d", width, heightRaw)
+	}
+	bpp := (int(bitCount) + 7) / 8 // bytes per pixel
+	if bpp != 3 && bpp != 4 {
+		return nil, fmt.Errorf("unsupported bitcount %d", bitCount)
+	}
+	height := int(heightRaw)
+	if height < 0 {
+		height = -height
+	}
+	// ICO 的 DIB 高度可能为实际像素高度的 2 倍（上方 XOR + 下方 AND mask），
+	// 此时需折半，否则图像会被纵向拉伸。
+	pixelRowBytes := (width*bpp + 3) &^ 3 // 每行按 4 字节对齐
+	andRowBytes := ((width + 31) / 32) * 4
+	pxLen := pixelRowBytes * height
+	if pxLen > len(data)-int(biSize) && height%2 == 0 {
+		height /= 2
+		pxLen = pixelRowBytes * height
+	}
+	pxStart := int(biSize)
+	andStart := pxStart + pxLen
+	hasAndMask := heightRaw > 0 // 正高度表示 DIB 末尾带 AND mask
+	if !hasAndMask {
+		hasAndMask = andStart+andRowBytes*height <= len(data)
+	}
+	img := image.NewRGBA(image.Rect(0, 0, width, height))
+	for y := 0; y < height; y++ {
+		srcY := height - 1 - y // DIB 自底向上：数据首行是图像末行
+		row := pxStart + srcY*pixelRowBytes
+		andRow := andStart + srcY*andRowBytes
+		for x := 0; x < width; x++ {
+			off := row + x*bpp
+			if off+bpp > len(data) {
+				return nil, fmt.Errorf("DIB data truncated at x=%d,y=%d", x, y)
+			}
+			b := data[off]
+			g := data[off+1]
+			r := data[off+2]
+			a := uint8(255)
+			if hasAndMask && (data[andRow+x/8]>>uint(7-x%8))&1 == 1 {
+				a = 0
+			}
+			img.SetRGBA(x, y, color.RGBA{r, g, b, a})
+		}
+	}
+	var buf bytes.Buffer
+	if err := png.Encode(&buf, img); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}

package/templates/go/webview_go/.github/workflows/ci.yaml

@@ -0,0 +1,62 @@
+name: CI Pipeline
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.image }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Go 1.23 was the latest version as of 2024-08-31 but the action output a "warning":
+        # Failed to restore: "/usr/bin/tar" failed with error: The process '/usr/bin/tar' failed with exit code 2
+        # Go 1.22 didn't output the above "warning" so we're using this version.
+        # Go 1.14 made -mod=vendor default.
+        # Go 1.13 is the version set in go.mod.
+        include:
+          - { image: macos-14,     go: '1.22' }
+          - { image: macos-14,     go: '1.21' }
+          - { image: macos-14,     go: '1.20' }
+          # Go 1.19 is the earliest version available for ARM64.
+          - { image: macos-14,     go: '1.19' }
+          # macos-12 runner has x86_64 support which is needed for old versions of Go
+          - { image: macos-12,     go: '1.18' }
+          - { image: macos-12,     go: '1.17' }
+          - { image: macos-12,     go: '1.16' }
+          - { image: macos-12,     go: '1.15' }
+          - { image: macos-12,     go: '1.14' }
+          - { image: macos-12,     go: '1.13' }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-4-dev libwebkitgtk-6.0-dev }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-3-dev libwebkit2gtk-4.0-dev }
+          - { image: ubuntu-22.04, go: '1.21', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.20', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.19', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.18', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.17', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.16', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.15', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.14', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.13', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: windows-2022, go: '1.22' }
+          - { image: windows-2022, go: '1.21' }
+          # Go 1.20 is the earliest version that is usable in this environment as of 2024-08-31.
+          # Compilation fails with older versions:
+          # [...]/bin/ld.exe: [...]\go-link-3209855222\000008.o: in function `x_cgo_thread_start':
+          # \\_\_\runtime\cgo/gcc_util.c:18: undefined reference to `__imp___iob_func'
+          - { image: windows-2022, go: '1.20' }
+    name: Build (${{ matrix.image }}, go ${{ matrix.go }})
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libwebkit2gtk-4.0-dev
+      - uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go }}
+      - name: Build examples
+        run: >
+          go build
+          ./examples/basic
+          ./examples/bind
+      - name: Run tests
+        run: go test

package/templates/go/webview_go/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+### Migrating from v0.1.1 to v0.10.0
+
+1. `Webview.Open()` has been removed. Use other webview APIs to create a window, open a link and run main UI loop.
+2. `Webview.Debug()` and `webview.Debugf()` have been removed. Use your favorite logging library to debug webview apps.
+3. `Webview.Settings` struct has been removed. Title, URL and size are controlled via other API setters and can be updated at any time, not only when webview is created.
+4. `Webview.Loop()` has been removed. Use `Run()` instead.
+5. `WebView.Run()`, `WebView.Terminate()`, `WebView.SetTitle()`, `WebView.Dispatch()` stayed the same.
+6. `WebView.Exit()` has been renamed to `WebView.Destroy()`
+7. `WebView.SetColor()` and `WebView.SetFullScreen()` have been removed. Use `Window()` to get native window handle and probably write some Cgo code to adjust native window to your taste.
+8. `Webview.Dialog` has been removed. But it is likely to be brought back as a standalone module.
+9. `WebView.Eval()` remained the same.
+10. `WebView.InjectCSS()` has been removed. Use eval to inject style tag with CSS inside.
+11. `WebView.Bind()` kept the name, but changed the semantics. Only functions can be bound. Not the structs, like in Lorca.

package/templates/go/webview_go/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2017 Serge Zaitsev
+Copyright (c) 2020 webview
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/go/webview_go/README.md

@@ -0,0 +1,50 @@
+# webview_go
+
+[![GoDoc](https://godoc.org/github.com/webview/webview_go?status.svg)](https://godoc.org/github.com/webview/webview_go)
+[![Go Report Card](https://goreportcard.com/badge/github.com/webview/webview_go)](https://goreportcard.com/report/github.com/webview/webview_go)
+
+Go language binding for the [webview library][webview].
+
+> [!NOTE]
+> Versions <= 0.1.1 are available in the [old repository][webview].
+
+### Getting Started
+
+See [Go package documentation][go-docs] for the Go API documentation, or simply read the source code.
+
+Start with creating a new directory structure for your project.
+
+```sh
+mkdir my-project && cd my-project
+```
+
+Create a new Go module.
+
+```sh
+go mod init example.com/app
+```
+
+Save one of the example programs into your project directory.
+
+```sh
+curl -sSLo main.go "https://raw.githubusercontent.com/webview/webview_go/master/examples/basic/main.go"
+```
+
+Install dependencies.
+
+```sh
+go get github.com/webview/webview_go
+```
+
+Build the example. On Windows, add `-ldflags="-H windowsgui"` to the command line.
+
+```sh
+go build
+```
+
+### Notes
+
+Calling `Eval()` or `Dispatch()` before `Run()` does not work because the webview instance has only been configured and not yet started.
+
+[go-docs]: https://pkg.go.dev/github.com/webview/webview_go
+[webview]: https://github.com/webview/webview

package/templates/go/webview_go/examples/basic/main.go

@@ -0,0 +1,12 @@
+package main
+
+import webview "github.com/webview/webview_go"
+
+func main() {
+	w := webview.New(false)
+	defer w.Destroy()
+	w.SetTitle("Basic Example")
+	w.SetSize(480, 320, webview.HintNone)
+	w.SetHtml("Thanks for using webview!")
+	w.Run()
+}

package/templates/go/webview_go/examples/bind/main.go

@@ -0,0 +1,38 @@
+package main
+
+import webview "github.com/webview/webview_go"
+
+const html = `<button id="increment">Tap me</button>
+<div>You tapped <span id="count">0</span> time(s).</div>
+<script>
+  const [incrementElement, countElement] =
+    document.querySelectorAll("#increment, #count");
+  document.addEventListener("DOMContentLoaded", () => {
+    incrementElement.addEventListener("click", () => {
+      window.increment().then(result => {
+        countElement.textContent = result.count;
+      });
+    });
+  });
+</script>`
+
+type IncrementResult struct {
+	Count uint `json:"count"`
+}
+
+func main() {
+	var count uint = 0
+	w := webview.New(false)
+	defer w.Destroy()
+	w.SetTitle("Bind Example")
+	w.SetSize(480, 320, webview.HintNone)
+
+	// A binding that increments a value and immediately returns the new value.
+	w.Bind("increment", func() IncrementResult {
+		count++
+		return IncrementResult{Count: count}
+	})
+
+	w.SetHtml(html)
+	w.Run()
+}

package/templates/go/webview_go/glue.c

@@ -0,0 +1,36 @@
+#include "webview.h"
+
+#include <stdlib.h>
+#include <stdint.h>
+
+struct binding_context {
+    webview_t w;
+    uintptr_t index;
+};
+
+void _webviewDispatchGoCallback(void *);
+void _webviewBindingGoCallback(webview_t, char *, char *, uintptr_t);
+
+static void _webview_dispatch_cb(webview_t w, void *arg) {
+    _webviewDispatchGoCallback(arg);
+}
+
+static void _webview_binding_cb(const char *id, const char *req, void *arg) {
+    struct binding_context *ctx = (struct binding_context *) arg;
+    _webviewBindingGoCallback(ctx->w, (char *)id, (char *)req, ctx->index);
+}
+
+void CgoWebViewDispatch(webview_t w, uintptr_t arg) {
+    webview_dispatch(w, _webview_dispatch_cb, (void *)arg);
+}
+
+void CgoWebViewBind(webview_t w, const char *name, uintptr_t index) {
+    struct binding_context *ctx = calloc(1, sizeof(struct binding_context));
+    ctx->w = w;
+    ctx->index = index;
+    webview_bind(w, name, _webview_binding_cb, (void *)ctx);
+}
+
+void CgoWebViewUnbind(webview_t w, const char *name) {
+    webview_unbind(w, name);
+}

package/templates/go/webview_go/go.mod

@@ -0,0 +1,3 @@
+module github.com/webview/webview_go
+
+go 1.13

package/templates/go/webview_go/libs/mswebview2/LICENSE

@@ -0,0 +1,27 @@
+Copyright (C) Microsoft Corporation. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * The name of Microsoft Corporation, or the names of its contributors 
+may not be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.