Asuka 文档

Asuka 让你用 Go 编写应用，并在 iOS、Android、macOS、Windows、Linux 和 Web 上以各平台的原生控件呈现。应用的界面就是一些返回视图的 Go 函数：Asuka 用各平台自己的控件把它们显示出来；某个 signal 变化时，只有读取了它的视图才会更新。

func Counter() ui.Node {
	count := signal.New(0)
	label := signal.Func(func() string {
		return fmt.Sprintf("Count: %d", count.Get())
	})
	return ui.SafeArea(ui.Style{Align: ui.AlignCenter, Justify: ui.JustifyCenter},
		ui.Text(label),
		ui.Button(ui.ButtonProps{
			Title:   ui.Val("Add"),
			Variant: ui.ButtonFilled,
			OnPress: func() { count.Set(count.Peek() + 1) },
		}),
	)
}

func main() { app.Run(Counter) }

工作原理

你的应用完全是 Go 写的：组件、状态以及其余所有代码。Asuka 的核心负责运行组件、对视图进行布局（flexbox 和 grid，用 Go 实现），然后把发生变化的部分按帧打成一个批次，发给所在平台的宿主（host）。宿主再去创建和更新平台自己的视图：

一个文本输入框，在各平台上分别就是 UITextField、EditText、NSTextField、EDIT 控件、GtkEntry 或 <input>；页面的导航栈则分别对应 UINavigationController、带返回手势的 Material 顶部应用栏、Mac 窗口中带返回按钮的工具栏，或 libadwaita 的导航视图。因此，一个不设置任何样式的应用，看起来就和该平台上的其他应用一样，无障碍、文本输入和滚动也都和它们表现一致。桌面端的宿主直接从 Go 调用系统库，不需要 cgo，所以 Windows 或 Linux 应用只靠 Go 就能构建，而且可以在任何系统上构建。

状态保存在 signal 里。组件只运行一次；signal 变化时，只有读取了它的那些属性会被重新发送，不需要对整棵树做 diff。

同一个应用可以在所有平台上运行。在手机上，它铺满整个屏幕；在桌面端，它是一个用户可以调整大小的窗口，还可以打开更多窗口（ui.Window，手机上没有这个概念），并拥有带键盘快捷键的菜单栏（ui.MenuBar，在手机上会被忽略）。如果某个包提供的功能在某个平台上并不存在（比如 Mac 上的传感器或主屏幕小组件），它在那个平台上会告诉你“不可用”，应用可以据此检查，在缺少这项功能时照常运行。

Asuka 需要 Go 1.26 或更高版本。应用可运行在 iOS 16、Android 13（API 33）、macOS 11、Windows 10 及以上版本，以及装有 GTK 4.14 和 libadwaita 1.5 或更高版本的 Linux 上，也可以在当前主流浏览器中运行。开发时，asuka dev 会运行你的应用，并在你保存时重新加载：可以跑在 iOS 模拟器、Android 模拟器或手机上（Go 代码在你的电脑上运行），也可以直接跑在电脑上，或者跑在浏览器里。

指南

参考