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

状态

进行中。40-01 Stage A 的代码和 Linux 静态验证完成；最终 Android 状态固定为 WAITING_MANUAL_VALIDATION，尚未进入手工 APK 验收。

目标与基线

目标：建立 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 APK 手工编译与 T1-T12：仅 GPT 复审远端代码通过后由用户执行。

允许修改

隔离 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 精确对象编译：PASS。
clang-format --dry-run --Werror、git diff --check、fixture generator：待本轮最终收尾复跑。
adapter smoke：uniform-east、uniform-north、vortex 均 valid；nodata valid 且有 1 个 invalid cell。

当前结果、阻塞与下一步

正式 Source/Layer/RenderLayer 已不依赖 source-less particle-validation Layer；历史 validation Layer 只保留为既有验证工具。唯一阻塞是按用户指令等待 GPT 复审新远端 commit；复审通过后才允许用户开始 Android OpenGL APK 手工验收。

2.6 KiB Raw Blame History Unescape Escape