STEP-040 Android 离线 Fixture 正式粒子最小闭环 v1

状态

完成。40-01 Stage B Android OpenGL x86_64 手工验收已完成，正式状态为 PASS。

目标与基线

目标：建立 RasterArraySource -> RenderRasterArraySource -> RasterParticleLayer -> RenderRasterParticleLayer 的第一条正式离线粒子闭环，并修复 STATIC recreation 的零步 bootstrap。
基线：343cecc778c3ffaa00adf94f82d7ad5f494a3877，分支 particle/main。
前置：30-01、30-02、30-03 均为 PASS；EGL context recreation 的独立实机证据仍是已接受风险。

必做项

RasterArraySource 以 FileSource byte boundary 读取 fixture metadata 与 field，生成 immutable ParticleFieldSnapshot。
RenderRasterArraySource、RasterParticleLayer（Source::Required）和 RenderRasterParticleLayer 进入 Style/RenderTree 链。
正式 RenderLayer 复用既有 GPU field、State A/B、Trail A/B、mask、camera/world-wrap/antimeridian 与 resource lifecycle；没有第二套 simulation。
Android Test App 从 APK asset://integration/particle-fixtures/... 提供正式 source 输入；Linux smoke helper 仍可读取仓库 fixture。
NoData cell 作为 GPU field texture alpha=0 上传；shader 遇到 invalid sample 确定性回到 seed position，不把 NoData 当速度。
STATIC recreation 仍走 zero-step State/Trail/bootstrap composite，commit 不增加 simulationFrame。
Android OpenGL x86_64 APK 手工验收：GLOBAL/ACTIVE/STATIC、fixture 切换、Rotation、Camera、world wrap、antimeridian、mask、disable/enable 与快速切换均 PASS。

允许修改

隔离 particle field/source/layer/render source/render layer、最小 LayerManager/Style Source/shader 注册、Android Test App fixture assets 与本 Step 文档。

禁止修改

不得运行 Gradle、安装 APK、ADB/T1-T12；不得新增 Overlay、Android UI/Core 耦合、在线数据、第二套 GPU simulation，或声称 Android/Vulkan/iOS PASS。

构建与检查

Linux OpenGL 受影响 Core 与 source.test.cpp.o 均在各轮修复后精确编译：PASS（-Werror）；完整 mbgl-test 不属于本任务的精确验证范围。
clang-format --dry-run --Werror、git diff --check、shader generator/source-header parity 与生成器幂等检查：PASS。
adapter smoke：uniform-east、uniform-north、vortex 均 valid；nodata valid 且有 1 个 invalid cell。Android APK OpenGL x86_64 手工验收：PASS。

当前结果、阻塞与下一步

正式 RasterArraySource -> RasterParticleLayer 闭环已通过 Android OpenGL x86_64 Stage B。历史调试中先后修复 OfflineDownload 枚举接入、enabled RasterArray source 空 RenderItem SIGSEGV、旧 APK/.cxx native 缓存、ACTIVE/STATIC transient reset、formal Composite 未显示 Trail、shader source/generated header 不一致、opaque RenderTarget clear 下的 State seed、source 重建的 field identity generation collision，以及 STATIC Rotation/Viewport 自动恢复。最终实机已确认：east/north/east 切换方向正确、ACTIVE/STATIC lifecycle 正确、Camera 与 Rotation 正确、GLOBAL/OCEAN A/OCEAN B 与 shared mask reuse 正确。相同 RenderThread/resource generation 内三种 mask consumer 均复用同一 maskGeneration 且 reuse=true；graphics resource 重建后的 generation 递增属于新 GPU resource，不是同 generation 内重复创建。40-01 正式关闭为 PASS。iOS、Vulkan、真实在线数据、生产 coastline/mask 和性能结论不在本 Step 范围。

3.5 KiB Raw Permalink Blame History Unescape Escape