HMS React Native Map Kit部分华为设备打开崩溃找不到libmap.so如何解决

根因说明 #

该报错为 HMS 地图套件动态加载 native 库失败，P40、Mate30 等高版本华为设备预装的 HMS Core 版本较高，已经内置了对应架构的 libmap.so 可直接加载；而荣耀8x、TRT-LX2 这类旧设备本地 HMS Core 未预装该库，受应用配置或 HMS Core 版本限制动态拉取失败，最终触发崩溃。

可落地解决步骤 #

• 调整ABI架构过滤配置
  荣耀8x、TRT-LX2 这类旧款中低端设备大多采用 armeabi-v7a 32位架构，如果你当前工程仅配置了 arm64-v8a 架构过滤，会导致32位设备无法匹配到对应架构的so库。修改 android/app/build.gradle 配置：

  android {
      defaultConfig {
          ndk {
              // 同时兼容32位和64位架构
              abiFilters "armeabi-v7a", "arm64-v8a"
          }
      }
  }
  

  如果需要控制包体积，可以开启安卓架构分包功能，针对不同架构推送对应安装包
• 开启本地so优先加载配置
  在 AndroidManifest.xml 的 <application> 节点下添加以下元数据配置，强制优先加载应用内置的地图so库，避免依赖 HMS Core 动态拉取：

  <meta-data
      android:name="com.huawei.hms.maps.LOAD_MAP_FROM_LOCAL_FIRST"
      android:value="true" />
  

  同时确保你引入的 HMS 地图依赖版本为包含全量so的稳定版，不要使用仅含轻量接口的动态依赖版本。
• 补充混淆豁免规则
  检查 android/app/proguard-rules.pro 文件，添加 HMS 地图和动态加载组件的混淆豁免规则，防止打包时误删除so库对应的加载逻辑：

  -keep class com.huawei.hms.maps.** {*;}
  -keep class com.huawei.hms.dynamicloader.** {*;}
  -keepclassmembers enum * {
      public static **[] values();
      public static ** valueOf(java.lang.String);
  }
  

• 增加HMS Core版本检测逻辑
  在应用打开地图前添加版本检测，当检测到用户本地 HMS Core 版本低于6.0.0时，引导用户升级 HMS Core 到最新版本，规避旧版本 HMS Core 动态拉取so库的已知问题。

内容的提问来源于stack exchange，提问作者Vina