mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-17 06:53:22 +09:00
7.8 KiB
7.8 KiB
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 随前端臂删。 - 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. 下一步
- W2/W3a 的 CI:看完归类;然后推 W3b/W3c(普查基线已同提交退役名字)。
- W4a 起:按计划 §1.2 的 F 类分支换臂。建议先引入一个
MG_Backend::DataArmIsRecord()(DISAGG 构建恒 true),逐子系统替换Transport != Monolith,每个子系统跑一次 monolith 全量 integration-gpu(两后端)+ split 车道;§1.4 的别名 store 刷新先做(缺陷 a/b/c 依赖它)。 - 14a 已在本地(
3e2aff1d),先编译验证。