MapLibreParticleLab/packages/maplibre-particle-rn/CHANGELOG.md

变更记录

Unreleased

13.6.1-particle.23（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 23。

13.6.1-particle.22（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 22。

13.4.1-particle.21（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 21。

13.4.1-particle.20（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 20。

13.4.1-particle.19（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 19。

13.4.1-particle.18（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 18。

13.4.1-particle.17（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 17。

13.4.1-particle.16（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 16。

13.4.1-particle.15（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 15。

13.4.1-particle.13（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 13。

13.4.1-particle.12（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 12。

13.4.1-particle.11（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 11。

13.4.1-particle.10（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 10。

13.4.1-particle.9（QBIN V3 Decoder）

• 新增 QBV3/v3 Native Decoder，固定 16×16 Block Geometry，支持 Predictor + ZigZag + Rice 解码、Direction 环形残差、CRC32、canonical packing、validity 与资源上限校验。
• EncodedFieldIngress 依据 QBV2 / QBV3 magic 显式分流；既有 QBV2 行为保持兼容，FieldProfileValidator 仍在解码后统一执行。
• 新增 Current / Rain / Wave / Wind 共 8 个 QBIN V3 Golden Fixtures 与校验脚本；新增 decoder corruption/canonical/ingress C++ 定向测试。
• Native / RN 统一升级到 13.4.1-particle.9。

13.4.1-particle.8（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 8。

13.4.1-particle.7（Android / iOS 统一发行）

• Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 7。

13.4.1-particle.6（历史 iOS 过渡发行）

• 已公开的 RN .6 与 iOS Metal .6 用于 iOS 接入验证；RN .6 仍显式依赖 Android Native .5，因此 .6 不是 Android/iOS 统一发行版，且不得覆盖重发。
• 新增 iOS WeatherRuntimeBridge RN 0.85 codegen TurboModule，实现既有 V3/V4 与视觉控制 ABI；每个命令从当前 Fabric/UIManager view registry 重新解析 MLRN MapView，不缓存 map/runtime 指针。
• 新增 iOS pod/autolinking/codegen provider。pod 复用 MapLibreReactNative 的唯一 MapLibre product，不嵌入第二份 framework。
• iOS Podfile 的 post-install 现在必须同时调用 $MLRN.post_install(installer) 和 $MLRN_PARTICLE.post_install(installer)；两者消费同一 $MLRN_SPM_SPEC，以让 MLRN、App 与 Particle pod target 共享一个 MapLibre package/product。

13.4.1-particle.5（当前 Android QBIN V4 Renderer 基线）

• 新增 QBIN V4 BindingProjection → renderer-facing canonical snapshot materialization，并由 RasterParticle / WeatherColor Renderer 正式消费。
• 保持 V3/V4 隔离：V4 不回写旧 field / nextField / timeline，仅通过独立 v4RendererState 进入渲染路径。
• V4 midpoint / playback 仅改变 MIX 时保持 projection content identity，不要求重复上传相同 T0/T1 GPU field。
• materializer 对 Int16 / UInt16 / Float32 使用显式 little-endian 解码，并支持冻结 QBIN V2 DIRECTION_TO UInt16 方向角转向量。
• 修复 13.4.1-particle.4 在 Android Test Host + frozen Golden QBIN 条件下控制面 ACCEPTED、但 Renderer 未获得有效 V4 field window 而无可见粒子的链路缺口。
• RN package 与 Android Native artifact 统一升级到 13.4.1-particle.5。

13.4.1-particle.4（当前 Android QBIN V4 基线）

• RN 公共入口正式导出 QBIN V4 Consumer 类型：Encoded Runtime Metadata、Resolved Field Profile Contract、Color/Particle Binding 与 Encoded Submit Result。
• UTF-8 长度校验改为包内纯 TypeScript 实现，不再要求 Consumer TypeScript 环境提供 DOM TextEncoder 类型。
• RN 与 Android Native 发布坐标同步升级到 13.4.1-particle.4；QBIN V4 API、Native ABI 与渲染语义不变。

13.4.1-particle.3

• RN package 与 Android Native artifact 已统一为 13.4.1-particle.3。
• 新增 QBIN V4 encoded ingress：submitEncodedField、Color/Particle Binding、Forecast Time/Playback、encoded clear。
• Android/JNI/RN 链路已接通 RasterArraySource::submitEncodedField 与 QbinV2Decoder。
• ColorBinding 支持 VELOCITY_COMPONENT，用于 Wind/Current 的 U 分量色场。
• 保留 V3 submitField(FieldPayloadRefs) 作为兼容/对照入口；新 Consumer 推荐 V4。
• 2026-09-14 Win11 实编译发现并修正 Kotlin validUInt16 / validSafeInteger 条件表达式；修正后的 RN .3 已重新发布。
• Test Host 已用 8 个真实 QBIN Golden Fixture（Wind/Wave/Current/Rain，各 T0/T1）完成 Android 人工验证。
• Expo plugin、Test Host plugin 与 RN Android dependency 均指向公网 pbf Maven 的 Native .3。

13.4.1-particle.2

• 公共 RN/TS API 重整为纯 Field Renderer 接口。
• 移除包内数据加载、HTTP、解码与业务辅助模块；宿主负责业务选择、缓存和本地文件。
• 新增 V3 canonical submitField / FieldPayloadRefs 与通用 Scalar/Vector Field 支持。
• 该版本属于 V3 历史基线。

13.4.1-particle.1

• 首个 Android OpenGL Particle RN 发布线，保留为历史版本记录。