Files
MapLibreParticleLab/docs/报告/V27_统一正式发行_GSRL_RDC完成报告_v1.md
tei 9d6c9e9684
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
docs: audit v27 unified GSRL release
2026-10-14 10:56:07 +09:00

73 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 不会因本报告后续追加提交而移动。