uniapp 已配置sdk但打包时仍提示未添加maps模块怎么办
在uniapp中已经配置了高德地图SDK,但打包安卓应用时仍然提示“未添加maps模块”,请问该如何解决?具体配置步骤如下:
- 已在manifest.json中勾选并配置了高德地图的AppKey;
- 已按照文档添加了必要的依赖;
- 尝试过清理项目并重新打包,但问题依旧。
请问是否有其他隐藏的配置项需要检查?或者是否有常见的遗漏步骤?谢谢!
2 回复
检查manifest.json中是否已勾选地图模块。若已勾选,尝试删除unpackage文件夹后重新打包。
在 UniApp 中配置了地图 SDK 但打包时提示“未添加 maps 模块”,通常是由于配置不完整或平台差异导致的。以下是详细解决方案:
1. 检查 manifest.json 配置
在 manifest.json 中确保已正确配置地图模块:
- 打开
manifest.json→ “App模块配置”。 - 勾选 “Maps(地图)” 模块,并填写对应平台的密钥(如高德地图、百度地图的 AppKey)。
- 示例配置(高德地图):
"App模块配置": { "Maps": { "amap": { "appkey_android": "你的高德Android AppKey", "appkey_ios": "你的高德iOS AppKey" } } }
2. 确认 SDK 配置正确性
- Android:在原生平台配置中(如
AndroidManifest.xml),检查是否添加了地图 SDK 所需的权限和 Meta-Data。
示例权限:<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> - iOS:在
manifest.json的 “iOS 设置” 中填写地图 SDK 的 AppKey,并确保在 Xcode 中配置了NSLocationWhenInUseUsageDescription权限描述。
3. 清理并重新打包
- 删除
unpackage、node_modules文件夹,运行npm install重新安装依赖。 - 在 HBuilderX 中选择 “发行” → “原生App-云打包”,勾选 “打包时压缩代码” 并重新提交。
4. 检查自定义基座
如果使用自定义基座调试:
- 重新制作自定义基座(需勾选 Maps 模块)。
- 调试时选择新基座,避免旧配置缓存。
5. 查看官方文档
- 访问 UniApp Maps 模块文档,核对配置步骤和密钥申请流程。
按以上步骤操作后,重新打包即可解决问题。如果仍报错,请检查密钥是否有效或尝试更换网络环境重试。

