# 变更记录

## Unreleased

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

- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 28。
## 13.6.1-particle.27（Android / iOS 统一发行）

- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 27。
## 13.6.1-particle.26（Android / iOS 统一发行）

- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 26。
## 13.6.1-particle.25（Android / iOS 统一发行）

- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 25。
## 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 发布线，保留为历史版本记录。