30 KiB
Handoff:anland 5.x + 内置 MobileGL SHM server
更新时间:2026-10-01(用户时区 America/Cuiaba)。用户要求暂停实现,先写交接文档,由新的 agent 继续。
先读:用户最新纠正与当前完成度
任务没有完成。KWin、Konsole、eglinfo、glxinfo、Plasma 均未通过 MobileGL 真机验收。构建成功不能当成验收成功。
用户原始目标:
- 在 anland 新建
legacy-mobilegl-unified,让 anland 5.x 使用 MobileGL。 - SHM split server 必须是 anland APK 的一部分,由 anland 管理,client 在 Droidspaces 容器内。
- 在联想 Y700 TB321FU 上复制
arch-kde为arch-kde-mgl,作为实验环境。 - 依次调通 KWin → Konsole → eglinfo → glxinfo → Plasma。
- 阶段成果形成可二分的 commits,推送 anland fork 和 MobileGL
feat/disaggregated。 - 开始前阅读此目录调研,尤其
kgsl-as-server.md,技术路线接近 B:anland 自己的 Surface 交给 MobileGL server 直接渲染。
用户已明确排除两种路线:
anland fork 的
legacy-mobilegl路径是配合 MobileGL feat/disaggregated-container-gbm 的错误路径。MobileGL server 不应该活在独立的 plugin app 里,应该成为 anland 的一部分。
说起来,为什么会有实现一个应用离屏 Service?如果 MobileGL 有全局状态需要解决,那应该处理的是 MobileGL 自己的全局状态,而不是想办法制造多个 MobileGL peer。
第二条纠正针对本轮草稿:曾添加 MobileGLAppsService,exec 一个离屏 supervisor,给每个应用 fork 一个独立 worker,以隔离 MobileGL 全局状态。用户否定了这个绕法;不要把它继续打包、部署或宣称为最终设计。
应在 MobileGL 内解决 session/context/surface 状态归属与共享资源问题。anland 内置的 renderer 可以由私有 Service 管理,但不能用额外“应用离屏 Service”或按应用 fork 渲染进程来代替这个工作。多应用的正常 client 连接与人为制造 worker 来绕过全局状态,要区分清楚。具体统一 server 的设计尚未完成。
已发给各子 agent 的最新指令是暂停实现与部署,仅报告状态。纠正后的架构还没有实现;草稿仍包含被否定代码。 本文的状态说明优先于草稿中的旧启动说明。
工作区、分支、保留事项
MobileGL
C:\Users\Swung0x48\repos\FoldCraftLauncher\MobileGL
origin: https://github.com/MobileGL-Dev/MobileGL.git
显示分支: feat/disaggregated
当前实现 HEAD: 2f64ede8c65e9577676e658e82017672ad58f03e
Windows 上真实本地 ref 的大小写是 refs/heads/Feat/disaggregated。推送使用:
git push origin HEAD:refs/heads/feat/disaggregated
不要用失败的 git push origin feat/disaggregated 重复排查网络。
用户原有 dirty submodule 3rdparty/glslang 必须保留,不能提交、重置或当成本任务成果。为 split 构建初始化过缺失的 3rdparty/flatbuffers,没有修改 gitlink。
本任务未提交改动仅有:
| 文件 | 改动与状态 |
|---|---|
CMakeLists.txt |
Linux 增加 libGL.so、libGL.so.1 别名 |
MobileGL/MG_Impl/EGLImpl/EGLImpl.cpp |
Wayland Present() 失败返回 EGL_BAD_SURFACE;原代码忽略失败 |
MobileGL/MG_Impl/GLXImpl/GLXImpl.cpp |
spawn 模式 X drawable 使用远端 pbuffer,避免把 XID 当 Android ANativeWindow;没有 X11 像素上屏、没有远端 resize |
DirectGLES/BackendObject 的“保留一个 native context、切换多个 surface”实现曾被讨论,但没有产生代码改动,也没有产生测试成果。不要误以为它已经实现。
anland
原工作区:
C:\Users\Swung0x48\repos\anland
origin: https://github.com/MobileGL-Dev/anland.git
原分支: main
原工作区用户 dirty submodules pulseaudio、wayland、xserver 没有修改。继续保留。
本任务使用独立 worktree,后续 anland 编辑必须在这里进行:
C:\Users\Swung0x48\repos\anland-legacy-mobilegl-unified
branch: legacy-mobilegl-unified
base: origin/legacy = 9ab13eb146bc9f3dd3cc44cabc268659d9eb0a46
当前本地/远端 HEAD: 6e1fa653314956f57948b93abff08724c97c779c
不要重新 checkout 远端分支来替代工作区;大量实现仍在未提交文件中。
已推送 commits 与适用性
MobileGL feat/disaggregated
| Commit | 内容 | 适用性 |
|---|---|---|
57781688 |
GLVND EGL vendor ABI headers,来自 6a702afa |
可复用的独立 client 能力 |
75f83b20 |
EGL extension strings,来自 dfbda7cc |
可复用 |
0dad3fca |
EGL GLVND vendor,来自 c9206dd9 |
可复用 |
f4589243 |
multiple display/vendor lookup,来自 2860d090 |
可复用 |
32c79f41 |
Wayland wl_shm WSI,来自 7fd7f71d |
初步 client 能力;有下述限制 |
a5b463a5 |
package-neutral embedded display C ABI | 14 项 ownership/lifecycle 测试通过,可复用 |
2f64ede8 |
Unix --serve --max-sessions 1..64,fork worker 并发 |
已推送,但用户随后否定用它解决 anland 全局状态的方案。最终架构需移除/替换这个依赖,不能把它当任务完成。 |
这些独立 client 改动来自旧分支,但没有 cherry-pick 独立 plugin/GBM/host-frame 整体架构。32c79f41 冲突处理中移除了尚未实现的 device/GBM 扩展广告。
anland legacy-mobilegl-unified
6e1fa65 Add a no-fd MobileGL Surface mode to the display protocol 已推送。
它添加 DATA_MSG_MOBILEGL_SURFACE=201、ANLAND_FORMAT_MOBILEGL_SURFACE=0x4d474c53。metadata 没有 fd,保留一 pacing slot(fd=-1、idx=0)。真实 daemon + producer + consumer 测试验证 metadata、frame ack、输入事件。没有假造 dma-buf。
其他 APK、JNI、KWin、launcher 草稿都还没有提交。
未提交 anland 草稿:保留有用部分,移除被否定部分
Android APK/JNI
改动文件:
consumers/anland_v5/android_consumer/app/build.gradle
consumers/anland_v5/android_consumer/app/src/main/AndroidManifest.xml
consumers/anland_v5/android_consumer/app/src/main/java/com/anland/consumer/MainActivity.java
consumers/anland_v5/android_consumer/app/src/main/java/com/anland/consumer/Native.java
consumers/anland_v5/android_consumer/app/src/main/jni/CMakeLists.txt
consumers/anland_v5/android_consumer/app/src/main/jni/native_consumer.c
未跟踪文件:
consumers/anland_v5/android_consumer/MOBILEGL.md
consumers/anland_v5/android_consumer/app/src/main/java/com/anland/consumer/MobileGLWorker.java
consumers/anland_v5/android_consumer/app/src/main/java/com/anland/consumer/MobileGLConnection.java
consumers/anland_v5/android_consumer/app/src/main/java/com/anland/consumer/MobileGLAppsService.java
consumers/anland_v5/android_consumer/app/src/main/jni/mobilegl_worker.c
有用设计:
MobileGLWorker是同 APK、同 UID 的私有:mobileglService(不是 isolatedProcess),接收 anland 自己的 Surface,JNI 通过dlopen/dlsym使用中立 ABI。- 主 UI 进程不加载 MobileGL 的 GL 导出;避免影响 Android framework/UI 的 EGL。
MainActivity等待 worker attach 后才启动 native display consumer。- MobileGL 模式 native consumer 不连接 ANW_API_CPU、不 dequeue/queue Surface buffer,EGL 是唯一生产者;输入、音频、显示协议继续保留。
- 新 Surface parcel 每次会产生不同 native wrapper。最新草稿保留同一 window owner/generation 的 Java Surface,尺寸更新使用保留的 ANativeWindow,避免 resume/resize 把活动 session detach。
- native geometry callback → one-way Binder → UI SurfaceHolder;
surfaceChanged先报告尺寸,再等待 native transport 停止,避免 geometry/ack 互等。 Surface.getGenerationId()是隐藏 API,曾导致编译失败;改为 NDK native identity token + 本地生命周期 generation。- CMake 使用仓库根下的 authoritative common/libdisplay 源码,避免 Windows 把 symlink checkout 成 target-text 文件。
mobileglDiststaging 需在切回 unbundled 时清除旧 libs;Gradle Sync 没有 sources 时会 NO-SOURCE,不自动删除旧文件,草稿已改为显式 cleanup。
必须撤掉/重设计:MobileGLAppsService、manifest/binding/health check、第二个应用 endpoint、libMobileGLServer.so --serve --max-sessions 16 依赖以及相关文档。
当前 MobileGLConnection、APK 文档仍包含这条被否定路径。不要只读注释就继续部署。
KWin 6.7.4 后端
anland 5.x 是宿主协议版本,容器当前 KWin 实际为 6.7.4。
草稿:
producers/kde/Arch_v5/kwin.patch
producers/kde/anland_backend_Arch_v5/src/backends/anland/anland_backend.cpp
producers/kde/anland_backend_Arch_v5/src/backends/anland/anland_backend.h
producers/kde/anland_backend_Arch_v5/src/backends/anland/anland_egl_backend.cpp
producers/kde/anland_backend_Arch_v5/src/backends/anland/anland_egl_backend.h
producers/kde/Arch_v5/mobilegl-startup.sh # untracked
producers/kde/Arch_v5/mobilegl.md # untracked
CMakeLists.txt 也可能显示 dirty(曾尝试 PUBLIC include,已撤销语义改动;检查实际 diff/行尾)。
ANLAND_MOBILEGL=1 路径:跳过 GPU/DRM probing,不广告 dma-buf/syncobj,不要求 GBM/no_config/surfaceless。先选择 RGBA window config,创建 server-owned EGL window,再创建 RenderDevice/shared contexts。默认 makeCurrent 使用该 Surface。output layer marker 走 default FBO 0、full damage 和 eglSwapBuffers,不导入 consumer dma-buf。Mesa 路径保留。
full repaint 是因为 Android BufferQueue 自己轮换 buffers,而 client 暂未提供 buffer age。RenderTarget transform 保持原 Anland FlipY/output transform 语义。
native 构建已通过。最后修了 public backend headers 的 include 路径:main_wayland.cpp 包含它们时也必须找到 producer/protocol header,不能靠 backend PRIVATE include dirs。两个 header 已改为自足的相对 include。
launcher 有 compositor/plasma modes,原先按两个 endpoints 分配环境,这部分要随新统一 server 设计修改。提交新 shell helper 时须设置 git executable bit 100755。
MobileGL 状态问题:已知事实与未完成设计
不能用“每进程隔离”掩盖同一应用的多 context/share-group 缺陷:
MG_State::pGLContext是进程全局,bindings/errors/object registries 被不同 EGLContext 共用。- EGL
shareCtx当前只是 metadata,不能据此声称真正支持 shared contexts。 - DirectGLES
g_Display/g_Context/g_Surface和 Managers/cache/twin 状态是全局;不能只把三个 handle 改 TLS 就声称完成隔离。 - 多个虚拟 EGLContext 在同一个已创建 Surface上切换,不会直接销毁 native context;ServerLoop 检测 context token 变化后重新绑定同一 native triple、失效 caches。因此简单串行 KWin 单 Surface 有可能工作,但没有真机证据。
- 创建第二个 pbuffer/window 会
DestroyEGLContext(),InitDisplayAndContext()又销毁 context/terminate,原资源丢失。Qt 的 offscreen probe + 实际窗口、多窗口会碰到这个问题。 - 只给 native
eglCreateContext添加 share 参数,不会自动解决 frontend object registries、context-local bindings 或 wire 上的 context/share-group 归属。 ServerDisplayInstance当前只有一个 display/window lease;现有 inprocess server 接一个活动 session;多 client 真正共存需要重新审视其状态与路由。- ServerLoop 当前把 server-owned window 与 pbuffer session mode 闩定,混用会返回
SurfaceModeMismatch。新架构要在明确的 session/context/surface 所有权下处理 compositor 与应用。
后续应先审计 MG_State、MG_Backend、MG_Pipe、DirectGLES Managers、Init/Destroy、ServerSession/ServerLoop 的全局状态。确定 per-session/per-context 的 state owner、GL share group、原生 EGLContext/Surface 生命周期、apply-thread 绑定,再实施和测试。这个设计审计只开始了,没有完成代码。
以下是 runtime agent 补充的源码定位(行号针对当前实现 HEAD;以后可能移动):
| 定位 | 问题 |
|---|---|
MG_State/GLState/Core.cpp:1565 |
全局 pGLContext,EGL CreateContext 不创建独立 GLContext |
MG_State/EGLState/Core.cpp:1496 |
全局 pEGLContext;已有 threadCurrents/contextOwners/互斥,但 ContextObject 只是元数据,没有 GL 状态/share group |
MG_Backend/BackendObjects.h:16 |
全局 pActiveBackendObject,Init 的 gBackendFunctionsTable 也全局 |
MG_Remote/Server/ServerSession.cpp、ServerLoop.h:129 |
singleton session/loop、全局 active/sessionOwner、唯一 g_applyThreadKey |
MG_Pipe/MGPipe.h:264、MGPipeCallbacks.h:77,97、MGPipeHostSpan.h |
screen/context、callbacks、event capacity hook、segment resolver 全局 |
MG_Pipe/PipeApply.cpp:484,490 |
全局 g_applier 与 g_resourceOps,会覆盖不同 session 的表、绑定与后端 ops |
DirectGLES.cpp:16183,16568 |
唯一 native tuple,无条件 context teardown |
DirectGLES/Managers.h、Managers.cpp |
resource/twin registries、memo、texture units、context generations 混在全局 |
建议的真正状态边界:
- Session:SHM rings/segments、staged stores、reply/event 路由、failure、资源 handle空间、backend/Pipe runtime;关闭一个 session 不得破坏另一个。
- Context:独立 GLContext、bindings/render state/errors、VAO/FBO/query/pipeline/transform-feedback 等局部状态、native EGLContext、cache/scratch/owner/generation。
- Share group:buffer/texture/renderbuffer/sampler/shader/program/sync 的共享对象 registry 与名称分配、native object映射。不能直接共享整个 BufferState/TextureState,因为它们还包含局部 bindings。
- Thread current:TLS 指向 context/session,owner 本身不应简单放 TLS;context 移交线程仍应保留状态。server apply显式设置 runtime scope。
当前 wire SurfaceOp 没有真正 Create/DestroyContext、share-group语义。多client线程的GL records可能交错,提交记录或不可拆分批次必须有准确 context身份,不能只靠最后一个 MakeCurrent决定归属。统一 embedded server可以顺序schedule多个session/context,但仍要创建正确的native contexts并遵守share-group,不等于把所有contexts别名到一个native context。
需要的真实验证:相同handle值的两个session隔离与独立关闭;shared contexts访问同一buffer/texture;nonshared contexts同名资源隔离;每context的viewport/FBO/bindings/error独立;跨线程移交;pbuffer→window→pbuffer保留资源。
WSI 现有限制
- Wayland:server pbuffer → readback RGBA → flip/swizzle → 三槽 wl_shm buffer → wl_surface;有独立 release event queue。
- 未跟随
wl_egl_windowresize;也没有隐藏窗口/pacing 完整验收。 - 当前 GLES frontend 的版本/precision 等能力尚不能当完整 GLES 支持;
GL_VERSION仍 desktop 4.6,precisionformat 有 stub。KWin 优先 desktop GL,但 Plasma QtQuick 必须实际验证。 - GLX 草稿仅让 glxinfo 的 X drawable 可以用远端 pbuffer查询;没有 X11 readback/present,所以不能声称通用 GLX 窗口上屏。
- Surface loss 当前会结束活动 session;无损挂起/重连尚未实现。
设备与容器:只操作 HA27Q3LQ
ADB serial: HA27Q3LQ
型号: Lenovo Y700 TB321FU
root: 可用,su context u:r:su:s0
SELinux: Enforcing
Droidspaces: v6.4.5
CLI: /data/local/Droidspaces/bin/droidspaces
clone: /data/local/Droidspaces/Containers/arch-kde-mgl
mount root: /mnt/Droidspaces/arch-kde-mgl
desktop user: swung0x48,uid1000
clone UUID: bc34a4c0a69e424a8890836ed61e4a1d
clone init PID: 27123(继续前重新确认)
boot_id: 3f4027fc-50de-400a-8751-cc925d61e99d
有另外三台 ADB 设备,所有命令必须带 -s HA27Q3LQ。设备多次短暂 offline,adb -s HA27Q3LQ reconnect 后恢复;uptime 与 boot_id 证实没有重启。不重启全部 adb server、不操作其他设备。
原 arch-kde 保持停止、配置未改。clone 从其 128GiB sparse ext4 image 拷贝约 7.7GB allocated extents;因为 Toybox/Busybox 不支持 conv=sparse,用 NDK SEEK_DATA/HOLE helper。不要重复全量复制。
clone Mesa 基线曾实测:freedreno FD750,OpenGL 4.6 Mesa 26.3.0,1280×800、scale2、120Hz。这是 Mesa 基线,不是 MobileGL 成果。
仅 clone 安装过构建依赖 GCC16.1.1/cmake/ninja/base-devel;没有 clang。clone 的 patched Xwayland 24.1.13-1.1 为安装依赖降到仓库 -1,原容器未动。实验 backend 对 Xwayland 使用 -shm 并清除其 MobileGL loader 环境。
当前停止状态与目录 bind
clone 仍运行,desktop-session.service、mobilegl-kwin-build.service 均 inactive/dead(构建 ExecMainStatus=0),没有实验 KWin/Plasma/Konsole/MobileGL server 运行。
已在 clone config 追加:
bind_mounts=/data/local/tmp/display_daemon.sock:/run/display.sock,/data/local/tmp/anland-mobilegl:/run/anland-mobilegl
配置备份:/data/local/Droidspaces/Containers/arch-kde-mgl/container.config.mobilegl-before。
追加的目录 bind 尚未生效:clone 没有重启。 使用目录 bind 是为了 daemon unlink/recreate socket 时不留下 file-bind 的旧 inode。
clone service override 已准备、尚未启动:
/etc/systemd/system/desktop-session.service.d/mobilegl.conf
[Service]
ExecStart=
ExecStart=/opt/mobilegl/bin/mobilegl-startup.sh compositor
Environment=ANLAND_SOCKET=/run/anland-mobilegl/display.sock
原 service 的 User=swung0x48、PAMName=login 保留。单纯 droidspaces --user=... run 不会建立正常 logind/user D-Bus session,Plasma mode 要借此 service 或等效正常登录。
实验 display daemon 已启动(不是 MobileGL renderer,只是原有协议 broker):
host socket: /data/local/tmp/anland-mobilegl/display.sock
binary: /data/adb/modules/anland-daemon/display_daemon
log: /data/local/tmp/anland-mobilegl/display-daemon.log
实验 PID: 13993(继续前确认)
原 daemon PID: 2315,socket /data/local/tmp/display_daemon.sock(未停止)
实验 APK 启动时 --es socket_path /data/local/tmp/anland-mobilegl/display.sock;KWin 使用容器 /run/anland-mobilegl/display.sock,在目录 bind 生效后才成立。
Android 安装与尚未解决的权限
原有 com.anland.consumer(uid10253)、com.anlandnext、com.droidspaces.app 未覆盖。
已并排安装实验 APK com.anland.consumer.mobilegl(uid10269)。安装的是早期双 Service 草稿,不是最新 source 的生命周期修正版。它启动后因没有 KernelSU root grant,socket root helper 探测失败,转到 Settings;PID12420。没有 MobileGL renderer 启动、没有 GPU 连接测试。
KernelSU ksud profile CLI 仅支持 sepolicy/template,没有直接 root allow grant。已查 manager 对应源码,GET/SET_APP_PROFILE ioctl 是 manager UID 专用,root 本身也不能直接调用。授予实验包权限仍未解决;没有编辑 opaque allowlist,没有改变 manager 注册,没有完成 grant。
对应 upstream SHA 4d396fda53e510d75f2608a184df56ccd33aac9c。临时源在 C:\Users\Swung0x48\AppData\Local\Temp\anland-mobilegl-device,包括 manager-ksu.h、manager-ksu.cc、kernel-supercalls.c、kernel-manager.h、kernel-allowlist.c、ksucalls.rs、app_profile.h。普通 ksu.h 被 kernel版本覆盖,用户态ABI应读 manager-ksu.h。ioctl11/12分别 GET/SET_APP_PROFILE,only_manager 检查 current UID。尚未编译/执行profile mutation helper。
Android 全局 Enforcing,但已安装 Droidspaces module 的 sepolicy.rule 包含 permissive droidspacesd。这不是本任务设置的。该 module 已有双向 fd use 与部分 unix_stream read/write 规则。容器 → APK abstract socket、SCM_RIGHTS/memfd 的实际 AVC 尚未采集。不要先全局 setenforce0;待统一 server 上线后精确实测。
构建产物、日志、复用方法
WSL
发行版名称 archlinux,16CPU、约14GiB RAM。
wsl -d archlinux -- bash -lc '...'
Linux NDK /root/builds/android-ndk-r27c(27.2.12479018),Linux Android SDK /root/anland-mgl-sdk,JDK17 task-specific 使用(默认 JDK25 未改)。
Windows Gradle 在 Zulu21 和 Android Studio jbr 都因 PipeImpl/WEPollSelector AF_UNIX “Invalid argument” 在 daemon 前失败,属于本机 Java 环境。已用 WSL JDK17 成功构建,不要再次浪费时间试 Windows flags。
WSL 直接联网曾超时,Windows 下载可用。task-local CONNECT relay:
脚本: C:\Users\Swung0x48\repos\anland-legacy-mobilegl-unified\build\windows_build_proxy.py
Windows listener: 127.0.0.1:18081
Python PID at snapshot: 29096
exec session originally: 75964
Gradle/sdkmanager 配置 HTTP/HTTPS proxy 127.0.0.1:18081,没有改变主机全局设置。复用前查进程;任务结束可停止这个明确的 helper。
Android MobileGL
build: /root/anland-mgl-build/android
configure log: /root/anland-mgl-configure.log
build log: /root/anland-mgl-android-build.log
arm64-v8a / android-26 / c++_static / Release / split ON
targets: MobileGL MobileGLServer
493 actions 构建成功。stripped libMobileGL.so 约17.6MB(unstripped约329MB)。8 个 embedded ABI exports 经 dynamic nm 验证。
anland 打包 dist:
C:\Users\Swung0x48\repos\FoldCraftLauncher\MobileGL\build\anland-dist
/mnt/c/Users/Swung0x48/repos/FoldCraftLauncher/MobileGL/build/anland-dist
当前 dist 含 libMobileGL.so、libMobileGLServer.so、EmbeddedServer.h;它是旧架构构建,后续需重新构建统一 runtime,不要盲用旧二进制。
最新读取 Android generated/MGGitHash.h:stamp 32c79f41350186274b6d545083656d564c0ea80f;native client stamp a5b463a5。build 时曾包含未提交源码,stamp 不能证明实际源状态。最终两端使用相同确认 commit 显式 -DMOBILEGL_BUILD_STAMP=<commit> 重新构建,并验证 wireFingerprint,不要忽略 build drift。
一次 WSL shell quote 失误曾留下 /libMobileGL.so、/libMobileGLServer.so、/EmbeddedServer.h 任务残留,正确定向产物已复制到 dist。若清理只清这些明确文件,不广泛清理 /。
Android anland APK
C:\Users\Swung0x48\repos\anland-legacy-mobilegl-unified\consumers\anland_v5\android_consumer
artifact: app\build\outputs\apk\plain\debug\app-plain-debug.apk
bundled APK 已构建成功,ZIP 验证包含 MobileGL 与 Anland JNI(APK压缩约7.38MB)。最新 session96573 已结束:BUILD SUCCESSFUL,28秒,42tasks。较新的 build artifact 包含生命周期修正,但没有装到设备;仍含被否定 AppsService。Android source没有比该APK更新的改动,AppsService removal补丁没有生效。
最新 APK:2026-10-01 13:07:18,7,381,976 bytes,SHA256 CD15C203226AFB95D1464DDB0B52DD232FFFA22392794E3C086E8F09EB4D7772。JVM测试11suites、98tests、0failure/error/skipped;这是现有逻辑测试,不能验证统一Service或GPU。
已有可复用构建脚本及日志:
wsl.exe -d archlinux -- bash /mnt/c/Users/Swung0x48/repos/anland-legacy-mobilegl-unified/build/build_bundled_apk.sh
脚本固定JDK17/SDK/proxy/gitpaths,调用GradleWrapperMain。WSL日志 /root/.gradle/daemon/8.11.1/daemon-256044.out.log,HTML报告 app/build/reports/tests/testPlainDebugUnitTest/index.html。无activeGradle/Java build。
生命周期仍待复核:Worker.onDestroy没有join server thread;detach/uninstall 3秒超时返回值处理弱;load/install部分失败的清理未验证。随统一server设计处理,不能认为上述Surface修复已涵盖完整shutdown。
Gradle properties 是:-PmobileglDist=...、-PanlandNdkVersion=27.2.12479018、-PmobileglApplicationId=com.anland.consumer.mobilegl。不是 anlandApplicationId。
MOBILEGL_DIST=/mnt/c/Users/Swung0x48/repos/FoldCraftLauncher/MobileGL/build/anland-dist \
./gradlew :app:assemblePlainDebug :app:testPlainDebugUnitTest \
-PanlandNdkVersion=27.2.12479018 \
-PmobileglApplicationId=com.anland.consumer.mobilegl
WSL 读 Windows worktree .git 文件的 C:/... path 有问题。Gradle版本追踪用明确 GIT_DIR/GIT_WORK_TREE 指向 /mnt/c/...,不要把运行成功但版本为 unknown 的结果当最终可追溯产物。
容器 client
/root/mobilegl-unified-src
/root/mobilegl-unified-build
/root/anland-build-client.sh
/root/mobilegl-unified-client-build.log
GCC Release split ON、LTO OFF、ninja -j4 构建完成并安装:
/opt/mobilegl/lib/libMobileGL.so # 约21MB
/opt/mobilegl/lib/libEGL.so(.1) # aliases
/opt/mobilegl/lib/libGL.so(.1) # aliases
/opt/mobilegl/share/glvnd/egl_vendor.d/50_mobilegl.json
JSON library_path 指向 /opt/mobilegl/lib/libMobileGL.so。当前 source tar 不是完整 git checkout,源码更新需要同步;此前 tar 过宽排除 build/test 曾漏 xxHash/build/cmake 与 spirv-tools/test,已经补齐。
client 曾在 ADB offline 时中止,之后 nohup 恢复;当前构建完成,不要重复全量 build。最终统一状态改动需要增量同步与重构建。
诊断程序 /opt/mobilegl/bin/anland-egl-smoke 已编译,source 在 clone /root/anland-egl-smoke.c 和 Windows MobileGL build/anland-egl-smoke.c。测试 EGL pbuffer、GL renderer、clear/readback RGBA预期64,128,191,255。从未运行,不能算通过。
容器 KWin
source/build: /root/mobilegl-build/kwin-6.7.4/build
log: /root/mobilegl-build/kwin-build.log
installed binary: /opt/mobilegl/kwin/bin/kwin_wayland
installed library: /opt/mobilegl/kwin/lib/libkwin.so*
helper: /opt/mobilegl/bin/mobilegl-startup.sh
full build 1358 actions 通过;uid1000 --version 为6.7.4,ldd 验证加载 /opt/mobilegl/kwin/lib/libkwin.so.6。实际 build lib 在 build/bin,不是 build/lib。
执行位曾因 Windows re-tar 丢失:上游 src/plugins/strip-effect-metadata.py 已恢复755;不是 C++失败。
KWin 使用系统 GLVND + vendor JSON。只把 rebuilt libkwin目录放 LD_LIBRARY_PATH;不要把 /opt/mobilegl/lib 放入 KWin LD_LIBRARY_PATH,抢走 GLVND EGL库。glxinfo 的直接 libGL facade 可单独 scope /opt/mobilegl/lib。
Host tests
/root/anland-mgl-build/host
/root/anland-mgl-build/host-build.log
/root/anland-mgl-build/host-server-tests.log
/root/anland-mgl-build/test-embedding
/root/anland-mgl-build/test-embedding.log
20 项测试通过:14 display/ABI、2 Unix pool、3 inprocess、1 parent-death。验证真实 SHM connections/fork/lifetime,不是实际 GPU 渲染测试。
CMake test 子目录早于 server target,显式构建 MobileGLServer,不能依赖 test target自动构建它。host clang22构建已完成,无 active cmake/ninja/test/server任务。
Host configure 使用本地GoogleTest:-DFETCHCONTENT_SOURCE_DIR_GOOGLETEST=/root/mobilegl-build/_deps/googletest-src,避免网络clone。已经通过的suite复跑:
ctest --test-dir /root/anland-mgl-build/host \
-R '^(EmbeddedServerTest|ServerDisplayTest|UnixSupervisor|InProcessServer|SupervisorChildren)\.' \
--output-on-failure
协议测试复跑命令:
wsl -d archlinux -- bash /mnt/c/Users/Swung0x48/repos/anland-legacy-mobilegl-unified/tests/run_mobilegl_surface_exchange.sh
命令与续接注意事项
Android/client env(以后统一 endpoint 名称需据新设计修改):
MOBILEGL_TRANSPORT=spawn
MOBILEGL_IPC_DATA=shm
MOBILEGL_IPC_CONTROL=unix:@<embedded-endpoint>
# compositor: MOBILEGL_IPC_SURFACE=server
# applications: MOBILEGL_IPC_SURFACE=offscreen(或清除)
MOBILEGL_TRANSPORT=shm 无效,会落回 monolith;MOBILEGL_IPC_SURFACE=client 也无效。Listen/serve endpoint是 @name,client必须 unix:@name。
PowerShell 的 adb compound shell command 要保持 su quoting。以下错误写法只让第一条命令成为root:adb shell su -c 'id; id -Z'(adb flatten后分号跑到外层)。正确例子:
adb -s HA27Q3LQ shell "su -c 'id; id -Z'"
更深的嵌套用 literal here-string或 push script,别使用 bash 的 \" 去转义 PowerShell字符串:
$mglCmd = @'
su -c '/data/local/Droidspaces/bin/droidspaces --name=arch-kde-mgl run bash -lc "ls -l /run/display.sock; id"'
'@
adb -s HA27Q3LQ shell $mglCmd
推荐续接顺序
- 阅读本文、用户原话、kgsl-as-server与调研;检查两个本地 workspaces,保护用户原有dirtysubmodules。不要重复 clone或基线build。
- 首先完成 MobileGL 真正的 session/context/share-group/global-state设计,并移除 anland 应用离屏 Service/forkworker路径与对应旧文档。不要先把旧 APK再次部署来制造进展。
- 保留有用的 embedded ABI、Surface生命周期、无fd显示协议、KWinB路线改动;新增状态/资源生命周期测试要真实覆盖多session、多surface、多context及share-group。
- 增量构建统一 server与client,明确同一源码revision;构建APK并审查再安装。解决实验包 KernelSU rootgrant,待clone安全重启后使目录bind生效,保持原环境。
- Enforcing下采集真实 socket/SCM_RIGHTS/memfd AVC并精确处理;确认 renderer仍在anland自己的进程/UID。
- 先KWin单Surface真正上屏(renderer信息、GPU像素/截图、输入与帧节奏);然后Konsole、eglinfo、glxinfo、Plasma。不能只用进程存在或版本字符串判成功。
- 按实际失败修WSI、context共享、resize/Surface loss;记录截图与日志。阶段代码commit、推两个用户指定分支,最终写可复现步骤与真实限制。
目前没有合入/部署/最终验收请求被拒绝的自动审批。用户已授权实验clone、构建安装、修改、commit/push;除新的明确破坏性动作或确实缺失信息,不要重新索要相同授权。