MapLibreParticleLab/release/maplibre-particle/ios/README.md

MapLibre Particle iOS Binary Distribution 基线

本目录只保存后续独立 distribution repository 所需的可审计模板；不发布二进制、不创建远端仓库，也不改变 MapLibre iOS 上游版本号。

模块和 product 始终为 MapLibre。MLRN 11.3.6 与后续 Particle Bridge 必须通过同一份自定义 MapLibre binary 消费，不能再链接第二个同功能但不同模块名的 framework。

Particle iOS 发行固定使用 Metal renderer。必须在 macOS 对目标 commit 执行：

bazel build --//:renderer=metal //platform/ios:MapLibre.dynamic

裸命令 bazel build //platform/ios:MapLibre.dynamic 会采用默认 OpenGL renderer；即使成功生成 XCFramework，也不得作为 Particle iOS 发行基线。发行前还应核验 device binary 含 MLNMapView、Metal/MTLDevice 与 ParticleGPU 标记，且无 OpenGL marker。

发布时：

1. 在 macOS 上从对应 Git commit 成功生成 MapLibre.dynamic.xcframework；
2. 压缩为 MapLibre.dynamic.xcframework.zip，对 zip 计算 SHA-256；
3. 用真实 URL、checksum、commit 和构建记录填充 release-manifest.json；
4. 将相同 URL/checksum 代入 Package.swift.template，再在独立 distribution repository 发布。

外部 binary distribution 版本独立于 platform/ios/VERSION；首个建议坐标为 6.28.0-particle.1。Metal XCFramework 已在本地构建和 Pleiades iPad mini 5 RN Test Host signed Release 路径验证；artifact 尚未发布远端，manifest 的 URL 仍为 LOCAL_BUILD，不得伪造下载地址。