Skip to content

Latest commit

 

History

History
114 lines (79 loc) · 5.96 KB

run.md

File metadata and controls

114 lines (79 loc) · 5.96 KB

跑通 hello

当前可运行路径:XGo 应用 + LLGo 编译 + CEF C++ shim(MessageRouter)(cef/host_llgo.go → cef/shim,不用 cgo)。
一等语言是 XGo(examples/hello/main.xgo);工具链:scripts/install-xgo-toolchain.sh。

工具链(XGo / LLGo / llcppg)

./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 ...。

前提

  1. 已按 cefutil skills 下载 CEF(版本见仓库根 CEF_VERSION),解压在 third_party/cef/...
  2. 已编译过 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-hello

scripts/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 错误拒绝。

IPC 与 ACL(P0)

层 行为
前端 渲染进程在页面脚本之前装上 __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。

插件与 CLI

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-dev

html、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。

Channels

__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。

与 llcppg 的关系

  • 宿主已用 LLGo go:linkname 调 shim(无 cgo)。
  • cef/llcppg.cfg 用于后续扩大到完整 include/capi;shim 应收窄为仅保留回调/Views/MessageRouter 难点。