60 lines
4.2 KiB
Markdown
60 lines
4.2 KiB
Markdown
# MapLibre Particle 13.6.1-particle.23 正式发行
|
||
|
||
发行说明：本目录保存 **GSRL 源码与制品身份记录**；二进制正式存放在 NAS 的公网发行入口（不会提交进 Git）。v23 同源冻结提交为 `87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`。
|
||
|
||
## 版本与发行范围
|
||
|
||
- Android OpenGL Native：`cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23`，包含 `arm64-v8a`、`armeabi-v7a`、`x86`、`x86_64`。
|
||
- React Native package：`@navsea/maplibre-particle-rn@13.6.1-particle.23`，peer `@maplibre/maplibre-react-native@11.5.0`。
|
||
- iOS Metal：`MapLibre` XCFramework / SwiftPM `6.29.0-particle.23`（ios-arm64）。
|
||
- 正式源码 Tag：`maplibre-particle/rn/13.6.1-particle.23`；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.23/android-sdk-particle-opengl-13.6.1-particle.23.aar |
|
||
| Android POM | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.23/android-sdk-particle-opengl-13.6.1-particle.23.pom |
|
||
| Android Gradle Module Metadata | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.23/android-sdk-particle-opengl-13.6.1-particle.23.module |
|
||
| RN tgz | https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.23.tgz |
|
||
| iOS Metal XCFramework zip | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/MapLibre.dynamic.xcframework.zip |
|
||
| iOS XCFramework SHA-256 文件 | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/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.23")`
|
||
|
||
本版 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.23`，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。
|
||
- 本版 V23 尚未执行 Android 实机 / RN 11.5.0 宿主整体验收；不得引用 V22 的 STEP-106 通过事实冒充 V23 运行时测试。
|
||
- Android 实机、RN 11.5.0 宿主整体集成、iOS Metal 真机：**V23 尚未验证**。STEP-107 已包含 iOS nil Peer 崩溃代码修复，但唐津港湾 iPad 直接点击及 XCTest 仍未完成，不宣称崩溃实机修复 PASS。
|
||
- GSRL PASS 仅代表源码与发行文件身份一致、可获取、依赖及说明完整。
|
||
|
||
## 溯源
|
||
|
||
- Build Source Commit：`87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`
|
||
- 主发行清单：`release/maplibre-particle/release-manifest.json`
|
||
- GSRL Source Lock：`release/maplibre-particle/13.6.1-particle.23/SOURCE_LOCK.json`
|
||
- 原始构建与发布详细日志位于 Mac 临时工作区 `artifacts/maplibre-particle/`，**不是使用方获取入口**。
|
||
|
||
## V23 修复范围
|
||
|
||
本版包含 STEP-107 的 Darwin MLNStyle CoreOnly Layer 无 ObjC Peer 的集合访问保护及层顺序修正。原 V22 发行身份保持不变，后续真机验收状态单独追踪。
|