swung0x48/MobileGL
1
0
Fork 0
mirror of https://github.com/MobileGL-Dev/MobileGL synced 2026-11-07 18:13:23 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
43b5cfa94eb17eb07e205222cae99fd79dd6116f
MobileGL/docs/Disaggregated/notes/p12
T
History
swung0x48 43b5cfa94e [Docs] (Disaggregated): the four index documents keep only summaries, and every phase's detail lives in its own notes/<phase>/README.md 
- ROADMAP, MEASUREMENTS and ARCHITECTURE are rewritten as summaries (333 KB of index text -> 84 KB).
  ROADMAP's phase table is one line per phase plus a link; MEASUREMENTS keeps headline numbers under
  its old §1-§13 numbering (plus §14-§16 for P6.5, P7 and P12); ARCHITECTURE keeps every decided rule
  under the same §1-§17 / appendix numbering, so the `ARCHITECTURE.md §N` references in code still
  land, and §17 becomes an index of the phase landing shapes.
- CURRENT_STAGE_PROGRESS now describes the current stage (the P12 on-screen-server subset) and absorbs
  CURRENT_STAGE_STATUS, which is removed. The P7 status tables, the P6 closing snapshot and the P6.5
  first-wave snapshot move to notes/p7, notes/p6 and notes/p65.
- Each phase gets notes/<phase>/README.md: a short summary, then the verbatim material that left
  the index documents (its ROADMAP row, its MEASUREMENTS section with subsection numbers kept, its
  ARCHITECTURE §17 part, milestones) and a file index. P8-P11 and P13 get their planned scope;
  the full open-question list moves to notes/OPEN-QUESTIONS.md.
- The phase reports that sat at the top level move into their phase folders with unchanged names:
  P5D-INPROC-PERFORMANCE, P5E-RUNAHEAD, P5F-WIRE-COMPLETENESS, P6-SPAWN-PLAN, P6-CONTRACT-DRAFT,
  P6-ENDSTATE-REVIEW. Their relative links, CONTRACT-P6.md's links to them and one tool docstring
  are updated; notes/README.md maps every old path and section number to its new place.
- 71 files under notes/recovered/ that were byte-identical copies of phase-folder files are removed.
- Corrections made while condensing: the server process reads Transport as Spawn (CONTRACT-P6 §3.1
  amended the old "child forces monolith" rule); both backends now publish kCapRunAheadApply;
  MOBILEGL_IPC_RESPAWN is a named refusal and MOBILEGL_IPC_IDLE_EXIT_S is not parsed; the Redmi
  pin row is in tools/device_bench/pin_device.sh.

check_doc_citations over docs/Disaggregated/*.md: 0 problems. No relative link is newly broken.
2026-09-24 22:21:09 +00:00
..
android
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
device
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
gate
[Docs] (P12 review): ID-P12-14 records the review round's host gate - the new cases' red-without-fix demonstrations, and every remaining red traced to the container's CMake/CTest, not to the fixes
2026-09-24 14:03:48 +00:00
BRIEF-onscreen.md
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
fix-icd.sh
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
g1-base-names.sh
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
gate-container.sh
[Docs] (P12 review): the review round's host gate log and the container variant of the gate script
2026-09-24 14:03:48 +00:00
gate.sh
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
INTEGRATOR-DECISIONS-P12.md
[Docs] (P12 review): ID-P12-15 - G1 holds for the review round: the pull build at cb0404f2 and at this head, same machine and compiler, has .text 0x9b1bf2 on both sides and 30614 symbols with 0 added / 0 removed
2026-09-24 14:03:48 +00:00
map-apk-process.md
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
map-client-surface.md
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
map-docs-contract.md
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
map-server-surface.md
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
p203.sh
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00
PLAN-P12.md
[Docs] (Disaggregated): the four index documents keep only summaries, and every phase's detail lives in its own notes/<phase>/README.md
2026-09-24 22:21:09 +00:00
README.md
[Docs] (Disaggregated): the four index documents keep only summaries, and every phase's detail lives in its own notes/<phase>/README.md
2026-09-24 22:21:09 +00:00
setup-tree.sh
[Docs] (P12): the on-screen server window's plan, audit, harness and device evidence move into the tree, and the status page says what this line is and what it still owes - CURRENT_STAGE_STATUS records that the P12 subset is implemented but NOT handed off (both exit gates unrun: no cross-machine TCP, no FCL + kill-server device-lost), the ROADMAP P12 row stops reading "待排", and notes/p12 carries the brief, the four read-only audits, the gate and device harness, and the curated device evidence (check transcripts, replay verdicts, on-screen captures; logcat left out per notes/README.md's evidence-data rule)
2026-09-24 07:44:40 -04:00

README.md

P12 — Android 生产窗口路径（「server 自有屏幕窗口」子集已实现，未收官）

本页是该阶段的阶段汇总：阶段表行、实测与落地形状的完整文本（2026-09-24 从上层索引移入，原文照录）都在这里；上层只留摘要——ROADMAP.md、MEASUREMENTS.md、ARCHITECTURE.md。文中 file:line 与"今天""当前"按各段写成时的头理解；文中的 MEASUREMENTS.md §N / ARCHITECTURE.md §17.x 编号保留，对照表见 ../README.md。

摘要

  • 当前阶段。状态摘要在 ../../CURRENT_STAGE_PROGRESS.md；计划与交接 PLAN-P12.md；任务书 BRIEF-onscreen.md；裁定 INTEGRATOR-DECISIONS-P12.md（ID-P12-1..15）；只读审计 map-*.md 四份。
  • 形状：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）；真机七项检查在审查轮之前的 head 上通过，审查轮之后未复测（ID-P12-13）。
  • 未完成：出口门 (a) FCL 同机 spawn + 杀 server 的 device-lost、(b) 跨机 TCP 入世界 + P6.5 必测数；CONTRACT-P12.md；阶段表行里的其余条目（unix: 监听、DirectGLES 去全局、freezer、多 context、FCL 开关接线、D8 白名单）。

阶段表行（原 ROADMAP.md）

  • 阶段：P12 Android 生产窗口路径
  • 状态：子集已实现、未收官（2026-09-24，自 9f669e52，15 提交 + 审查轮 8 提交）：上屏 server 窗口、WindowKind::ServerOwned、无头 client、失窗 device-lost 已落地并过真机七项检查；审查轮 10 个问题已修（两个大项：批内失窗、会话间 Espryt 单元影子悬空；裁定 notes/p12/INTEGRATOR-DECISIONS-P12.md ID-P12-5–11），主机门复跑，真机未复测（ID-P12-13）；两个出口门均未打（见 notes/p12/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 的必测数

状态记录（原 CURRENT_STAGE_STATUS.md，2026-09-24）

更新：2026-09-24（P12 子集） · 计划与交接 notes/p12/PLAN-P12.md。P12「server 自有屏幕窗口」子集已实现、未收官，已并入 feat/disaggregated（15 提交自 9f669e52 起，加审查轮 10 个问题的修复——两个大项：批内失窗、会话间 Espryt 单元影子悬空；裁定 notes/p12/INTEGRATOR-DECISIONS-P12.md ID-P12-5–15，主机门与 G1 见 ID-P12-14/15，审查轮之后未上真机复测，ID-P12-13）：Android 上的 server 自建 ANativeWindow（自己的 SurfaceView）把渲染流上屏，离屏路径保留，同一时刻只一条活跃；client 以新的 WindowKind::ServerOwned 完全无头接入（控制修订 3）。主机门除一条既有环境敏感项外全绿，G1（pull 构建 .text 0xa52203、符号 0/0）已独立复核；真机 Redmi 2f7cbe2e 上七项编号检查过了双后端上屏、串行/Busy、失窗 device-lost、离屏不回归、无显示具名拒绝、一台设备一个 server。两个出口门都还没打：跨机 TCP（门 b）完全未做，FCL + 杀 server 的 device-lost（门 a）未做——本轮的真机是 trace_replay 经 adb forward 环路驱动的。上一阶段 P7 已收官（2026-09-23，ID-P7-63）：§8 九项全绿——终局窗口 3（p7w8-78e71f2b）门 3 PASS 36/36、门 5 PASS；门 4 以 # P13 读法关闭。

  • P12 子集：APK 26.09.29b7b28-trace（控制协议修订 3，与 p7w8 的 server 不兼容），证据 notes/p12/device/（九格拼图 evidence-strip.png）。七个编号检查在三个 head 上跑过，trial-*/ 是按 head 归档的旧轮次。

本目录

文件 内容
BRIEF-onscreen.md P12 subset "on-screen server window" — implementation brief (2026-09-23)
fix-icd.sh 钉 lavapipe ICD
g1-base-names.sh G1 基准符号名生成
gate-container.sh 主机门的容器变体
gate.sh 主机门脚本
INTEGRATOR-DECISIONS-P12.md P12 集成者裁定日志（「server 自有屏幕窗口」子集）
map-apk-process.md MobileGL-disagg: Android APK and process model for an on-screen server path (commit 9f669e52)
map-client-surface.md Client-side surfaces in split mode: map, open questions and change list (commit 9f669e52)
map-docs-contract.md Design docs and contracts for a server-owned on-screen window (P12 subset)
map-server-surface.md Server-side surface path and both backends' window surfaces (commit 9f669e52)
p203.sh IterationRPProgram203Scenario 复核
PLAN-P12.md P12「server 自有屏幕窗口」子集 — 计划与交接（2026-09-24）
setup-tree.sh 包树搭建
android/ 27 个文件：真机与构建脚本（dev.sh、check*.sh、final-run.sh、red-once 工具等）
device/ 85 个文件：真机七项检查证据（evidence-strip.png 九格拼图；trial-*/ 为按 head 归档的旧轮次）
gate/ 6 个文件：三个 head 的构建日志与主机门日志（含审查轮、CMake 4 对照）
Reference in New Issue View Git Blame Copy Permalink