鸿蒙wgt包腾讯地图不显示

欢迎到专业群（ uni-app鸿蒙化技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据你的描述和知识库中的相关信息，这是一个典型的 wgt 包在宿主 App 中运行时，地图 Key 读取不到 的问题。

核心原因：wgt 包作为子应用运行时，地图组件读取的是宿主 App 的配置，而不是 wgt 包自身的配置。即使你在 wgt 包里配置了 key，在宿主环境中运行时也不会生效。

解决方案

1. 确认宿主 App 的配置位置（关键）

根据官方文档，鸿蒙平台的腾讯地图 key 配置位置取决于你的 HBuilderX 版本：

HBuilderX 4.31 及之后版本（推荐方式）：

• 打开宿主 App 的 manifest.json（不是 wgt 包的）
• 在可视化界面中找到 鸿蒙 App 配置 → uni-map 地图 → 勾选腾讯地图并填写 key

HBuilderX 4.31 之前版本：
在宿主 App 的 manifest.json 源码中配置：

{  
    "app-plus" : {  
        "distribute" : {  
            "sdkConfigs" : {  
                "maps" : {  
                    "qqmap" : {  
                        "key" : "你的腾讯地图key"  
                    }  
                }  
            }  
        }  
    }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 检查 module.json5 配置（如果上述方式无效）

如果 manifest.json 配置后仍然提示 "Map key not configured"，需要在宿主 App 的鸿蒙工程配置中添加：

在宿主 App 的 entry/src/main/module.json5 文件中：

{  
  "module": {  
    "metadata": [  
      {  
        "name": "TENCENT_MAP_KEY",  
        "value": "你的腾讯地图key"  
      }  
    ]  
  }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

3. 验证 Key 的有效性

• 确保腾讯地图 key 的域名白名单已留空（你已确认，再次检查）
• 确保 key 没有过期，且配额充足
• 确保 key 是腾讯位置服务（lbs.qq.com）申请的，而不是其他腾讯云服务

4. 重新打包宿主 App

重要：修改宿主 App 的配置后，必须重新打包宿主 App，wgt 包才能读取到新的配置。只更新 wgt 包是无效的。

排查步骤总结

1. 确认配置位置：key 必须配置在宿主 App 中，而不是 wgt 包
2. 检查配置路径：根据你的 HBuilderX 版本选择正确的配置方式（manifest.json 或 module.json5）
3. 重新打包宿主：修改宿主配置后，重新打包并安装宿主 App
4. 清除缓存：如果之前安装过，尝试卸载后重新安装宿主 App

参考文档

• uni-app 鸿蒙地图配置说明
• 腾讯地图服务商说明

如果按照上述步骤操作后仍然无法显示，建议检查宿主 App 的日志，确认是否还有其他配置缺失（如定位权限等）。