40 lines
2.6 KiB
Markdown
40 lines
2.6 KiB
Markdown
# 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 的独立实机证据仍是已接受风险。
|
||
|
||
## 必做项
|
||
|
||
- [x] `RasterArraySource` 以 FileSource byte boundary 读取 fixture metadata 与 field，生成 immutable `ParticleFieldSnapshot`。
|
||
- [x] `RenderRasterArraySource`、`RasterParticleLayer`（`Source::Required`）和 `RenderRasterParticleLayer` 进入 Style/RenderTree 链。
|
||
- [x] 正式 RenderLayer 复用既有 GPU field、State A/B、Trail A/B、mask、camera/world-wrap/antimeridian 与 resource lifecycle；没有第二套 simulation。
|
||
- [x] Android Test App 从 APK `asset://integration/particle-fixtures/...` 提供正式 source 输入；Linux smoke helper 仍可读取仓库 fixture。
|
||
- [x] NoData cell 作为 GPU field texture alpha=0 上传；shader 遇到 invalid sample 确定性回到 seed position，不把 NoData 当速度。
|
||
- [x] 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 手工验收。
|