uniapp打包的自定义基座 maps模块未生效是什么原因？

在 UniApp 中，自定义基座的 maps 模块未生效，通常由以下几个原因导致。请按步骤排查：

1. 未正确配置 manifest.json

• 在 manifest.json 的 App模块配置 中，确保已勾选 Maps(地图) 模块，并配置相关设置（如高德地图、百度地图的 AppKey）。
• 示例配置（高德地图）：

  {
    "app-plus": {
      "modules": {
        "Maps": {}
      },
      "distribute": {
        "sdkConfigs": {
          "maps": {
            "amap": {
              "appkey_ios": "你的iOS AppKey",
              "appkey_android": "你的Android AppKey"
            }
          }
        }
      }
    }
  }
  

• 注意：iOS 和 Android 的 AppKey 需分别申请，并确保包名（Bundle Identifier / Package Name）与申请时一致。

2. 自定义基座未更新

• 修改 manifest.json 后，必须重新制作自定义基座，否则更改不会生效。
• 在 HBuilderX 中，选择 运行 → 运行到手机或模拟器 → 制作自定义基座，重新打包并安装到设备。

3. 权限未配置

• Android：在 manifest.json 的 App权限配置 中，勾选位置相关权限（如 <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>）。
• iOS：在 manifest.json 的 iOS设置 中，勾选 位置服务 权限，并在 源码视图 中确认 NSLocationWhenInUseUsageDescription 已配置。

4. 代码调用问题

• 确保使用正确的 API（如 uni.createMapContext）并检查地图容器样式（宽度/高度不能为 0）。
• 示例代码：

  <template>
    <view>
      <map style="width: 100%; height: 300px;" :latitude="latitude" :longitude="longitude"></map>
    </view>
  </template>
  <script>
    export default {
      data() {
        return {
          latitude: 39.909,
          longitude: 116.39742
        };
      }
    };
  </script>
  

5. 平台差异

• 仅 Android 支持自定义基座调试：iOS 自定义基座需使用自有证书，且需通过 TestFlight 或企业证书安装。
• 真机调试时，确认使用的是自定义基座（HBuilderX 控制台会提示“正在使用自定义基座”）。

6. 网络或 Key 配置错误

• 检查 AppKey 是否正确，并确认网络权限已开启（地图需联网）。
• 在高德/百度开发者平台查看 Key 使用统计，确认是否有请求记录。

解决步骤总结：

1. 检查 manifest.json 配置并保存。
2. 重新制作自定义基座。
3. 检查设备权限和网络。
4. 真机运行自定义基座测试。

如果问题仍存在，查看 HBuilderX 控制台报错或使用 adb logcat (Android) / Xcode 日志 (iOS) 进一步排查。