From fbb44c6d8377bfb1ae8e1ccb3285003b6b07515e Mon Sep 17 00:00:00 2001
From: "taohebin@dcloud.io" <taohebin@dcloud.io>
Date: Thu, 17 Oct 2024 18:49:18 +0800
Subject: [PATCH] =?UTF-8?q?update=EF=BC=9Amap.md=20=E5=A2=9E=E5=8A=A0?=
 =?UTF-8?q?=E5=9C=B0=E5=9B=BEkey=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/collocation/manifest-modules.md | 53 ++++++++++++++++++++++++++++
 docs/component/map.md                | 11 ++++++
 2 files changed, 64 insertions(+)

diff --git a/docs/collocation/manifest-modules.md b/docs/collocation/manifest-modules.md
index 90e916a9..9f499289 100644
--- a/docs/collocation/manifest-modules.md
+++ b/docs/collocation/manifest-modules.md
@@ -350,3 +350,56 @@ app平台默认`启动界面`为白色（暗黑模式下为黑色），为了避
 ```
 
 
+## uni-map-tencent@uni-map-tencent
+
+在uni-app x客户端，uni-map-tencent是一个独立模块。需要开发者在 manifest.json 中手动配置，并提交云端打包后才能生效。
+
+使用 uni-map-tencent 模块需在 manifest.json 文件中添加如下配置：
+
+### 配置腾讯地图
+在 app -> distribute -> modules 下添加 uni-map-tencent 节点：
+```json
+	modules:{
+		"uni-map-tencent": {}
+	}
+```
+### 配置腾讯地图SDK的参数
+
+使用腾讯地图需到 [腾讯位置服务](https://lbs.qq.com/) 官网申请TencentLBSAPIKey，并配置到应用中。 
+
+#### iOS平台配置腾讯地图Key @uni-map-tencent-ios-key
+
+
+需在项目根目录下的 Info.plist配置腾讯地图的 TencentLBSAPIKey，然后 iOS 需要打自定义基座才可以生效。
+
+配置教程参考： [iOS原生配置文件Info.plist文档](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#infoplist)
+
+以下为配置示例：  
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+	<dict>
+		<key>TencentLBSAPIKey</key>
+		<string>腾讯位置服务官网申请的Key</string>
+	</dict>
+</plist>
+```
+
+#### Andoird平台配置腾讯地图Key @uni-map-tencent-android-key
+
+
+在项目根目录下添加 AndroidManifest.xml 文件，详情参考：[Android原生应用清单文件](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#%E5%BA%94%E7%94%A8%E6%B8%85%E5%8D%95%E6%96%87%E4%BB%B6-androidmanifest-xml)。将申请的 key 配置到项目 AndroidManifest.xml 的 application 节点中，如下：
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
+>
+  <application>
+
+    <!-- 将申请到的 key 配置在 android:value 属性中 -->
+    <meta-data android:name="TencentMapSDK" android:value="您申请的Key" />
+
+  </application>
+
+</manifest>
+```
\ No newline at end of file
diff --git a/docs/component/map.md b/docs/component/map.md
index 68380ead..738f592d 100644
--- a/docs/component/map.md
+++ b/docs/component/map.md
@@ -31,6 +31,17 @@
 
 GS粤（2023）1171号
 
+### Map Key配置
+
+app平台目前还没有可视化界面，需要在manifest的源码视图中配置。
+
+app需要在manifest.json文件中配置`uni-map-tencent`节点，[详见](../collocation/manifest-modules.md#uni-map-tencent)
+
+
+- iOS平台：需要在info.plist中配置对应的Key，参考[iOS平台配置腾讯地图Key](../collocation/manifest-modules.md#uni-map-tencent-ios-key)
+- Android平台：需要在AndroidManifest.xml配置Key， 参考[Andoird平台配置腾讯地图Key](../collocation/manifest-modules.md#uni-map-tencent-android-key)
+
+
 ## Tips
 - 在App和Web平台，没有在manifest中配置好图商的sdk key信息，将无法使用地图。某些图商的sdk key，区分Web、Android、iOS，注意别配混了。有些sdk key，会绑定校验web的域名或app的包名和签名证书摘要，都要匹配准确才能使用地图。
 - 谷歌地图仅支持 `wgs84` 坐标，中国的各个地图仅支持 `gcj02` 坐标，注意使用定位API获取的位置，需与map组件的图商需求一致，把 wgs84 的坐标显示在中国地图上会导致偏移。
-- 
GitLab