native
系统能力模块集合。每个子目录是一个独立模块,可以只用其中一个,也可以完全不用 ui 界面。
| 模块 | 能力 | 依赖 |
|---|---|---|
| permission | 检查、申请系统权限 | native、native/internal/sys |
| screen | 显示器列表、截图 | 同上 |
| input | 合成鼠标、键盘事件 | 同上 |
| hotkey | 全局快捷键 | 同上 |
| clipboard | 异步读取剪贴板文本、编码图片和文件引用(macOS / Windows / Linux Wayland、X11) | 同上 |
| notification | 系统通知权限、投递与撤回(macOS .app / Linux D-Bus) | 同上 |
| tray | 托盘图标与原生菜单(macOS / Windows / Linux SNI) | native、native/internal/sys |
| process | 终端前台进程组、进程工作目录(macOS / Linux) | native、native/internal/sys |
模块之间互不引用,也不引用 ui 和 Gio,这一点由 internal/deps 里的测试保证。
两个共享部分不是独立模块:
native(本目录的native.go):所有模块共用的错误值native.Err*。native/internal/sys:平台绑定,macOS 通过 purego 调 Objective-C 运行时和系统框架(不用 cgo)、Windows 的 Win32 调用、Linux 的 X11 协议和 D-Bus 都在这里。外部不能引用。native/internal/wlclip:读取 Linux Wayland 剪贴板,运行时通过 purego 加载 libwayland-client(不用 cgo)。只有 clipboard 引用,所以别的模块不会加载 libwayland。
支持 macOS 14+、Windows 和 Linux,其他平台返回 native.ErrUnsupported。Linux 上截图和合成输入走 X11(Wayland 会话里通过 XWayland),通知走 D-Bus,剪贴板 Wayland 和 X11 都支持。各能力在各平台的细节见原生能力。
移动端 iOS 和 Android 暂无 native/* 后端,各能力返回 native.ErrUnsupported。界面打包与运行见 Mobile 支持。