STEP-106 STEP-102 T2 Placement 边界修正 — Mac 编译与 FZG 实机回归完成报告 v1

一、结论

STEP-106 CLOSED/PASS（仅 FZG1-2 Android x86_64/OpenGL Test App 的 T2 问题及定向回归）。

源码保留 RenderSegment Placement 安全规则，仅修复 STEP-102 Test App 的分段计划，将默认附加的 Annotation Symbol 从 R1 Retained 中隔离到末尾 Continuous C2。更新版经 Mac Gradle 打包、FZG 设备安装、两项 STEP-102 场景及 STEP-099/STEP-101/QBIN 回归，验收符合各自目标。

二、源码、构建、APK

工作区：/Users/tei/dev/MapLibreParticleLab-upgrade-android-1361
分支：upgrade/android-native-13.6.1-20261009
构建输入 HEAD：23f7b8a4d7b33d3fb63cd8691fc3a2f070936d03；构建时 git_dirty=false。
上游 Integration main 已经在本轮开始前同步到 80667d6c343411d03a760425438e3d292f452118。
构建：Mac，JDK 17，Android SDK/NDK，x86_64 OpenGL Debug，tools/particle_android_validation/build_validation_apk.sh（Gradle --console=plain）；成功退出，BUILD SUCCESS，Kotlin/Java/Native 包装检查通过。
APK：artifacts/maplibre-particle/step106-t2-fix/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk；66,505,495 bytes；lib/x86_64/libmaplibre.so=39,970,088 bytes。
APK SHA-256：0ef3b033cd33139db07258745e9cd9d023170ce69767e3f8a5159821776ec9ef。
其它 ABI 带入的仅是 Validation 脚本明示允许的 Sentry 库；MapLibre Native 和测试 Custom Layer 是 x86_64。APK ZIP 检查、脚本 ABI/体积检查 PASS。
打包日志与 source lock：artifacts/maplibre-particle/step106-t2-fix/build.log、build-info.txt。

三、FZG 安装

设备：FZG1-2 / Android 13 / ADB 192.168.200.139:5555 / x86_64。
包名：org.maplibre.android.testapp；versionName=13.6.1，versionCode=14。
新旧证书 SHA-256 一致：e3f8fae6451ed6322259d090dd8e8788df554ab25ed89a01c78014f1d5ef8236。
2026-10-09 13:08:17 JST，adb install -r 返回 Success，保留 App 数据。
完成后设备内 base.apk SHA-256 与 Mac 完全一致；最后恢复默认页面时再次独立回读核实。

四、STEP-102 T1/T2 两窗口验收

窗口均从 STEP102_WINDOW_MARKER baseline tick8 测至 final tick130，期间持续 ADB Logcat 收集。

修正后的实际 Style/Segment 层级日志（两组均在 FZG 真实记录）：

层 0：step102-background（background）
层 1：step102-static-fill（fill）
层 2：step102-particle（raster-particle）
层 3：step102-upper（T1 为 symbol，T2 为 fill）
层 4：org.maplibre.annotations.points（MapLibre 内部 symbol）

四段为 R0 RETAINED[0,2)、C0 CONTINUOUS[2,3)、R1 RETAINED[3,4)、C2 CONTINUOUS[4,5)。

T1_FREE_SYMBOL — PASS

R0：placementCapable=false、gate=true、actual=composite，build 1→1、reuse 180→3862（+3682）、invalidation 2→2。
R1：placementCapable=true、gate=false、actual=live，fallback=static-placement，reuse0。这一安全退回是正确行为。
C2：MapLibre 内部 Annotation Symbol 持续 Live。
Crash Buffer=0，Style Plan 接受。

T2_TWO_FREE — PASS，原阻塞解除

R0：placementCapable=false、gate=true、actual=composite，build 1→1，reuse 195→3878（+3683）、invalidation 7→7。
R1：placementCapable=false、gate=true、actual=composite，build 1→1，reuse 195→3878（+3683）、invalidation 7→7。
C2：内部 Annotation Symbol 继续 Live，不破坏 Placement 安全。
Crash Buffer=0，Style Plan 接受。

原失败表现（R1 placementCapable=true/fallback=static-placement）不再存在。之前对旧 13.4.1-particle.21 的同设备对照证明原 fixture 也有相同问题，不属于 13.6.1 新增回归。

五、定向回归

回归	实际设备证据	结论
STEP-099 T4 R-C-R	动态 GeoJSON 更新 69 次；tick8/130 R0 build 1→1，reuse 193→3868（+3675），invalidation 13→13；crash0	PASS
STEP-101 T1	request1、destroy enter/return1、nativeReset enter/complete1、新 Renderer ready2、DONE1；crash0	PASS
STEP-101 T2	request20、destroy enter/return20、nativeReset enter/complete20、Renderer reset enter/complete40、newReady21、DONE1；crash0	PASS
QBIN V4 Golden	clear/color/particle/time=ACCEPTED；T0/T1 均 ACCEPTED_INSERTED，Runtime V4 READY，UI 显示 V4 GOLDEN	PASS（最小烟测）
默认画面恢复	GLOBAL/ACTIVE/EAST/MIX0%/256，Test App 前台，13.6.1，设备 APK SHA一致，crash0	PASS

特别说明：STEP-101 T2 从场景启动前至终态使用 Mac 持续流式 Logcat，避免 Android 环形 Logcat 溢出造成的假性少计数。

六、原始证据位置

所有文件保存在 Mac Git 忽略目录：

artifacts/maplibre-particle/step106-t2-fix/

build.log 与 build-info.txt
runtime-T1/stream.log、crash.log
runtime-T2/stream.log、crash.log
runtime-STEP099-T4/stream.log、crash.log
runtime-STEP101-T1/stream.log、crash.log
runtime-STEP101-T2/stream.log、crash.log
runtime-V4-smoke/load.log、v4.xml
runtime-restored/window.xml、frame.png、crash.log

未将大型原始 Logcat、截图或 APK 纳入 Git。

七、保留边界

本次完成的是升级候选 Android x86_64/OpenGL Test App 上的明确阻塞与相关回归。STEP-102 改成 R-C-R-C 的测试布局引入第二 Continuous 区段，不能用它宣称生产环境单 Continuous Particle fast-path 的性能通过。没有修改 Shared Core 的 Renderer/Placement API、NavSea Host 或 iOS。

Android ARM64、RN 11.5.0 接入、iOS Metal、Vulkan、AAR 发行与全链用户验收均仍需独立完成。QBIN V4 本轮仅复测 T0/T1 Golden 插入，不声称六个时间控制动作再次全部验证；上轮 STEP-105 的六项回归保持独立历史事实。

本轮没有运行 Jest，没有使用 Codex 模型；编译/安装按用户此轮显式授权由 RDC 在 Mac 执行。

八、阶段判定和 Git

STEP-106 / Test App 修正闭环：CLOSED / PASS。

代码修正提交 86906c8a6af474a8d064c6f6d7d431e2a7e3efe6，之前根因记录提交 23f7b8a4d7b33d3fb63cd8691fc3a2f070936d03。本轮追加 recoder_step.md 与中文阶段记录，报告提交/远端 Push 以实际 Git 结果为准。正式 particle/main 不修改。

6.1 KiB Raw Permalink Blame History Unescape Escape