Files
MobileGL/docs/Disaggregated/notes/anland/handoff-legacy-mobilegl-unified.md
T

98 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Handoff:anland 5.x + 内置 MobileGL 统一 server(post-P14)
更新时间:2026-10-02。本文替换旧的 handoff-legacy-mobilegl-unified.md(那份描述的是 P14 之前的状态,已被事实淘汰)。
## 任务与路线
anland 5.x 用 MobileGL:容器(Droidspaces,arch-kde-mgl)里的 Linux client 经 SHM pipe 连到 anland APK 内嵌的统一 server(`:mobilegl` 私有 Service,同 APK 同 UID),server 在 anland 自己的 Surface 上直接渲染(路线 B:`kgsl-as-server.md`)。不按应用 fork 渲染进程——session/context/share-group 状态归属在 MobileGL 库内解决(P14,[`../design/11-state-ownership.md`](../design/11-state-ownership.md))。
## 远端与分支
- MobileGL:<https://github.com/MobileGL-Dev/MobileGL> 分支 `feat/disaggregated`
- anland:<https://github.com/MobileGL-Dev/anland> 分支 `legacy-mobilegl-unified`
### MobileGL 关键提交(新→旧)
| Commit | 内容 |
|---|---|
| `4b388950` | Magma:VAO/元素缓冲指向一个 server 没有存储的 buffer(client 构造时就铸 handle,create 只随第一次 respecify 过线)时拒绝该 draw 而非 Fatal;纹理的内置 sampler CSO 缺失或已回收(CSO 按内容寻址、满 256 回收)时按 GL 默认参数采样——两处都与 DirectGLES 的「decline」行为对齐。glmark2 全场景(refract/effect2d 此前带走 server)通过 |
| `7e76a98d` | **Magma 多 surface + 多 context**:一个 session 一个 `VulkanRenderer`(device 与全部 GL 资源),每个客户端 EGLSurface 只是一个「surface target」(VkSurfaceKHR + swapchain + render-finished 信号量 + 已获取图像 + pbuffer 的 AImageReader),切换时提交当前工作、用一次空提交消耗挂起的 acquire 信号量后停放,回来时原样换回(`ActivateSurfaceTarget`/`DestroySurfaceTarget`,此前每次切 surface 都重建整个 VkInstance/VkDevice,所有 buffer/纹理丢失 → Chrome `unknown-buffer-respecify`);默认帧缓冲 render pass 的 hash 带 target 序号;`bind_context` 时 Magma 后端切回该 context 最后一次 make-current 的 surface(`OnClientContextBound`,Qt 每窗口一线程一 context,此前读回落到别的窗口的 pbuffer);**wire resource ops 表在 server 进程里只要有 session 活着就不注销**(此前任一 session 的 renderer 关闭——比如 ksplash 退出——都把进程级表清空,之后所有 session 的 buffer create 被静默丢弃:plasmashell 面板/弹窗全透明) |
| `15dbe78c` | **Magma 按 session 隔离**:Magma 原本一进程一 renderer,`pVulkanRenderer`、`g_activeBufferManager`、动态状态影子、render pass manager 的静态指针、各 `s_device`、renderer generation、swap interval 都是进程全局——多 session 下 KWin 的 buffer 写落进别的 session 的表(`buffer-write-range` Fatal)。新增 `MagmaSession`/`SessionLocal<T>`(`MG_Backend/DirectVulkan/MagmaSession.h`):按调用线程绑定的 session 解析,未绑定线程(monolith、client、单测)用进程默认 session,行为不变;served session 的 apply 线程在 `ServerLoop::ApplyThreadMain` 里经 `BackendObject::BindSessionStateToThisThread` 绑定;扩展函数指针改成 renderer 成员;哈希 scratch 状态、scratch 向量改 thread_local |
| `168808d1` | Magma 也广告 GL_ARB_shader_objects/vertex_shader/fragment_shader/texture_non_power_of_two(KWin `checkSupported` 门槛,此前 KWin 在 Magma 上 "Could not initialize rendering context");Android 上 `debug.mobilegl.backend` 系统属性可覆盖 `MOBILEGL_BACKEND_TYPE`(可调试 APK 换后端无需重签) |
| `cd610934` | **锁屏花屏/桌面变噪点的根因**:`object_death` 记录到达 server 时,`SlotTable::ReleaseTwinByHandle` 遍历进程内**所有** slot table(所有 session 的所有 bucket)释放该 handle 的 twin。handle 是各 client 自己的分配器编号,不同 session 的同一 `{slot, gen}` 是各自不相干的活对象——锁屏 greeter 退出时删除自己的纹理,同时把 KWin 同 handle 的 twin 也释放了(KWin 正在用的 driver 纹理被删,plasmashell 窗口采样到已释放显存:噪点 + 别的窗口的残影)。现在 slot table 记录自己所属 session,释放只走调用线程 session 的 bucket(同 session 的各 share group 都释放;无 session 的线程保持全进程遍历)。顺带修掉另外两类跨 session 隐患:DirectGLES 进程级「容器对象」(scratch/blit/resolve FBO、staging FBO、模拟绘制的 VAO)改为按原生 context 分(`PerNativeContext`/`NativeContextName`,按 context 生命期序号,context 销毁时遗忘);UBO/unpack/upload 三个持久映射 ring 改为每原生 context 一套,帧 fence 完成水位改为「连续」(任一更早的 fence 未 signal 都不前进,fence 环加深到 32 且回绕时等待旧 fence 而非丢弃) |
| `4236b42a` | server:配置只在进程内第一个 session 接入时初始化一次——此前每个新 session 接入都重跑 `MG_ConfigLoader::Init()`,它先把 `Transport` 写回 Monolith 再被改回 Spawn,正在 apply 的别的 session 恰好读到就跳过 server stamp,`Fatal{UnmigratedPipeInput, "GetBoundVertexArray@DrawArrays"}` 带走整个 server 进程(整个桌面);转译:保留下来的非零 `layout(index = 1)`(双源混合)在 ESSL 里加 `#extension GL_EXT_blend_func_extended : require`(此前 Adreno 拒绝该 stage,程序整体不画) |
| `0b6842ac` | 让 ANGLE 的 GL 后端跑在 MobileGL 上:EGL 声明 `EGL_KHR_platform_gbm`/`EGL_MESA_platform_gbm`(GBM display 当离屏 display,拒绝 gbm 窗口 surface;Chrome 的 Wayland GL 层对每个 display 都标 GBM 平台);平台标 GBM 但 native display 实为 wl_display 时按 Wayland 处理,wl_display 识别兼容自带一份 libwayland 的程序(按接口名 "wl_display" 判断,经 `process_vm_readv` 读,野指针不会崩);实现 `glGetShaderPrecisionFormat`(此前是空 stub,ANGLE 读到 0 精度即拒绝 ES 2.0);`GL_VERSION` 里不再出现 "OpenGL ES" 子串(ANGLE 用子串搜索判断 ES 驱动,"Direct (OpenGL ES) Backend" 让它把 MobileGL 当 ES 驱动、按 ES 扩展名查 BGRA 等能力,Chrome 的 shared image 全部创建失败) |
| `47db68d5` | GLX:MobileGL 同时是 glvnd 的 GLX vendor(`__glx_Main`,装成 `/usr/lib/libGLX_mobilegl.so.0`,会话设 `__GLX_VENDOR_LIBRARY_NAME=mobilegl`;此前 X11 客户端经 Xwayland 拿到 Mesa vendor,报 `MESA-LOADER: failed to retrieve device information`);远端 X drawable(pbuffer)每次 `glXSwapBuffers` 回读并用 `xcb_put_image`(按服务器最大请求长度分带)上屏,resize 换新 pbuffer;GLX 出口持流锁;`eglReleaseThread` 在 MobileGL 已被 `eglTerminate` 拆掉后也返回 TRUE(glmark2 退出时的 "eglReleaseThread failed") |
| `ccf8eb65` | 客户端:多线程 GL 流串行化——每个 GL/EGL 出口持同一把流锁,写入前按「最后真正发出的 `bind_context`」把 server 绑到调用线程的 context(Qt 每个窗口一个 QSGRenderThread,此前两线程记录在同一 ring 上交错、落进错的 applier、甚至撕裂记录);`MGPipeTracker` 按 context 的永不复用 id 判断换 context(指针 ABA);导出 `eglCreateImageKHR`/`eglDestroyImageKHR`(KWin 在 shm client 断开时调空指针 → 首个 KWin 约 2 秒必 SEGV);`eglGetPlatformDisplayEXT` 的 EGLint 属性表加宽;多窗口:surface 激活不再清空别的线程的 current 记录,swap 呈现本线程的 surface;Wayland 窗口 `wl_egl_window_resize` 在下一次 make-current/swap 生效 |
| `0b314dda` | server:所有 session 的 apply 线程在一把 FIFO「backend turn」上串行(DirectGLES 是按单 GL 线程写的:单一 owner 线程、进程级绑定影子),换手时接管 owner 并清掉绑定影子;全部原生 context 进同一 share group(环、池、scratch 纹理是进程级 GL 对象);每个客户端 surface 一个原生 surface(激活时重绑而非新建),建 surface 后恢复当前 context 自己原来的 surface,释放 surface 只销毁它(此前 `DestroyEGLContext` 带走整个 session 的 context),`bind_context` 恢复 context 自己的 surface;pbuffer 背后的窗口 resize = 换新 pbuffer;session 结束时若别的 session 的 context 还活着,只清本 session 的东西(此前进程级 generation 被推进,所有活 session 的纹理/缓冲被当成死的空重建 → 关弹窗/退出 client 后全屏噪点);分块上传(stage chunk 切片)的 region 偏移按整层图像校验(此前 KWin 的 wl_shm 纹理在第 819 行后读到第 0 行);`SetSamplerViews.Count` 改为 per-session latch |
| `30fef23d` | P14 收尾(统一 server 的两处进程级状态):server 的两个 staged store(纹理 level 声明、buffer shadow)按调用线程的 {session, share group} 分桶(与 S6 twin 表同一个探针),`DropAll` 只清本 session;`MGPipeServerSetContextLive` 的 live 标志从进程全局移进本 session 的 PipeInputs 块。各带单测(`StagedTextureStoreTest` 两例、`ServerContextLiveTest`) |
| `d554c87c` | EGL loader 缺 `eglSwapBuffersWithDamageEXT` 不再 FATAL(EXT→KHR→eglSwapBuffers 回退 + GLES 符号 dlsym 回退防自指);stencil-only 存储格式配对修复;各带测试 |
| `7a48521d` | DirectGLES:创建 server-owned window surface 前先销毁同窗口的残留 surface(此前第二个起的 session 必死 EGL_BAD_NATIVE_WINDOW) |
| `5a0f13fd` | 广告 GL_ARB_shader_objects/vertex_shader/fragment_shader/texture_non_power_of_two(KWin `checkSupported` 的硬门槛) |
| `ff212061` | P14 S6:后端 twin 表按 {session, share group} 键控 |
| `4ed1c9ce` | P14 S1–S5:`bind_context`(opcode 84)+ CreateContext/DestroyContext 控制帧(control revision 6);同进程多 session(`SessionRuntime`、线程域解析、per-session latch,inproc unix supervisor 并发上限 `MOBILEGL_IPC_INPROC_MAX_SESSIONS`=16);前端 ShareGroupState/per-context GLContext/TLS pGLContext;DirectGLES per-(session,context) native tuple(不再无条件 teardown);applier 按 {session,context}/{session,shareGroup} 分桶 |
| `ebc552a0`/`6fb880cd` | Wayland Present 失败回 EGL_BAD_SURFACE;GLX drawable 走远端 pbuffer;Linux libGL 别名 |
| `d52c031c` | P14 设计文档 |
### anland 关键提交(新→旧)
| Commit | 内容 |
|---|---|
| `5f15240` | 会话可选后端:APK 的 `:mobilegl` worker 从 `files/mobilegl-backend` 读后端(`am start ... --es mobilegl_backend DirectVulkan` 写入),容器侧 `mobilegl-startup.sh` 从 `/etc/mobilegl/backend` 读并导出给 KWin drop-in 与 dbus 激活环境(server 一进程只服务一种后端,client 必须报同一种,否则 "Hello.backendType disagrees with pinned backend") |
| `56b060c` | 恢复工具链入库 `producers/kde/Arch_v5/mobilegl-tools/`(KernelSU grant helper、源码同步与容器内 client 构建、EGL smoke 探针、设备侧部署/daemon 脚本) |
| `1fb419a` | mobilegl-startup.sh:默认 socket 指向实验 daemon(/etc/environment 的 pam_env 会盖掉 systemd drop-in);plasma 模式改走 kwin_wayland_wrapper(BusName=org.kde.KWinWrapper 只在 wrapper 注册,直跑 kwin 90 秒被 systemd 杀);KWin 直写 surface 不加 FlipY(此前画面上下颠倒);sync-build-kwin.sh 容器侧 canonical 同步/增量构建/原子安装管线 |
| `118ae52` | `MOBILEGL_BACKEND_TYPE=DirectGLES`(Espryt 只是别名,写错会被 pinned-backend 拒);eglChooseConfig 收 count≥1(MobileGL 默认有两份配置);compositor client 日志落文件 |
| `da03d3b`/`35699f3` | consumer flap 时不再停 compositor;APK consumer 侧不再因 Surface 生命周期事件重启 native 管线 |
| `33e496c` | 统一内嵌 server 宿主:`:mobilegl` Service 单 endpoint `@anland-mobilegl`;移除被否定的 MobileGLAppsService/按应用 fork 路径 |
| `2ffa1f5` | KWin anland backend 的 `ANLAND_MOBILEGL=1` 路径(跳过 GPU/DRM probing,server-owned window) |
| `6e1fa65` | 无 fd 的 MobileGL Surface 显示协议(DATA_MSG_MOBILEGL_SURFACE=201) |
## 真机已验证(TB321FU,HA27Q3LQ)
以实际画面/输出为准:
- **链路绿屏**:client clear → server(Adreno 750 厂商驱动)→ Android Surface → 屏幕,截图可见(win-smoke,60 帧 swap 无错误)。
- **egl-smoke**:pbuffer + clear + readback RGBA 精确(64,128,191,255)。
- **eglinfo**:GLVND vendor JSON 正常,EGL 1.5,两组配置。
- **glxinfo / glmark2(X11)**:经 glvnd 的 MobileGL GLX vendor,不需 `LD_LIBRARY_PATH`;glxinfo 报 Espryt (Adreno 750) GL 4.6;glmark2(X11 窗口经 Xwayland)画面正确上屏,shading 场景约 280 fps;glmark2-wayland / glmark2-es2-wayland 正常且退出无报错。
- **KWin 6.7.4**:合成器存活并呈现(黑桌面+光标可见)。
- **Konsole**:窗口完整正确渲染(标题栏、工具栏、shell 提示符,方向正确)。
- **多 session**:两个 win-smoke 连续运行同一窗口均 exit 0(stale surface 修复生效)。
- **Chrome 跑在 MobileGL 上(2026-10-02)**:会话的 Chrome 启动项(`mobilegl-startup.sh chrome`,plasma 模式写入用户级 `google-chrome.desktop` 覆盖)用 `--use-gl=angle --use-angle=gles --in-process-gpu --render-node-override=<不存在的节点> --disable-features=WaylandFractionalScaleV1`:ANGLE 报 `ANGLE (MobileGL-Dev…, Espryt…, OpenGL 4.6.0 MobileGL…)`,GPU 合成开启,标签栏/工具栏/网页正确合成,缩放正确。为什么这样配:Chrome 的独立 GPU 进程在 Wayland 上只能经 GBM dma-buf 上屏(MobileGL 与本 KWin 都不收),放进浏览器进程后改走 wl_egl_window(MobileGL 的 wl_shm 呈现);该路径下 Chrome 不发 fractional-scale 的 viewport,整数缩放才会发 `set_buffer_scale`。此前镜像自带的 `/usr/local/bin/google-chrome` 是 `--use-angle=vulkan` + renderD128,走的是容器里的 Turnip。
- **Plasma 桌面可用(2026-10-02,`ccf8eb65`:server 与容器 client 同源)**:壁纸、面板、托盘、时钟、桌面图标、Kickoff 开始菜单、通知窗口都正确渲染;鼠标/触摸输入可用(点击打开 Kickoff);KWin 过渡动画正常;开/关托盘弹窗不再花屏;按返回键收起快捷键栏时输出 resize 跟随。三线程/三 context/三 surface 并发回读探针(`anland-egl-mt-readback-probe.c`)与大纹理分块上传探针(`anland-egl-upload-probe.c`)全过。
- **Magma(DirectVulkan)与 Espryt 同等可用(2026-10-02,`4b388950`)**:KWin 合成(约 140 fps,apply 2–3 ms/帧)、plasmashell 真正经 Magma GPU 渲染(壁纸、面板、托盘、桌面图标、带模糊的 Kickoff、通知弹窗;托盘里不再有「正在使用的软件渲染器」)、glxinfo 报 `Magma (MobileGL Core) (Adreno (TM) 750, Vulkan 1.3.128…)`、glmark2(X11)全 16 场景跑完 score 47、glmark2-es2-wayland score 50、Chrome 正常(剩余问题与 Espryt 相同:WebGL 画布空白、扩展图标黑块)、`kscreenlocker_greet --testing` 正确渲染且退出后桌面无噪点。切后端:`setprop debug.mobilegl.backend DirectVulkan` + `/etc/mobilegl/backend` 写同名 + 重启 APK 与会话。
- **Plasma 会话(早期,`30fef23d` 的 server + `ff212061` 的容器 client)**:`desktop-session.service` 持续 active(>1 分钟,此前约 7 秒必拆);面板完整渲染(启动器、固定应用、托盘、时钟);光标尺寸正常;多个 session 并发、逐个 reap 而其余继续服务。截图里壁纸有横向条带错位(见下面第 1 条)。
## 未完成 / 已知问题(按优先级)
1. **Plasma:桌面已落地、基本可用,剩余问题**(按优先级):
- ~~启动 Chrome 时 KWin 崩溃~~ 已修(anland `kwin.patch`):无 DRM 设备分支里 `waylandServer()->linuxDmabuf()` 会创建 linux-dmabuf global,而空 tranche 不建格式表,Chrome 请求 default feedback 时 KWin 解引用空表(`LinuxDmaBufV1FeedbackPrivate::send` → `FileDescriptor::get`)。现在该分支不碰 dmabuf,client 回落 wl_shm;Chrome 新标签页正常渲染。KWin shim 现在在 `/tmp/kwin-cores/<pid>/` 下运行,core 不会再被覆盖。
- **某个 client 退出时 KWin 偶发 SEGV**(rc=139,core 被覆盖未取到);KWin 在 server 进程被杀时也会 SEGV(设备丢失路径),后者是预期外但可接受。
- **ksplash 启动动画闪黑**:开机时 ksplash 帧间偶有整帧黑;单独 `ksplashqml --test` 在会话内不复现。约 13–15 fps(每帧 2560x1412 全尺寸回读 + wl_shm + KWin 重新上传),见第 3 条。
- 合成成本:每个 Wayland 窗口每帧整幅 glReadPixels(2 MiB 一片)+ KWin 整幅 glTexSubImage,是当前帧率上限。
- DirectGLES 里少量进程级「容器」对象(resolve FBO、scratch FBO、XFB helper、timer query 探测)不在 share group 里共享,多 session 交替使用时理论上会拿到别的 context 的名字——尚未观察到症状。
- **Chrome 剩余渲染问题**:WebGL 画布不显示(get.webgl.org 的立方体区域空白、aquarium 只有底色,fps 计数正常),工具栏两个扩展图标是黑块;两边日志都无报错,待查(怀疑 shared image 的某种格式/swizzle 或画布合成路径)。
- ~~锁屏界面花屏~~ 已修(见上表):复现方式 `kscreenlocker_greet --testing` 起一个测试模式 greeter 再杀掉(本会话的 logind session 类型不支持 `loginctl lock-session`,真锁屏后只能输密码解锁);修复前几乎每次都让桌面/面板变噪点,修复后多次 + 并发 client 压测均正常。定位手段:给 `BackendTextureObject` 记录创建 session,析构时 session 不符就打 `_Unwind_Backtrace` 栈(符号用 NDK `llvm-addr2line` 对未 strip 的 build-android/libMobileGL.so 解)。
- **Plasma 的软件渲染回退是粘滞的**:server 崩溃时 plasmashell 收到 device lost,Plasma 会把 `[QtQuickRendererSettings] SceneGraphBackend=software` 写进 `~/.config/kdeglobals`,之后每次会话都用 CPU 渲染 Qt Quick(托盘出现「正在使用的软件渲染器」图标),即使 GL 已经修好。排查任何 plasmashell 渲染问题前先确认该键不存在:`kwriteconfig6 --file kdeglobals --group QtQuickRendererSettings --key SceneGraphBackend --delete`。
- Magma 每个 session 自建 VkInstance/VkDevice(无跨 session 共享),首帧 apply 约 100 ms;内存开销随 client 数线性增长。
2. **光标巨大化**:2026-10-02 的 Plasma 会话截图里光标尺寸正常,未再复现;若再现,查 output scale 与 cursor layer 的 buffer scale。
3. **CPU blit 禁令**:用户明确要求最终形态上屏路径无 CPU blit——当前 Wayland wl_shm client 走 readback(`32c79f41`),只是过渡。目标:应用窗口内容也由 server 在 GPU 侧直接给 KWin 合成(server 侧 GPU buffer → 同进程共享给 compositor 的 share group → 合成上屏),不经过 CPU 回读。设计要进 11-state-ownership.md 的后续切片。
4. **GLX 上屏是 CPU 回读**:每帧整幅 glReadPixels + `xcb_put_image`,同第 3 条的过渡方案;只处理 24/32 位深窗口;直接拿 X 窗口(未经 glXCreateWindow)当 drawable 的 surface 不会随窗口销毁回收。
5. **surface loss**:Wayland 窗口 resize 已跟随(`ccf8eb65`);surface loss 仍结束活动 session(无损挂起未实现);server 进程被杀后,新进程下 KWin 拿不到窗口 surface(KWin 不会重连,需重启会话)。
6. **AVC 审计未做**:全程在 Enforcing 下跑通(容器侧有 droidspacesd 的既有 permissive 规则),SCM_RIGHTS/memfd 的精确 AVC 采集没做。
7. **wire stamp 漂移**:容器构建的 `MGGitHash.h` 因 tar 无 .git 而陈旧(日志 WARN "compatible wire with different build");两端应同 commit + 显式 `-DMOBILEGL_BUILD_STAMP` 重建。
## 设备与环境要点(复现用)
- 设备 HA27Q3LQ(Y700 TB321FU),clone `arch-kde-mgl`(arch-kde 保持不动),容器内 `/opt/mobilegl/{lib,bin,kwin}`。
- **KernelSU grant**:`ksud profile` 无直授命令;管理器专属 ioctl 的解法:root 下 setuid 到 manager UID(10255)→ `reboot(0xDEADBEEF,0xCAFEBABE)` 拿 `[ksu_driver]` fd → `SET_APP_PROFILE`。helper 源码在 anland `producers/kde/Arch_v5/mobilegl-tools/ksu_grant.c`。已持久化进 `/data/adb/ksu/.allowlist`。
- 实验 daemon:独立实例 `display_daemon /data/local/tmp/anland-mobilegl/display.sock`(原 daemon 不动);socket 需 666、目录 777(容器内 uid1000 要连)。
- clone config 的目录 bind:`/data/local/tmp/display_daemon.sock:/run/display.sock`、`/data/local/tmp/anland-mobilegl:/run/anland-mobilegl`。
- KWin 启动:`desktop-session.service` + drop-in ExecStart=mobilegl-startup.sh compositor|plasma;Qt 日志默认只出 warning(info 要 QT_LOGGING_RULES)。
- **当前设备上的 server 库是手工替换的**:`libMobileGL.so` 直接 root 覆盖到已装 APK 的 `/data/app/.../lib/arm64/`(保留 owner/SELinux context,原件备份在 `/data/local/tmp/anland-mobilegl/libMobileGL.so.orig`)。这样不用重签 APK(换签名要卸载重装,UID 会变,KernelSU grant 要重做)。本机构建:NDK 27.2 + `cmake -DCMAKE_TOOLCHAIN_FILE=.../android.toolchain.cmake -DANDROID_ABI=arm64-v8a -DANDROID_PLATFORM=android-26 -DMOBILEGL_BUILD_DISAGGREGATED=ON -DMOBILEGL_BUILD_DISAGGREGATED_INPROC=ON -DMOBILEGL_BUILD_STAMP=<commit>`,`llvm-strip --strip-debug` 后推送。
- **复现用探针**(anland `producers/kde/Arch_v5/mobilegl-tools/`):`anland-egl-upload-probe.c`(2560x1412 纹理整幅 + 跨分片的局部 TexSubImage 回读校验)、`anland-egl-mt-readback-probe.c`(三线程各自 context/pbuffer 并发绘制+整幅回读);在容器里以 swung0x48 身份、带 MobileGL 的 `__EGL_VENDOR_LIBRARY_FILENAMES`/`MOBILEGL_*` 环境运行。注入点击要用 `input mouse tap`(anland 抓了触摸屏 EVIOCGRAB,`input tap` 无效);不要对容器进程用 `debuggerd -b`(发 signal 35,glibc 进程直接被杀)。
- **Chrome/ANGLE 排查手段**:`--gpu-launcher=<脚本>` 包 GPU 进程(strace 每进程 `-o file.$$`,Chrome 会多次重启 GPU 进程);ANGLE 只 `dlsym` 一个 `eglGetProcAddress`,其余入口全经它取,LD_PRELOAD 拦 `dlsym` 再包 `eglGetProcAddress` 才能看到 display 调用;headless Chrome + `--remote-debugging-port` + CDP `SystemInfo.getInfo` 能拿到 GL_RENDERER/扩展列表/featureStatus(`--dump-dom chrome://gpu` 在 headless 下拿到的是新标签页)。user manager 里 PAM 带进来的 Mesa/KGSL 变量 `systemctl --user unset-environment` 删不掉(返回 0 但无效),对 MobileGL 会话无害。
- **诊断用的容器改动**:`/opt/mobilegl/kwin/bin/kwin_wayland` 现在是 shim(设 `MOBILEGL_LOG_FILE_PATH=/tmp/mgl-kwin-$$.log` 后 exec `/opt/mobilegl/kwin/real/kwin_wayland`;真二进制必须仍叫 `kwin_wayland`,否则 KWin 内置 QPA 插件拒绝加载);`~swung0x48/.config/systemd/user/plasma-plasmashell.service.d/mobilegl-log.conf` 给 plasmashell 单独日志 `/tmp/mgl-plasmashell.log`。MobileGL 打开日志是截断写,所以必须每进程一个文件。
- 构建(之前那台机器的环境,本机没有 `/root/anland-mgl-build` 也没有 gitignored 的 `build_bundled_apk.sh`;APK 按 `consumers/anland_v5/android_consumer/MOBILEGL.md` 用 gradle + `MOBILEGL_DIST` 构建):Android dist 用 WSL(NDK r27c,stamp 显式指定);APK 用 anland worktree 的 `build/build_bundled_apk.sh`;容器 client 用 `producers/kde/Arch_v5/mobilegl-tools/anland-sync-source.sh build`(`MOBILEGL_REPO` 指向已 init 子模块的 MobileGL worktree;注意 `tools/trace_replay` 789MB 必须排除)。
- 设备 30 秒无操作熄屏——熄屏可能 kill SurfaceView;长跑验证前 `svc power stayon true` 或调 screen_off_timeout。