mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-19 16:01:57 +09:00
[Docs] (P12): close the phase - the contract, the disposition of every leftover item, a G1 line that only compares same-machine builds, and the doc citation the docs reshuffle broke
This commit is contained in:
@@ -67,45 +67,31 @@
|
||||
|
||||
审查后主机 **P12 定向 CTest 46/46 通过**:`ServerDisplayTest`、`ServerLoopTest`、`InProcessServer`、`SupervisorChildren`、`ServerOwnedSurface`。这组定向测试不等于完整主机门。证据在测试机 `/home/swung/w7/logs/p12-verify-1fb18d9e/`;日志、APK 和截图按证据数据规则未入仓库。当前 `0fe01588` 相对验证 head 只有文档整理及文档检查配置更新。
|
||||
|
||||
## 3. 还没做(P12 未收官)
|
||||
## 3. 收官处置(2026-09-29)
|
||||
|
||||
按 [`../ROADMAP.md`](../../ROADMAP.md) P12 行的两个出口门,以及本包任务书列出的改小后的条目:
|
||||
两个出口门都过了((b) [`CROSSHOST-ACCEPTANCE.md`](CROSSHOST-ACCEPTANCE.md)、(a) [`FCL-ACCEPTANCE.md`](FCL-ACCEPTANCE.md)),`MG_Remote/CONTRACT-P12.md` 已写,`gate.sh` 的 G1 已改。ROADMAP P12 行与任务书里原先"未落地"的每一项,处置如下:
|
||||
|
||||
1. **出口门 (a) 未达成。** 要求 FCL 同机 spawn、双后端**入世界**、杀 server 产生干净 device-lost latch。
|
||||
今天验证到的是:trace_replay(**不是 FCL**)经 `--window-surface` + `MOBILEGL_IPC_SURFACE=server` 在屏上重放 OpenRA,
|
||||
双后端都 1.0;device-lost 是**按 HOME(surfaceDestroyed)**触发的,**不是杀 server**。
|
||||
2. **出口门 (b) 完全未做。** 要求另一台机器上的 client 经 TCP 在 Redmi 入世界并记录 P6.5 的必测数。
|
||||
本轮的 client 是 `adb forward` 后的 `tcp://127.0.0.1:40613` **环路**(`android/dev.sh:7-8` 写得很清楚),
|
||||
**不是跨机**。
|
||||
3. **ROADMAP P12 行里仍未落地的条目**(交接时在树上核过):
|
||||
- `unix:` 监听(in-process server 只做了 tcp;`grep 'unix:' ServerMain.cpp` 为 0);
|
||||
- DirectGLES `g_Display` / `g_Surface` / `g_Context` 去全局(`DirectGLES.cpp` 仍有 40 处);
|
||||
- cached-app freezer 的"完整处理"(树上 0 处提及);文档从未定义它是什么,`SPAWN-PLAN.md` §8.2 只说了它是 P12 的;
|
||||
- 多 context(契约 §11);
|
||||
- FCL env 与 plugin APK 开关表接线;
|
||||
- **`AndroidNativeWindow@P12` / `MetalLayer@P12` 的 D8 白名单**(拒 X11 / Win32Hwnd / None)——`map-docs-contract.md` §5.3 记它
|
||||
**没落地**,且当时 `SetWindowHandle` 在 client 侧**无条件发**;本轮把 ServerOwned 模式下的
|
||||
`SetWindowHandle` 变成了具名拒绝,但 D8 本身(X11/Win32 白名单)仍是独立跟进项。
|
||||
4. **文档债**(`map-docs-contract.md` §4 列的"落地时要记录的东西"):
|
||||
- **没有 `MG_Remote/CONTRACT-P12.md`**(前几个阶段都有;本页与 `BRIEF-onscreen.md` 不是契约);
|
||||
- 没有 `INTEGRATOR-DECISIONS-P12.md` 式的逐条裁定;
|
||||
- `ARCHITECTURE.md:526` 仍写着被删掉的 Surface → AIDL → `ANativeWindow_fromSurface` 旧路径,`protocol.fbs:258`
|
||||
仍写「Android transfers the window out of band」,`ARCHITECTURE.md:533` 仍描述 RESPAWN / IDLE_EXIT 可用;
|
||||
- `CURRENT_STAGE_PROGRESS.md:244` 仍把 P12 描述成"real windows cross processes",与 Rule H 冲突;
|
||||
- IPC 顺序(`ROADMAP.md:19` 的 P6.5 → Ph → **P12** → P9 与 `CURRENT_STAGE_STATUS.md` / HANDOFF 的
|
||||
P9 → P10 → P11 → P12)两处说法仍不一致;
|
||||
- a6 行 A8-3…A8-15 的处置、CONTRACT-P6 §7.2 D8 的处置都还没写;
|
||||
- 阶段收尾该有一次 Codex 审查(`ROADMAP.md:17` 的惯例)。
|
||||
5. **`MG_Test/SanityTest.cpp` 在本包里被改动过**——它属于 pull 构建之外的测试目标,但要确认它与 G1 的关系已在门里测到(门已绿,此处只是点名)。
|
||||
| 项 | 处置 |
|
||||
|---|---|
|
||||
| in-process server 的 `unix:` 监听 | ✅ 已做(`c16fb5a8a`) |
|
||||
| FCL env 与 plugin APK 开关表接线 | ✅ FCL 走 `/sdcard/FCL/mg_env.txt`;plugin / trace 两个 APK 都带 Render Server 屏与二进制(`1987bdff5`);FCL fork 新增版本设置「游戏退到后台时不暂停」(FCL 仓库,未提交) |
|
||||
| DirectGLES `g_Display` / `g_Surface` / `g_Context` 去全局 | 不做:每进程一个会话时不需要 → [`DEBTS.md`](../DEBTS.md) |
|
||||
| cached-app freezer 的完整处理 | 不做:文档从未定义它;FCL 后台暂停的实测答案见契约 → DEBTS |
|
||||
| 多 context | 不做(同上)→ DEBTS |
|
||||
| D8 窗口种类白名单(拒 X11 / Win32Hwnd / None) | 不做:仍接受并把 token 强转为指针 → DEBTS(无主,等 Windows / X11 client) |
|
||||
| TLS | 仍开放 → DEBTS |
|
||||
| 逐条裁定日志 | ✅ `INTEGRATOR-DECISIONS-P12.md`(ID-P12-1..15) |
|
||||
| 文档债(`ARCHITECTURE.md:526` 旧路径、`protocol.fbs` 旧注释、`CURRENT_STAGE_PROGRESS` 的"real windows cross processes") | ✅ 已清(设计文本已迁到 `design/`,`design/08-runtime-and-platform.md` 记上屏路径与几何) |
|
||||
| IPC 顺序两处说法不一致 | ✅ ROADMAP 现为 P5 … P6.5 → Ph → P12 → P9 → P10 → P11 |
|
||||
| `IterationRPProgram203Scenario` | ID-P12-12:按"既有、环境敏感"读,不阻塞 |
|
||||
| a6 行 A8-3…A8-15 与 CONTRACT-P6 §7.2 D8 的逐行处置 | 由契约与裁定日志覆盖,**没有逐行列出** |
|
||||
| 收官审查 | 用户裁定(2026-09-29)不派 agent / Codex 审查;由本人核对契约断言(发现两处措辞错误已改)并跑 G1 |
|
||||
| G1 | G1(Arch,clang++,pull 构建,`6e35ea2c`):`.text` `0xa52203` = 基线,符号增 0 减 0 |
|
||||
|
||||
## 4. 立刻可做的收尾
|
||||
## 4. 收官前立刻做过的
|
||||
|
||||
1. 把 `~/w7/notes/p12/gate.sh` 的 G1 符号比较改成与基准同源(`nm --defined-only … | awk '{print $3}'`),
|
||||
否则下一个跑门的人还会看到 `added=N removed=N` 而误判。
|
||||
2. 决定 `IterationRPProgram203Scenario` 在 P12 的处置:既然 ID-P7-22 已判"环境敏感",把它在门里的
|
||||
出现方式(钉 ICD 即可绿 / 记为已知偶发)写成一句结论,别再一次次口头带过。
|
||||
3. 若要真正收官 P12:先补跨机 TCP(出口门 b),再补 FCL + 杀 server 的 device-lost(出口门 a),
|
||||
最后写 `CONTRACT-P12.md` 并按惯例做一次收官审查。
|
||||
1. `gate.sh` 的 G1 只在同机同编译器的基线上比较,否则说"未比较"并给做法,不再印无意义的 `added / removed`。
|
||||
2. `notes/p7/INTEGRATOR-DECISIONS-P7.md` 里一条指向已缩成索引的 `ARCHITECTURE.md:531` 的引用改到 `design/08-runtime-and-platform.md:7`(文档引用门原先在 HEAD 上红)。
|
||||
|
||||
## 5. 工装在哪
|
||||
|
||||
|
||||
@@ -8,12 +8,12 @@
|
||||
- 形状:server APK 自建 `ANativeWindow`(`MobileGLDisplayActivity` 的 SurfaceView,进程内 TCP server,会话串行)把渲染流**上屏**;离屏路径保留、同一时刻一条活跃;client 以 `WindowKind::ServerOwned`(控制修订 3)**完全无头**接入,几何由 server 回传;失窗 → `Fatal{ServerWindowLost}` → 干净 device-lost。
|
||||
- 进展:15 个 `(P12)` 提交 + 审查轮修复(10 个问题,ID-P12-5..11)已并入 `feat/disaggregated`;主机门绿(ID-P12-14)、G1 成立(ID-P12-15);审查后在 `1fb18d9e` 上完成 P12 定向 CTest 46/46 和 Redmi 真机七项复测。当前分支 `0fe01588` 后续提交只改了文档、文档检查范围和基准脚本说明文字,未改 P12 实现。
|
||||
- **2026-09-25 追加(会话交接 §4/§5.1)**:**device-lost 的 DECLINED 回复容忍**与**纹理上传的等待粒度**已落地,各有自己的 red-once 门(前者就是进世界后 `Fatal{ProtocolCorruption, "Fence.reply"}` 那条崩溃;后者让单条纯上传的回包等待 1 → 0)。真机端到端(进世界不崩、那一帧墙钟)与 G1 本机复核仍待做,见 [`DEVICELOST-AND-UPLOAD-WAITS.md`](DEVICELOST-AND-UPLOAD-WAITS.md)。
|
||||
- 出口门 (b) 已于 2026-09-28、(a) 已于 2026-09-29 通过([`CROSSHOST-ACCEPTANCE.md`](CROSSHOST-ACCEPTANCE.md)、[`FCL-ACCEPTANCE.md`](FCL-ACCEPTANCE.md))。未完成:`CONTRACT-P12.md`;阶段表行里的其余条目(`unix:` 监听、DirectGLES 去全局、freezer、多 context、FCL 开关接线、D8 白名单)。
|
||||
- 出口门 (b) 已于 2026-09-28、(a) 已于 2026-09-29 通过([`CROSSHOST-ACCEPTANCE.md`](CROSSHOST-ACCEPTANCE.md)、[`FCL-ACCEPTANCE.md`](FCL-ACCEPTANCE.md));契约 `MG_Remote/CONTRACT-P12.md` 已写。未做的(DirectGLES 去全局、freezer、多 context、D8 白名单、TLS)已转入 [`DEBTS.md`](../DEBTS.md)。
|
||||
|
||||
## 阶段表行(原 `ROADMAP.md`)
|
||||
|
||||
- **阶段**:**P12** Android 生产窗口路径
|
||||
- **状态**:**子集已实现、未收官(2026-09-25)**:上屏 server 窗口、`WindowKind::ServerOwned`、无头 client、失窗 device-lost 已落地;审查轮 10 个问题已修(两个大项:批内失窗、会话间 Espryt 单元影子悬空;裁定 [`INTEGRATOR-DECISIONS-P12.md`](INTEGRATOR-DECISIONS-P12.md) ID-P12-5–11)。审查后 P12 定向 CTest 46/46、真机七项复测通过;出口门 (a) FCL + 杀 server 与 (b) 跨机 TCP 仍未完成(见 [`PLAN-P12.md`](PLAN-P12.md) §3)。
|
||||
- **状态**:**已收官(2026-09-29)**——两个出口门都过([`CROSSHOST-ACCEPTANCE.md`](CROSSHOST-ACCEPTANCE.md)、[`FCL-ACCEPTANCE.md`](FCL-ACCEPTANCE.md)),契约 `MG_Remote/CONTRACT-P12.md` 已写,余项处置见 [`PLAN-P12.md`](PLAN-P12.md) §3。以下是 09-25 的进展记录:**子集已实现(2026-09-25)**:上屏 server 窗口、`WindowKind::ServerOwned`、无头 client、失窗 device-lost 已落地;审查轮 10 个问题已修(两个大项:批内失窗、会话间 Espryt 单元影子悬空;裁定 [`INTEGRATOR-DECISIONS-P12.md`](INTEGRATOR-DECISIONS-P12.md) ID-P12-5–11)。审查后 P12 定向 CTest 46/46、真机七项复测通过;出口门 (a) FCL + 杀 server 与 (b) 跨机 TCP 仍未完成(见 [`PLAN-P12.md`](PLAN-P12.md) §3)。
|
||||
- **落地什么 / 范围**:**按重审 §6 改小**:~~Service 收 Java `Surface`~~ 删掉 Surface 传递那一半——server app 拥有自己的 SurfaceView,client 根本没有窗口,于是 minSdk 26 没有扁平化 `ANativeWindow` 的 NDK API 这条约束不再成立;`WindowKind::ServerOwned`;两个后端各一条 `CreateEGLWindowSurface` 臂;`m_windowHandle` 四处写点 + `sameHandle` 去重键(a6 §6);DirectGLES `g_Display` / `g_Surface` / `g_Context` 去全局;`kEventSurfaceChanged` 的 Width / Height 缺口(Espryt 只发布格式,server 拥有显示时 client 默认 FBO 会停在 512×512 占位值);client 侧不再无条件发 `SetWindowHandle`(`BackendObject_Remote.cpp:215`——今天 FCL 里开 spawn,第一次 `eglCreateWindowSurface` 就在 server 进程 abort);server app 监听 `unix:` 与 `tcp://`(后者 Ph 之后);server 生命周期绑 Activity;cached-app freezer(SPAWN-PLAN §8.2);多 context(契约 §11);FCL env 与 plugin APK 开关表接线
|
||||
- **验收门 / 证据**:两个门:(a) Minecraft 经 FCL **同机 spawn** 在 Adreno 830 双后端入世界,杀 server 产生干净 device-lost latch;(b) **另一台机器上的 client 经 TCP** 在 Redmi 上进世界(数据面 stream),并记录 P6.5 的必测数
|
||||
|
||||
@@ -81,10 +81,9 @@ Android 上的 server 自建窗口(自己的 SurfaceView)把 IPC 渲染流**
|
||||
|
||||
### 5. 下一步
|
||||
|
||||
1. **出口门**:(a) [`FCL-ACCEPTANCE.md`](FCL-ACCEPTANCE.md) 与 (b) [`CROSSHOST-ACCEPTANCE.md`](CROSSHOST-ACCEPTANCE.md) 都已通过;剩 `CONTRACT-P12.md`、门脚本误导输出、收官审查。
|
||||
2. **收尾**:写 `MG_Remote/CONTRACT-P12.md`;修 `notes/p12/gate.sh` 的 G1 符号比较(与基准不同源,会印出误导的 `added=N removed=N`);按惯例做一次收官审查。
|
||||
3. **阶段表行里的余项**(交接时在树上核过,均未做):in-process server 的 `unix:` 监听、DirectGLES `g_Display` / `g_Surface` / `g_Context` 去全局、cached-app freezer、多 context、FCL env 与 plugin 开关表接线、D8 窗口种类白名单。
|
||||
4. 其后按 [`ROADMAP.md`](../../ROADMAP.md):monolith 跑道 P8;IPC 跑道 P9 → P10 → P11;P6.5 残余(39 例 device 矩阵 + 必测数)与 P3b/P4b 余项并行;`CONTRACT-P7.md` §12 的记录债按阶段认领。
|
||||
P12 已收官(2026-09-29):出口门 (a)(b) 通过、契约已写、`gate.sh` 的 G1 已改、余项已处置([`PLAN-P12.md`](PLAN-P12.md) §3)。
|
||||
|
||||
1. 其后按 [`ROADMAP.md`](../../ROADMAP.md):monolith 跑道 P8;IPC 跑道 P9 → P10 → P11;P6.5 残余(39 例 device 矩阵 + 必测数)与 P3b/P4b 余项并行;`CONTRACT-P7.md` §12 的记录债按阶段认领。
|
||||
|
||||
### 6. 阻塞 / 需要人
|
||||
|
||||
|
||||
@@ -1,7 +1,10 @@
|
||||
#!/usr/bin/env bash
|
||||
# gate.sh <tree> <tag>: the P7 v2 local gate (logs/p7-gate-template2.sh) for a P12 package tree, minus
|
||||
# build-verify and the retrace leg (both run at integration). G1 compares against the p12 base
|
||||
# (9f669e52: .text a52203, symbols in logs/p12/pull-syms-base.txt).
|
||||
# (9f669e52). G1 is only meaningful between two builds of the SAME machine and compiler (a symbol
|
||||
# list or .text size read on another host says nothing): the base list is used only when its sidecar
|
||||
# (pull-syms-base.txt.cc) names this build's compiler, and otherwise G1 says so and gives the recipe
|
||||
# instead of printing an added/removed count that means nothing (ID-P12-15: build both commits here).
|
||||
TREE=${1:?tree}; TAG=${2:?tag}
|
||||
T=/tmp/p12gate-$TAG; mkdir -p "$T"
|
||||
cd "$TREE" || exit 1
|
||||
@@ -10,9 +13,15 @@ unset DISPLAY WAYLAND_DISPLAY
|
||||
echo "=== START $(date) head=$(git rev-parse --short HEAD) dirty=$(git status --porcelain --untracked-files=no | wc -l) ==="
|
||||
ninja -C build-split -j 24 2>&1 | tail -1; echo "=== split build rc=${PIPESTATUS[0]} ==="
|
||||
ninja -C build-linux -j 24 2>&1 | tail -1; lrc=${PIPESTATUS[0]}; echo "=== linux build rc=$lrc ==="
|
||||
readelf -S -W build-linux/libMobileGL.so | awk '$2==".text"{print "G1 text size (hex):", $6, "(base a52203)"}'
|
||||
CC_NOW=$(grep -m1 '^CMAKE_CXX_COMPILER:' build-linux/CMakeCache.txt | cut -d= -f2- | xargs -I{} sh -c '{} --version | head -1')
|
||||
readelf -S -W build-linux/libMobileGL.so | awk '$2==".text"{print "G1 text size (hex):", $6, "(informational: compare only with a base built by this compiler)"}'
|
||||
nm --defined-only build-linux/libMobileGL.so | awk '{print $3}' | sort > "$T/pull-syms.txt"
|
||||
echo "G1 syms added=$(comm -13 /home/swung/w7/logs/p12/pull-syms-base.txt "$T/pull-syms.txt" | wc -l) removed=$(comm -23 /home/swung/w7/logs/p12/pull-syms-base.txt "$T/pull-syms.txt" | wc -l)"
|
||||
BASE_SYMS=/home/swung/w7/logs/p12/pull-syms-base.txt
|
||||
if [ -f "$BASE_SYMS.cc" ] && [ "$(cat "$BASE_SYMS.cc")" = "$CC_NOW" ]; then
|
||||
echo "G1 syms added=$(comm -13 "$BASE_SYMS" "$T/pull-syms.txt" | wc -l) removed=$(comm -23 "$BASE_SYMS" "$T/pull-syms.txt" | wc -l) (base list built by: $CC_NOW)"
|
||||
else
|
||||
echo "G1 syms: NOT COMPARED - the base list was not made by this compiler ($CC_NOW). Build the pull config at the base commit on this machine and diff the nm symbol lists (ID-P12-15); to reuse the list, write the compiler line to $BASE_SYMS.cc"
|
||||
fi
|
||||
python3 scripts/ci/fatal_census.py 2>&1 | tail -1
|
||||
python3 scripts/link_ratchet.py --build-dir build-split --baseline scripts/data/link_ratchet_baseline.txt --assert-monotone 2>&1 | tail -1
|
||||
python3 scripts/ci/spawn_lane_parity.py build-split 2>&1 | grep -c -i error | sed 's/^/parity errors: /'
|
||||
|
||||
Reference in New Issue
Block a user