Golang跨平台桌面应用开发插件库go-app使用指南

介绍

go-app是一个用于使用Go编程语言(Golang)和WebAssembly(Wasm)构建渐进式Web应用(PWA)的包。它使用声明式语法来创建和组合HTML元素，完全使用Go编程语言实现。

主要特性

• 使用Go语言构建Web应用
• 基于WebAssembly技术
• 支持PWA特性
• 声明式UI语法
• 兼容Go标准HTTP包
• 支持离线模式
• SEO友好

安装要求

• Go 1.18或更新版本
• Go模块支持

安装命令：

go mod init
go get -u github.com/maxence-charriere/go-app/v10/pkg/app

声明式语法示例

下面是一个Hello World组件示例，它接收输入并在标题中显示输入值：

type hello struct {
	app.Compo  // 嵌入Compo基础结构体

	name string  // 组件状态
}

// Render方法定义组件UI
func (h *hello) Render() app.UI {
	return app.Div().Body(
		app.H1().Body(
			app.Text("Hello, "),
			app.If(h.name != "", func() app.UI {
				return app.Text(h.name)  // 如果有名字显示名字
			}).Else(func() app.UI {
				return app.Text("World!")  // 否则显示World!
			}),
		),
		app.P().Body(
			app.Input().
				Type("text").
				Value(h.name).
				Placeholder("What is your name?").
				AutoFocus(true).
				OnChange(h.ValueTo(&h.name)),  // 输入变化时更新name状态
		),
	)
}

标准HTTP集成

go-app应用兼容Go标准HTTP包接口：

func main() {
	// 组件路由:
	app.Route("/", func() app.Composer { return &hello{} })
	app.Route("/hello", func() app.Composer { return &hello{} })
	app.RunWhenOnBrowser()  // 在浏览器环境中运行

	// HTTP路由:
	http.Handle("/", &app.Handler{
		Name:        "Hello",
		Description: "An Hello World! example",
	})

	// 启动HTTP服务器
	if err := http.ListenAndServe(":8000", nil); err != nil {
		log.Fatal(err)
	}
}

完整示例DEMO

下面是一个完整的跨平台桌面应用示例：

package main

import (
	"log"
	"net/http"

	"github.com/maxence-charriere/go-app/v10/pkg/app"
)

// 定义主组件
type hello struct {
	app.Compo
	name string
}

// 渲染组件UI
func (h *hello) Render() app.UI {
	return app.Div().Body(
		app.H1().Body(
			app.Text("Hello, "),
			app.If(h.name != "", func() app.UI {
				return app.Text(h.name)
			}).Else(func() app.UI {
				return app.Text("World!")
			}),
		),
		app.P().Body(
			app.Input().
				Type("text").
				Value(h.name).
				Placeholder("What is your name?").
				AutoFocus(true).
				OnChange(h.ValueTo(&h.name)),
		app.Button().
			Text("Greet").
			OnClick(func(ctx app.Context, e app.Event) {
				if h.name == "" {
					app.Window().Call("alert", "Please enter your name!")
				} else {
					app.Window().Call("alert", "Hello "+h.name+"!")
				}
			}),
	)
}

func main() {
	// 组件路由配置
	app.Route("/", &hello{})
	app.Route("/hello", &hello{})
	app.RunWhenOnBrowser()

	// 创建HTTP处理程序
	handler := &app.Handler{
		Name:        "Hello",
		Description: "Greeting App",
		Styles: []string{
			`body {
				font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
				margin: 0;
				padding: 20px;
				text-align: center;
			}`,
		},
	}

	// 启动HTTP服务器
	if err := http.ListenAndServe(":8000", handler); err != nil {
		log.Fatal(err)
	}
}

构建和运行

1. 将上述代码保存为main.go
2. 初始化模块并获取依赖：

   go mod init hello-app
   go mod tidy
   

3. 运行应用：

   go run .
   

4. 在浏览器中访问 http://localhost:8000

打包为桌面应用

go-app应用可以打包为桌面应用，可以使用工具如：

• go-app-pkg
• Wails
• Lorca

文档

更多详细信息和高级用法，请参考官方文档。