diff --git a/docs/报告/V27_统一正式发行_GSRL_RDC完成报告_v1.md b/docs/报告/V27_统一正式发行_GSRL_RDC完成报告_v1.md new file mode 100644 index 000000000..507c836b9 --- /dev/null +++ b/docs/报告/V27_统一正式发行_GSRL_RDC完成报告_v1.md @@ -0,0 +1,72 @@ +# V27 统一正式发行 GSRL RDC 完成报告 v1 + +日期:2026-10-14(JST) +结论:**GSRL RELEASED / PASS**。该结论限于 Git Source Lock、正式发行文件、依赖与公网取回一致性,不等同于 NavSea 真机产品验收。 + +## 一、发行范围与版本 + +- 项目:MapLibreParticleLab;Git Remote:https://git.eyaku.jp/tei/MapLibreParticleLab +- 当前仓库:Mac.lan /Users/tei/dev/MapLibreParticleLab,分支 particle/main。 +- Android OpenGL AAR / React Native:13.6.1-particle.27。 +- iOS Metal / SwiftPM:6.29.0-particle.27,仅 iOS arm64 真机,不含 Simulator。 +- 冻结的实际共用构建源码 Commit:970e3ad606e59873a32e9389e65ef257e1c259bb。 +- 正式 Git Tag:maplibre-particle/rn/13.6.1-particle.27。 +- Tag 直接目标(peeled commit):3c3dcb9d1856c41e9e50734aa12bda0b6f71e294。 +- Annotated Tag 对象:ee09f254fd3c42c8be999ce1bd39aed6477d08a2。 +- 公网 Maven:https://pbf.jpcn.ccwu.cc/maven +- 公网 RN:https://pbf.jpcn.ccwu.cc/npm +- 公网 iOS:https://pbf.jpcn.ccwu.cc/swift/maplibre-particle +- SwiftPM 仓库:https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git + +V27 源码变化重点为 Metal Retained Underlay Composite 顶点缓冲绑定槽位修正为 maxUBOCountPerShader + 0。三份 V26 失败候选调查报告作为历史证据保留;此前失败候选不能被认作本次正式修复。NavSea 当前采用 RCR 运行基线,仍保留 Retained;不将 E 全 Continuous 降级作为 V27 最终方案。 + +## 二、环境与发行前保护 + +- Integration 仓库 /Users/tei/dev/navsea-particle-integration 已 fetch 核验:main 与 origin/main 均为 80667d6c343411d03a760425438e3d292f452118,差异 0/0。 +- GSRL 正式规范采用 v1.0.0;Win11 D:\React\GSRL 核验 HEAD 8a34221da415b3a880969e22e3b768d705a28944。 +- 开始时 Particle particle/main 为 b0f34cc9a299a75af1f7e708c63d75eaa42e9ca2,与 origin/particle/main 一致。存在一项未提交的 Metal Shader 变更和三份未跟踪历史报告。 +- 只将本次 Metal 修复和三份历史报告纳入源代码提交;未删除无关修改,未新建或切换 Git 分支、Worktree,未 Force Push。 +- 发行前 V27 Git Tag 不存在,三个主要公网地址均为 HTTP 404;没有覆盖既有 V26 文件或 Tag。 +- 本次全部实际设备操作由 RDC 直连 Mac 执行,没有调用 Codex。 + +## 三、严格串行执行结果 + +1. 前置 Git 修复提交:a9cea8b581f71bf8aab8b85a73a258017d69a33e,fix: retain correct Metal composite vertex buffer slot;包括 Shader 与三份历史报告,Commit/Push/Remote Receipt PASS。 +2. V27 Prepare:release.sh 27 prepare,exit 0;生成版本配置并提交 970e3ad606e59873a32e9389e65ef257e1c259bb,release: prepare unified particle.27。该提交就是后续发行文件统一使用的实际构建源码,已 Push 并核对远端。 +3. V27 Build:release.sh 27 build,exit 0;Android OpenGL 四 ABI Gradle Release 与 Maven Local AAR/POM/Module PASS,Bazel 8.6.0 opt Metal XCFramework PASS,RN npm pack PASS。完整日志:/tmp/maplibre_v27_unified_build_20261014.log。Bazel 报告 INFO Build completed successfully,ZIP 为 ios-arm64 真机版;Android 编译日志确认四种 libmaplibre.so。 +4. V27 Publish:release.sh 27 publish,exit 0;NAS SSH 暂存上传、哈希对照及路径原子晋升,AAR/POM/Module/RN tgz/iOS ZIP/iOS ZIP.sha256 六文件公网逐字节回读 PASS;SwiftPM 6.29.0-particle.27 Tag PASS。日志:/tmp/maplibre_v27_publish_20261014.log。 +5. GSRL Source Lock:新建 release/maplibre-particle/13.6.1-particle.27/SOURCE_LOCK.json 及 README.md,并在 release/README.md 登记当前推荐版。Source Lock Commit:7f92f71416fd57dcd55c5c836365385049a6450a,release: record v27 GSRL source lock and receipt instructions;Commit/Push/Remote Receipt PASS。 +6. Finalize:release.sh 27 finalize,exit 0。四份通用/iOS Manifest 与 Package.swift 模板 Commit:3c3dcb9d1856c41e9e50734aa12bda0b6f71e294,release: finalize unified particle.27。推送 particle/main 及新的 annotated Git Tag,远端 peeled Tag 与 Final Commit 一致。日志:/tmp/maplibre_v27_finalize_20261014.log。 +7. 独立二次核验:不是依靠发布脚本内部的回读结论,而是重新下载六项公网文件,按 Source Lock 单独计算 SHA-256 和文件大小,6/6 PASS;AAR 四 ABI、iOS ZIP 无 Simulator、RN package version/peer、SwiftPM Tag、源码 Commit 祖先关系、远端 Tag/HEAD 及 Git clean 均 PASS。机器可读回执:/tmp/maplibre_v27_independent_receipt_20261014.json。 +8. 本报告属于发行 Tag 完成后的追加审计记录。后续提交本报告不移动既有 V27 Tag,也不更改 Source Lock 指向的实际构建源码 Commit。 + +## 四、六项正式文件独立校验 + +| 文件 | 大小(字节) | SHA-256 | 公网独立下载 | +| --- | ---: | --- | --- | +| android-sdk-particle-opengl-13.6.1-particle.27.aar | 16640539 | 2ff3ead8e5d7cb8802a4c05ba20cd7f8f0a7029f72619f9a2ec176c942ae8de4 | PASS | +| android-sdk-particle-opengl-13.6.1-particle.27.pom | 5687 | 324d14d689ba7c9206298734d7f9636b95e947c7241d94ec60f8f1d57bd1b701 | PASS | +| android-sdk-particle-opengl-13.6.1-particle.27.module | 6999 | 403804395f065cef75f1254403edbda67c3a885769acbf6d25e091d37c325910 | PASS | +| navsea-maplibre-particle-rn-13.6.1-particle.27.tgz | 29040 | fdd67210debd8363d4bf72fcc0120ef747dc3037d55b8c0d83330dd98bb0bc5d | PASS | +| MapLibre.dynamic.xcframework.zip | 4181894 | 5dbde28600df35484a7f31e7c7c4780f27b919fc6ec59f6aa88d65d81342448c | PASS | +| MapLibre.dynamic.xcframework.zip.sha256 | 99 | 1dba0b0a2831beeadcc022801622829d630ef0838babdfef4edc4b8bec34e08d | PASS | + +六项文件的完整实际下载 URL、依赖版本和使用方法由本版 SOURCE_LOCK.json / README.md 权威记录。 + +## 五、未测试事项、风险及下一步 + +- 本次未在 Android/FZ-G1 安装运行 V27 正式发行 AAR,也未通过正式 NavSea Host 真机验收;先前开发态 Test App 验收不能代替正式发行包验收。 +- 本次未在 iPad/iPhone 安装运行 V27 正式发行 XCFramework;用户此前确认的是 Metal slot-9 预发行调试候选画面,不应虚报正式制品真机 PASS。 +- 未执行新增或历史 C++ 生命周期 GTest;不以构建 PASS 冒充 GTest PASS。 +- RCR 是当前 Host 基线;RCRR 仍须按其单独测试范围区分实验能力和产品正式验收。 +- GSRL PASS 表明源码可恢复、产物可取得且 SHA-256 相符,不能推断与所有 NavSea Host 场景兼容或端到端运行稳定。 +- 后续正式接入应从 release/README.md 选择 V27,接收方复核 SOURCE_LOCK.json 的六项哈希,并依据各平台操作边界完成真机验收。 + +## 六、Git 与 Source Lock 最终原则 + +冻结 Build Source Commit:970e3ad606e59873a32e9389e65ef257e1c259bb。 +Source Lock Commit:7f92f71416fd57dcd55c5c836365385049a6450a。 +正式 Finalize / Tag Commit:3c3dcb9d1856c41e9e50734aa12bda0b6f71e294。 +正式 Tag:maplibre-particle/rn/13.6.1-particle.27。 + +上述源码、发行文件和 Tag 通过远端与公网独立核验。发行 Tag 不会因本报告后续追加提交而移动。