docs(android): record FZG MapLibre 13.6.1 APK installation verification
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled

This commit is contained in:
tei
2026-10-09 12:05:55 +09:00
parent 73db0356ac
commit c30add4d33
3 changed files with 83 additions and 0 deletions

View File

@@ -44,3 +44,16 @@
- 产物:`platform/android/MapLibreAndroid/build/intermediates/cmake/openglDebug/obj/x86_64/libmaplibre.so`,ELF 64-bit x86-64 动态库,包含 debug_info,大小 `377246848` bytes,SHA-256 `ff5a5eb45f84ff633a87fe385fb04ee39ba63ed3bc486003408e02cea78c8907`。
- Gate 结论:**Android x86_64 / OpenGL Native compile+link PASS**。这不是 APK 实机验证,不是全 ABI、Vulkan/iOS/RN 11.5.0/发布 PASS;其他 ABI 和运行态 Gate 暂未执行。
- 下一步建议:保留此为可复验的 Native 编译检查点;下阶段批量执行 Android 多 ABI 编译与 Test Host GPU 场景(Field/QBIN、Pan/Zoom/Rotate、RenderSegment、Style lifecycle),确认后再推进 RN 11.5.0。
## 2026-10-09 / STEP-105 / FZG1-2 Android 13.6.1 Validation APK 打包及安装
- 范围:Mac 的 `upgrade/android-native-13.6.1-20261009`,Native/源码基线 `30d0e6665eb16a258e47b3a8cc0d16932e43762b`;仅 Android Test App,未修改 NavSea、`particle/main`、iOS 或共享合同。
- 设备:FZG1-2,ADB `192.168.200.139:5555`,Android 13、首选 ABI `x86_64`;未操作另一台 Odin。
- 打包:使用 `tools/particle_android_validation/build_validation_apk.sh`,Gradle `:MapLibreAndroidTestApp:assembleOpenglDebug -Pmaplibre.abis=x86_64 -Pmaplibre.validation.stripNativeDebugSymbols=true --console=plain`。第一轮 Gradle **BUILD SUCCESSFUL in 6m 48s**,但验证脚本因 Sentry 辅助动态库同时包含其它 ABI 而拒绝;没有安装不合格包。
- 修复:脚本仍严格要求 MapLibre 与 example-custom-layer 仅有 x86_64,并仅对白名单 `libsentry.so` / `libsentry-android.so` 允许 arm64-v8a、armeabi-v7a、x86 的辅助库;其余意外 ABI 库 fail-closed。第二轮增量 Gradle **BUILD SUCCESSFUL in 10s**,完整 ZIP/ABI/包体校验 **PASS**;脚本独立提交 `73db0356ac5860366f314ddba23b716220e7c16a`。
- 产物:`artifacts/maplibre-particle/step105-native1361-fzg/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk`,package `org.maplibre.android.testapp`,versionName `13.6.1`,66,505,502 bytes,Native `libmaplibre.so` 打包后 39,970,088 bytes;SHA-256 `77bc0b238fb476494410a603443030b104d78f97a737307be52460bf5a68f5aa`。
- 安装前验证:FZG 已安装旧版 `13.4.1-particle.21`,旧新 APK 签名证书 SHA-256 均为 `e3f8fae6451ed6322259d090dd8e8788df554ab25ed89a01c78014f1d5ef8236`。
- 安装:Mac `adb -s 192.168.200.139:5555 install -r <APK>` 返回 **Success**,2026-10-09 12:03:06 JST 完成;FZG `dumpsys package` 返回 versionName=`13.6.1`,firstInstallTime 仍为 2026-09-22 07:34:56,未卸载/清除原有应用数据;设备上已安装 APK 的 SHA-256 与 Mac 文件一致。
- FZG 原版 APK 备份:`artifacts/maplibre-particle/step105-native1361-fzg/rollback/MapLibreAndroidTestApp-original-13.4.1-particle.21.apk`(不纳入 Git),SHA-256 `999f773276b29fffae05c1edc977e19df6cebecd94e4a4095508d0c5e97e07c2`。
- 当前 FZG 前台依旧 `com.navsea.app/.MainActivity`;本轮不自动启动 Test App,未进行 Particle/RenderSegment GPU 画面或功能回归。
- 结论:**APK_BUILD_PASS / FZG_INSTALL_PASS / INSTALLED_FILE_SHA_PASS / RUNTIME_NOT_RUN**。下一步单独进行 FZG Test App 启动、粒子/QBIN、Pan/Zoom/Rotate、RenderSegment/Style/卸载的真机运行验收。