mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-17 15:03:25 +09:00
54 lines
8.2 KiB
Markdown
54 lines
8.2 KiB
Markdown
# P13 交接(2026-10-06)
|
||
|
||
> 计划 [`PLAN-P13.md`](PLAN-P13.md),裁定 [`INTEGRATOR-DECISIONS-P13.md`](INTEGRATOR-DECISIONS-P13.md),进度表 [`README.md`](README.md),CI 清理记录 [`docs/ci/ci-cleanup-log.md`](../../../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`),先编译验证。
|