当前可运行路径:XGo 应用 + LLGo 编译 + CEF C++ shim(MessageRouter)(cef/host_llgo.go → cef/shim,不用 cgo)。
一等语言是 XGo(examples/hello/main.xgo);工具链:scripts/install-xgo-toolchain.sh。
./scripts/install-xgo-toolchain.sh
# 需要:Go 1.27、LLVM 22、LLGO_ROOT=/opt/xgo-toolchain/llgo
xgo version && llgo version && llcppg -h | head -1注意:不要用 apt 里的旧 xgo 配 Go 1.27(export data 版本不匹配);脚本从源码装 XGo。
go.mod 带 // llgo 1.0,因此 xgo build 会把编译器指到 LLGo。构建脚本通过 scripts/xgo-llgo-gocmd.sh 去掉 xgo 注入的、LLGo 尚不支持的 -ldflags -X ...。
- 已按 cefutil skills 下载 CEF(版本见仓库根
CEF_VERSION),解压在third_party/cef/... - 已编译过 CEF 的
libcef_dll_wrapper(shim CMake 会优先复用$CEF_ROOT/build/libcef_dll_wrapper):
CEF_ROOT=/path/to/cef_binary_*_linux64
cmake -S "$CEF_ROOT" -B "$CEF_ROOT/build" -G "Unix Makefiles" \
-DCMAKE_BUILD_TYPE=Release -DUSE_SANDBOX=OFF \
-DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
cmake --build "$CEF_ROOT/build" --target libcef_dll_wrapper -j"$(nproc)"xgoef build --app examples/hello --out build/hello
cd build/hello
./xgoef-helloscripts/build-xgoef-hello.sh 只设置 PATH、LLGO_ROOT、CGO_ENABLED=0 和 XGO_GOCMD,然后执行同一条 xgoef build。cmake、拷贝 CEF 运行时和 xgo build 都在 CLI 里。--assets-only 只复制前端,不链接。配置里有 version 时,发行目录的 bundle/ 还会有 deb、msi、dmg 和 AppImage,见 bundle.md。
xgoef build 还会把 web/ 签进宿主尾部,并把公钥写进发行目录的 xgoef.conf.json。私钥在 .xgoef/asset.key。细节见 asset.md。
产物目录含:xgoef-hello(由 main.xgo 经 xgo+llgo 生成)、xgoef-helper(本仓库 shim 编的原生子进程,含渲染侧 MessageRouter)、libcef.so、Resources、web/、api/js/xgoef.js。
点击 invoke greet 应显示 hello, xgo (from xgoef),并更新 event: tick …(宿主 EmitTo)。
open aux 会再开一个 label=aux 的窗口。未在 capabilities 声明的 command 会以 ACL 错误拒绝。
| 层 | 行为 |
|---|---|
| 前端 | 渲染进程在页面脚本之前装上 __XGOEF__;xgoef.js 用 window.cefQuery 发送 JSON invoke |
| 渲染进程 | shim MessageRouter 注入 cefQuery,再执行前端根里的 xgoef.js |
| 浏览器进程 | OnQuery → Go runtime → acl.Guard → ipc.Router → Success JSON |
| 配置 | capabilities[] + windows[].label(见 xgoef.conf.schema.json) |
| 层 | 语言 | 说明 |
|---|---|---|
应用(examples/*) |
XGo(.xgo) |
一等开发面;xgo build |
框架 API(runtime/ipc/acl/plugin/conf) |
Go 或 XGo | 可混编;新 API 优先 XGo |
CEF 绑定(cef/) |
Go + LLGo linkname |
贴近 C ABI;llcppg 生成物同左 |
应用代码应对齐 goplus/xgo 的写法哲学(见 doc/docs.md / Mini Spec),而不是把 Go 原样塞进 .xgo:
- 命令式:
echo "hi"、host.SetArgs os.Args(少括号) - ErrWrap:
expr!/expr?/expr?:defval - lambda:
app.Handle "greet", (ctx, args) => { ... } - 字符串:
"hello, ${name}"(告别Sprintf) - 内建:
fatal/errorln/errorf
| 现象 | 原因 |
|---|---|
| 首次弹出 Chromium ToS | 新的 root_cache;点 Accept |
默认 --disable-gpu --in-process-gpu |
宿主不宜作 GPU 子进程;设 XGOEF_ENABLE_GPU=1 可关掉这些开关 |
browser_subprocess_path → xgoef-helper |
渲染/网络等进程走原生 helper,不重入 LLGo 宿主 |
窗口 URL 用 xgoef://app/index.html。它只映射 build.frontendDist,不接受根以外的 file://。开发服务器仍用 http:// / https://。细节见 asset.md。
plugins: ["fs", "os"] 会在 App.Run 里装上带范围的文件命令和平台命令。范围、权限和前端 __XGOEF__.plugins 见 plugins.md。开机自启是插件 autostart,页面开关当前用户的 XDG autostart 项,见 autostart.md。
xgoef create myapp
xgoef create myapp --template vite
xgoef create myapp --template react
xgoef create myapp --template vue
xgoef create myapp --template svelte
xgoef build --app myapp --out myapp/dist
xgoef dev --app examples/hello --out /tmp/xgoef-devhtml、vite、react、vue、svelte 五套模板见 templates.md。Vite 模板先 npm install,再 xgoef dev。
build / dev 默认链接 CEF shim 与 XGo 宿主,并复制配置、前端和 xgoef.js。需要 xgo、llgo、cmake、pkg-config,以及 CEF_ROOT(未设置时按仓库根 CEF_VERSION 找 third_party/cef)。--assets-only 只复制资源。xgoef dev 接着拉起宿主,前端一变就重载页面,见 dev.md。
__XGOEF__.channel() 打开一条有序的宿主 → 页面流。hello 的 channel 按钮走 progress。细节见 channels.md。
页面 command 在查询回调外执行。invoke(cmd, args, { timeout }) 的 timeout 是毫秒;返回的 Promise 有 cancel()。失败时 reject XgoefError,code 是稳定记号。hello 的 wait / cancel wait 走这条路。细节见 ipc.md。
xgoef build 和 xgoef dev 把 commands 和已启用插件写成 web/xgoef.d.ts。细节见 binding.md。
- 宿主已用 LLGo
go:linkname调 shim(无 cgo)。 cef/llcppg.cfg用于后续扩大到完整include/capi;shim 应收窄为仅保留回调/Views/MessageRouter 难点。