当前有一个鸿蒙原生项目,在这个项目中打开uniapp wgt小程序包,uniapp里面的map无法正常显示腾讯地图;在本地hbuildx直接运行地图却能显示出来;打包之后地图无法显示
1***@qq.com
- 发布:2026-02-06 13:46
- 更新:2026-02-06 14:12
- 阅读:15
欢迎到专业群( uni-app鸿蒙化技术交流群 ) 咨询,群中有相关专业的管理员和群友。
根据知识库内容,鸿蒙原生项目中运行uniapp wgt包时腾讯地图无法显示的问题,主要原因和解决方案如下:
问题原因
-
腾讯地图配置问题:鸿蒙平台目前仅支持腾讯地图,且地图是通过WebView加载的。由于页面使用的并非http协议,申请腾讯地图key时需要将域名白名单留空,否则地图无法加载。
-
manifest.json配置缺失:需要在项目的
manifest.json中正确配置腾讯地图的key,配置路径为:{ "app-plus": { "distribute": { "sdkConfigs": { "maps": { "qqmap": { "key": "你的腾讯地图key" } } } } } } -
平台差异:鸿蒙平台与App(安卓/iOS)是分开的,不能直接使用App的配置方式,需要单独适配鸿蒙。
解决方案
-
检查腾讯地图key配置:
- 确保在腾讯位置服务申请的key已正确配置到
manifest.json中。 - 域名白名单必须留空(知识库明确说明)。
- 确保在腾讯位置服务申请的key已正确配置到
-
使用可视化界面配置(HBuilderX 4.31+版本):
- 在HBuilderX中打开
manifest.json→ 选择“鸿蒙App配置” → 勾选“uni-map地图” → 选择腾讯地图并填写key。
- 在HBuilderX中打开
-
验证打包环境:
- 确保使用自定义基座进行真机调试(知识库提到真机运行需用自定义基座)。
- 删除
unpackage目录和harmony-configs中多余文件后重新打包。
-
替代方案:
- 如果腾讯地图仍有问题,可尝试使用华为花瓣地图插件,该插件已适配鸿蒙且免费。
注意事项
- 鸿蒙平台不支持
plus相关API(如plus.maps),需使用uni-app标准API(如uni.createMapContext)。 - 若问题仍存在,建议对比测试相同代码在安卓端是否正常,以排除钉钉小程序自身问题(知识库提到钉钉小程序需向钉钉社区反馈)。
如需进一步调试,建议提供控制台报错信息或尝试用空白项目验证配置是否正确。
内容为 AI 生成,仅供参考