Files
MobileGL/docs/Disaggregated/notes/p13/HANDOFF-2026-10-06.md
T

8.2 KiB
Raw Blame History

P13 交接(2026-10-06)

计划 PLAN-P13.md,裁定 INTEGRATOR-DECISIONS-P13.md,进度表 README.md,CI 清理记录 docs/ci/ci-cleanup-log.md。

1. 状态

波 状态 提交(p13 分支) CI
CI 基线修复 已推 cde6512b IN_LIST / TCP 端口;0cbb1a84 spawn Welcome 冷启动预算;c9085533 apitrace 子模块(分支 mobilegl/android-trace-replay 的 45843686:着色器 / 程序名按类型映射,修 1.17) 基线 Test 37414803850、APK 37405703442,逐条归类见 ci-cleanup-log
W1 已推 5ff33cbb runtime_mode_proof monolith = 无 MG_Remote;push 无 MG_Remote 控制库 + 零 MG_Remote 检查;retrace-split 不再因控制库失败整体跳过;skip 普查 Test 37425662897:除 verify-split 的 FencePoll 测试竞态(已修 0a47038a)与普查无基线外全绿
W2 + W3a 已推 55de98a0 普查基线 c6cb5dea;68b56165 9f05e665 3e11c848 W2;55de98a0 W3a Test 37433779649 / APK 37433779654(交接时排队中,被旧 run 卡住,已 force-cancel 旧 run)
W3b 本地 9e14c16d…a4d10dd9、daf2b44c、4d2a2443、1d380a6e、3e36bd6c、938f4b11、883b8614 本地:unit 2908 绿;integration-gpu monolith 3640/3640;inproc 与 split/spawn/tcp 在跑
W3c 本地 e2c90986 本地 unit 绿
W4a(一项) 本地 3e2aff1d 14a:indirect 无 client 数组不再回读命令缓冲;新 ResourceReadbacks 计数与场景用例 未编译验证

推送规则:W3b/W3c 等 W2/W3a 的 run 绿或红已归类后再推;推前 git fetch 看 feat 有无他人提交。

2. 关键事实(实现中发现,计划里没有或有误)

  • bit 4 不能退役:它同时门控 P5c rv 的 set_context_values。W3c 只删 ResidualValueBlock,bit 4 仍固定开。
  • 不需要控制面修订号 +1:删结构后 kMGPipeWireCatalogueDigest 变化,wireFingerprint 随之变化,新旧端按名拒绝。
  • CMake 旧缓存:MOBILEGL_PIPE_PUSH=OFF / MOBILEGL_PIPE_LEGACY_MEMOS=ON 在旧构建树(含 FCL 的 Gradle .cxx)里是默认值,所以是 WARNING + 忽略,不是 FATAL。
  • 位图固定开(ID-P13-3)在 W3b 落地:ConfigLoader 对清 bit 0-13 的掩码 Fatal{PipeSubsystemsFixedOn} + abort;Off / Refused 车道改为 DirectGLES.SubsystemMaskRefusal.<Lane> 具名拒绝对照(Harness/RefusedMaskControl.cmake,读日志确认原因)。各解析函数里 legacyMemosEnabled 改为常量 true,只为单元测试的掩码扫描不 abort;这些分支 W6 删。
  • monolith 仍走借用槽位的单元列表(UnitTexturesByHandle() 在 monolith 为 false)——这是 W4c 要换的。UnitMemoRefusesToDriveATwinFromAnotherTexture 恢复并钉 P2 掩码(单元车道没有 P4a consumer,0x3fff 下建不出记录);红检已做(见 ci-cleanup-log)。
  • 单元车道无法创建纹理记录(NoP4aConsumer),任何需要纹理记录的白盒单元用例都要放到集成层。
  • 本地 CMake 必须 3.31.10:CMake 4.x 下 gtest 的 ENVIRONMENT 列表转义不同,集成用例把 MOBILEGL_BACKEND_TYPE=DirectGLES;__EGL_VENDOR... 当成一个变量,全部假红。

3. 本地环境(WSL archlinux)

  • ~/mgl-p13-src:从主仓库克隆的 LF 工作副本(origin = Windows 主仓库,分支 p13),子模块从主仓库本地拉。~/mgl-p13-tools/sync.sh 同步到 p13 已提交状态并从主仓库工作区按 sha256 物化 LFS fixture(有 29 个缺)。apitrace 子模块的第三方子模块已 --depth 1 拉过;glslang External 用 update_glslang_sources.py 拉过。
  • 构建:~/mgl-p13-tools/build_split.sh(~/mgl-p13-split + ~/mgl-p13-retrace),build_push.sh(~/mgl-p13-push,FCL 形态),itest.sh <build> <tag>(CI 同款 integration-gpu)。PATH 前置 ~/mgl-p13-tools/venv/bin(CMake 3.31.10)。
  • 经验:WSL 命令一律写成脚本文件再 MSYS_NO_PATHCONV=1 wsl -d archlinux -- bash <file>,bash -lc '...' 的引号与 $ 会被吃;Git Bash 的 heredoc 会吃掉反斜杠,Python 编辑脚本用 Write 工具写文件再运行。
  • 工具:scratchpad 下 pyunifdef.py(W3b 用的部分求值器)、retire_names.py(从普查基线退役具名用例)。
  • ~/mgl-p13-apitrace:apitrace CLI(apitrace dump)。

3b. W4 设计要点(W4a 落地时的实际做法)

  • 谓词:MG_Config::DataArmIsRecord() / RecordArmAliasesFrontend()(Config.h)。monolith 的 MonolithTakesRecordArm 由 MOBILEGL_PIPE_DATA_ARM(默认 record,W4-W6 专用)且后端为 DirectGLES 时才为真;Magma 在其一次性换臂时加入。无 MG_Remote 构建恒 false(W5 改)。
  • 三类分支:K(生命周期、角色、caps 来源、传输层级)留 Transport;F(数据臂)改谓词;S(store 是否复制)问 CopiesIntoServerStorage()——M:3910 那处若误用谓词会把所有别名基址清空。
  • verb 端口(EmitTables.cpp「THE MONOLITH VERB PORT」):monolith 下被端口接管的槽位跑 EmitTables 的同一套规划与 pre-verb 钩子,再把记录交给进程内 ServerVerbSink(它写 VerbIndirectBuffer 等并调真表)。由 MobileGL/Init.cpp(SHARED)安装,不由 MG_Backend/Init.cpp 装——后者是 server 对象,装会让链接棘轮报新前端引用。W4a 端口槽位:20 个 draw + 2 个 dispatch。后续波把新 verb 同时加进 InstallMonolithVerbPort 与 ApplyOnMonolithPort 的 switch。
  • §1.4 别名刷新:RefreshAliasedStoreFromGpu(Managers.cpp):读回 GL buffer → OnBufferWriteback(前端把字节拷进它的影子,即别名基址)→ 清 serverGpuWritten、盖 serial、bump epoch。前提:monolith 记录臂在 sub-data 与 respecify 时就铸 twin;孤立 respecify 也带影子基址(上传仍按描述符的 HasDefinedContent 门控);contentSinceRespecify 代替别名 store 没有的覆盖集回答流式写法。
  • GPU 写标记:GpuWriteSetIsClientSide() 改谓词,client 侧的保守集由端口的 MarkGpuWritesForDraw 打;后端只标自己的 twin(serverGpuWritten)。image 单元仍在前端臂(W4c),其 buffer-texture 写在前端臂里额外标 twin。
  • 单元测试:BufferTest 三例断言前端臂的 map 推送,钉 ScopedMonolithFrontendArm,W6 随前端臂删。
  • W6 待办(monolith 登记的余项):F1WireScenario 在 SetUp 用 SplitRuntimeSkipReason() 整组跳过 monolith,所以 Magma 的 MGITEST_MAGMA_FORCE_SHADER_MIPMAP 车道(ShaderMip1/2.、DepthMip.)还没有 monolith 登记;它的断言读 emitSeq(编码器序号),monolith 记录臂走路由表不经编码器。W6 删前端臂时把 F1 的门改成「记录臂」并换掉 emitSeq 证据,再补 monolith 登记、退役对应的 census 跳过。
  • Magma 换臂(同一会话稍后):一次性;MonolithTakesRecordArm 对两后端都为真。坑:服务端产生的字节(回读落入 pack buffer 的 LandReadbackInBuffer、纹理重铸 / 再生成的 Adopt)绝不能被别名 store 当基址——缓冲侧用 MGPipeServerOriginatedWriteScope 走「直接上传 GL + 标 GPU 写」,纹理侧 Adopt* 默认复制、只有客户端记录的 run 传 frontendShadow=true(曾造成 use-after-free:重铸后首 16 字节是 malloc 元数据)。
  • 本机 retrace:~/mgl-p13-tools/sync.sh 才物化 LFS fixture(sb.sh 用的 sync2.sh 会把它们复原为指针);跑前设 MOBILEGL_GPU_HANG_BUDGET_MS=0。
  • 完整的 site 分类表与后续步骤(W4b 纹理别名 store、W4c、Magma)见 Plan 代理的设计(会话 scratchpad W4-design.md;要点已并入本节)。

4. 下一步

  1. W2/W3a 的 CI:看完归类;然后推 W3b/W3c(普查基线已同提交退役名字)。
  2. W4a 起:按计划 §1.2 的 F 类分支换臂。建议先引入一个 MG_Backend::DataArmIsRecord()(DISAGG 构建恒 true),逐子系统替换 Transport != Monolith,每个子系统跑一次 monolith 全量 integration-gpu(两后端)+ split 车道;§1.4 的别名 store 刷新先做(缺陷 a/b/c 依赖它)。
  3. 14a 已在本地(3e2aff1d),先编译验证。