3.6 KiB
当前基线与开发路线 v2
1. 冻结日期
2026-09-14。当前正式分支为 particle/main，本文对应 QBIN2 V4 Android/RN Test Host 已完成真机/模拟器人工验证后的基线。
2. 当前 Git 基线
当前整理起点 HEAD：de8d230b87345c2538c71318681119cdecb2762a。正式远端为 origin/particle/main。历史 STEP 文档用于追溯当时事实，不再自动代表当前构建方式。
3. 当前 Android/RN 版本
- Native OpenGL AAR：
cc.navsea.maplibre:android-sdk-particle-opengl:13.4.1-particle.3。 - RN package：
@navsea/maplibre-particle-rn@13.4.1-particle.3。 - MLRN：
@maplibre/maplibre-react-native@11.3.6。 - React Native Test Host：RN
0.85.2、New Architecture。 - Native/RN 版本必须同为
.3；不得再使用.2作为当前消费坐标。
4. 当前数据与渲染主链
正式新增链路为 QBIN V4：宿主下载/缓存 raw QBIN，本地文件通过 FieldRuntime.submitEncodedField(...) 进入 Android Bridge/JNI，再由 RasterArraySource::submitEncodedField(...) 与 QbinV2Decoder::decode(...) 解码。MapLibre 不负责 HTTP、provider、manifest、缓存或业务调度。
旧 V3 canonical submitField(...) 仍保留用于历史兼容和 Test Host 对照，不是 NavSea 新接入的推荐主链。
5. 当前 V4 公共控制面
NavSea/Consumer 新代码优先使用：submitEncodedField、setEncodedColorBinding、setEncodedParticleBinding、setEncodedForecastTime、setEncodedForecastPlaybackState、setEncodedForecastPlaybackSpeed、clearEncodedField。运行时继续由 Core 拥有 Field Window、Forecast Clock、T0/T1/mix 与 boundary reuse。
6. 当前发布来源
https://pbf.jpcn.ccwu.cc/ 映射 Linux /mnt/nas/pbf。Native 正常发布到 /mnt/nas/pbf/maven/，RN tgz 正常发布到 /mnt/nas/pbf/npm/；Windows 11 正常验证必须从公网 npm/Maven 消费，不以 Windows Maven Local 或 LAN AAR 复制作为正式路径。
当前已验证 AAR SHA-256：9ef03eb0d0c03457adc04847cfa69fb67d85191daecd64d3b76db2ad8cc688cd。当前 .3 RN tgz 在 2026-09-14 Kotlin 编译修正后重新发布；今后公开版本内容变化必须升版本，不再覆盖同版本。
7. 当前 Test Host
正式源码：integration/react-native/MapLibreParticleRNTestHost/。V4 Golden fixtures：Wind/Wave/Current/Rain 各 T0/T1，共 8 个 .qbin。Test Host 同时保留 V3 控制用于对照，但 V4 验收必须通过 submitEncodedField。
Windows 推荐工作目录必须是普通子目录，例如 D:\React\MapLibreParticleRNTestHost-V4，不要在盘符根目录执行 Expo prebuild。Metro 监听 8091，Debug App 访问设备 localhost:8081，固定使用 adb -s 192.168.1.146 reverse tcp:8081 tcp:8091。
8. 当前权威操作文档
Android AAR 公网发布、Win11 Test Host 构建、Metro/ADB 与 V4 验收以 docs/50_Step记录/STEP-080_Android_AAR与RNTestHost标准构建流水线_v2.md 为准。tools/particle_android_pipeline/README.md 已明确 v1 本地 handoff 工具只用于历史/离线兼容。
9. 历史文档边界
STEP-060～072 中的 Maven Local、13.4.1-particle.1/.2、旧 D:\V308、旧 reverse 组合等内容保留为历史验收证据，不得直接用于当前 .3 构建。需要当前命令时先读本文件和 STEP-080 v2。
10. 下一阶段
当前 Native/RN QBIN V4 Android 基线可用于 NavSea 最小正式接入。建议先做 Wind 单纵向切片：NavSea Weather/Cache 层准备本地 QBIN → V4 submit/binding/time → 地图显示/clear；通过后再扩展 Wave/Current/Rain。NavSea 不解析 QBIN，也不把网络 URL 交给 MapLibre。