MapLibreParticleLab/docs/报告/STEP-097_A1_Android专项验收报告_v1.md

STEP-097 A1 Android 专项验收报告 v1

结论及范围

A1 Android/Core 已完成本轮可执行检查点；iOS/Metal 运行测试按用户决定豁免。 不将豁免写成实际 Metal PASS。STEP-097 总体仍进行中，A2/B/C 尚待实现和验证；无新软件发布。

• 仓库：/Users/tei/dev/MapLibreParticleLab，particle/main，源码提交 8c006ac83d16c2683037f90484fd86fb917a9d78。Integration main 核对 318f8ccf911ac3136c3086a1d14e61f83e2d4bce。
• Android/FZG1-2：直接 ADB 192.168.200.139:5555，非 Win11 虚拟机。APK OpenGL Debug/x86_64，60,311,571 bytes，SHA-256 48df19cf5a4c4250934efa2596423d3ad9571fe49a65b9b704a81cdb41f58671。标准脚本编译成功、ZIP/ABI 校验通过；install -r 返回 Success，设备安装文件哈希一致。
• 构建记录 git_dirty=true 的原因是用户另行放在 docs/40_任务/ 的未跟踪 STEP-098 MD；本次构建起始及源码提交无 tracked 修改，未将 STEP-098 纳入编译或提交。冻结 .13 未修改。

01：同源同 tile Stencil — Android 实测

新入口为 Step097StencilFixture，单一 step097-shared-polygon GeoJSON tiled source 的四层同一 Polygon，运行中仅改变 R/C 连续 Segment 排列，不改来源、几何及图层视觉参数。

• 实测 RR、RCR、CRR 各两轮，稳定帧、REBUILD CURRENT、CACHE OFF/ON 与再次拓扑切换，共 18 个检查点，18 张 1920×1200 PNG 与 18 份 UI XML。
• 所有检查点均 valid=true、fallback=false 且实际策略序列匹配当前选项；缓存 OFF 时各 R 报告 fallback，ON 后重新构建，拓扑有效不变。代码回归脚本退出码 0；实时日志含 10 条 STEP097_STENCIL_READY，没有本次采集范围内的 FATAL/SIGSEGV/SIGABRT。
• 使用 AppKit 对原始 PNG 采样：18 张中心像素全部为 RGB [193,176,119]，区域外像素全部为 [27,49,75]，中心与区域外有明显差异。两种采样均一致，不以截图文字代替像素核验。
• 以上证明这组固定 same-source scene 在指定采样点和可见完整画面未出现异常；它不是对所有 tile/camera/pitch/zoom 组合的数学证明。

证据在忽略目录 artifacts/maplibre-particle/step097-a1-fzg1/：run-stencil.log、pixel-check.log、after/*.png、after/*.xml、after/live-logcat.txt、after/step097-events.txt、after/fatal-events.txt、after/observations.json、install.log、installed.sha256。

02：Metal 附件 — 源码与编译，不执行 iOS runtime

Metal 宿主测试二进制中包含 MetalRetainedAttachments.* 两个 GTest，Metal host CMake 增量编译退出码 0。当前 Mac 没有可用 MTL::CreateSystemDefaultDevice()，两个测试均按守卫 SKIP；没有将 0/2 误记为 PASS。针对 metal-cpp 对象指针解引用的最小编译修正已提交 8c006ac83。

用户于 2026-09-26 明确决定：本轮不执行 iOS 测试，Android 验收通过后 iOS 按其决定视作接受。记录为 USER_ACCEPTED_WITHOUT_IOS_RUNTIME_TEST，不宣称 iOS GPU/Metal 实际验证。

03：绘制异常恢复 — 原生测试

RenderOrchestratorError.* 两个新增原生测试实际执行 2/2 PASS，exit 0，覆盖 opaque/translucent 绘制异常、错误上报、失败 cache 不发布/不复用及干净重试恢复。日志：artifacts/maplibre-particle/step097-a1-fzg1/render-exception.log。本次不将 GTest 扩写为 Android GPU 真实异常注入 PASS。

19：资源释放归属 — 已有结果

OldCacheReleaseCannotChargeReplacementAtSameIndex 已在此前重新编译的 Mac Core 原生 runner 实测 1/1 PASS；诊断组 5/5 PASS。FZG1 资源辅助冒烟 20 个检查点已经单独报告。精确 revision 归属由原生 GTest 负责，不据设备摘要断言不存在 GPU 内存泄漏。

A1 交接与限制

A1 在 Android/Core 验证和用户 iOS 豁免口径下可进入 A2；保留 B/D topPresent=true 的旧诊断疑点，不将其冒充已修复。下一阶段按原任务书 A2→B→C 严格串行；每阶段 Codex 实现/测试入口，RDC 负责实际构建、执行与独立审查；不加入 Jest、不覆盖 .13。