# MapLibre Particle 13.6.1-particle.22 正式发行

发行说明：本目录保存 **GSRL 源码与制品身份记录**；二进制正式存放在 NAS 的公网发行入口（不会提交进 Git）。v22 同源冻结提交为 `ea5bd393c664a54513531998bf8609a0535639f7`。

## 版本与发行范围

- Android OpenGL Native：`cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.22`，包含 `arm64-v8a`、`armeabi-v7a`、`x86`、`x86_64`。
- React Native package：`@navsea/maplibre-particle-rn@13.6.1-particle.22`，peer `@maplibre/maplibre-react-native@11.5.0`。
- iOS Metal：`MapLibre` XCFramework / SwiftPM `6.29.0-particle.22`（ios-arm64）。
- 正式源码 Tag：`maplibre-particle/rn/13.6.1-particle.22`；Build Source Commit 见 `SOURCE_LOCK.json`。

## 公网制品（NAS 发布）

| 制品 | 获取地址 |
| --- | --- |
| Android AAR | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.22/android-sdk-particle-opengl-13.6.1-particle.22.aar |
| Android POM | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.22/android-sdk-particle-opengl-13.6.1-particle.22.pom |
| Android Gradle Module Metadata | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.22/android-sdk-particle-opengl-13.6.1-particle.22.module |
| RN tgz | https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.22.tgz |
| iOS Metal XCFramework zip | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.22/MapLibre.dynamic.xcframework.zip |
| iOS XCFramework SHA-256 文件 | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.22/MapLibre.dynamic.xcframework.zip.sha256 |

完整 SHA-256 以本目录 `SOURCE_LOCK.json` 的 `files[]` 为权威记录。以上文件均已按 NAS 公网重新下载与原始构建文件逐字节比对。

## 使用方法

**Android**：Gradle Maven repository 增加 `https://pbf.jpcn.ccwu.cc/maven`，依赖：

`implementation("cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.22")`

本版 AAR 采用 OpenGL，不宣称包含 Vulkan 制品。

**React Native**：从上表 RN tgz 的 HTTPS URL 安装 `@navsea/maplibre-particle-rn`；宿主需使用 `@maplibre/maplibre-react-native@11.5.0`。按 package 内 `README.md` 配置 Android Maven、Expo plugin、iOS Podspec/codegen；勿继续锁定 v21 的 `13.4.1` Native。

**iOS**：SwiftPM repository：`https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git`，选择 exact tag `6.29.0-particle.22`，product `MapLibre`。将 RN iOS 依赖与该同源 Metal binary 按宿主 Post Install 说明接入。

## GSRL 来源核对与接收

1. 从此目录获取 `SOURCE_LOCK.json`，确认项目名、发行版本、Git Remote、完整 `gitCommit` 和 `gitRef`。
2. 按上述 URL 下载所需制品，重新计算各文件 SHA-256，与 `files[]` 逐项比较；确认 Gradle/RN/SwiftPM 依赖版本。
3. SHA 或来源不同不得按本版接收。已发行版本不可覆盖；修正须使用新版本。

## 验证边界

- Mac 统一源码构建、四 ABI Android Release AAR、iOS Metal ios-arm64 XCFramework、RN tgz 与公网逐字节回读：PASS。
- FZG1-2 x86_64/OpenGL Test App 的 STEP-106 粒子/RenderSegment/Renderer/QBIN 定向回归：PASS；该测试不能替代正式 Release AAR 在 NavSea 上的集成测试。
- Android ARM64 实机、RN 11.5.0 宿主整体集成、iOS Metal 真机：**本次未验证，不宣称这些运行环境 PASS**。
- GSRL PASS 仅代表源码与发行文件身份一致、可获取、依赖及说明完整。

## 溯源

- Build Source Commit：`ea5bd393c664a54513531998bf8609a0535639f7`
- 主发行清单：`release/maplibre-particle/release-manifest.json`
- GSRL Source Lock：`release/maplibre-particle/13.6.1-particle.22/SOURCE_LOCK.json`
- 原始构建与发布详细日志位于 Mac 临时工作区 `artifacts/maplibre-particle/`，**不是使用方获取入口**。