MapLibreParticleLab/docs/50_Step记录/STEP-063_MapLibre粒子Android_v1发布工程化_v1.md

STEP-063 MapLibre 粒子 Android v1 发布工程化 v1

状态：IMPLEMENTED / WAITING_MANUAL_RELEASE_VALIDATION

目标与基线

• 实际 MapLibre Native Android 基础版本：13.4.1；core：18545ca10d296704b2cba675b182ff2c8da24588；renderer：OpenGL。
• 正式版本：13.4.1-particle.1；npm：@navsea/maplibre-particle-rn@13.4.1-particle.1；Maven：cc.navsea.maplibre:android-sdk-particle-opengl:13.4.1-particle.1。
• STEP-061 的 13.4.1-step061 是开发期已验收坐标，不作为正式 release/package/build config。

已完成

• 建立机器可读 release manifest，registry 均明确为 null。
• Android publication 配置改为正式 group/artifact/version，保留 OpenGL publication postfix。
• 建立正式 RN facade package，含 JS/TS source、类型、Android bridge、autolinking、Expo plugin、README、CHANGELOG、LICENSE。
• package plugin 将 MLRN 的单一 OpenGL SDK dependency substitution 到正式 NavSea AAR，避免双 Native AAR。
• 建立只声明正式 npm 包的 Consumer Test Host；不引用源码 package、Native tree 或复制 bridge。MLRN 采用 peer dependency，避免嵌套 native module 与 Windows codegen 长路径。
• Windows 预发布 Consumer 首次 APK 编译暴露嵌套 MLRN codegen 路径超过 260 字符；已修正式包依赖模型并重新打包，等待新 tarball 重装后复验。
• npm pack、tarball 内容审计、package JSON、plugin syntax、package TypeScript check、git diff --check 静态验证。
• 设计、Step、完成报告和开发记录。

禁止项与未执行项

未改 Particle/Core/JNI/WeatherRuntime 业务功能，未接入 NavSea，未执行 Android Gradle、AAR build/publish、Maven Local publish、APK、ADB 或 Jest。未创建 release tag，未决定 npm/Maven server。

下一步

用户手工构建并在 Maven Local 或临时 staging 准备 cc.navsea.maplibre:android-sdk-particle-opengl:13.4.1-particle.1；以 npm tarball 安装 Consumer Host，手工编译/安装 APK 并验证 GSI、WeatherColor、Particle 与 Runtime READY。全部通过后才可进入 release freeze/tag 任务。