From eac205e6ad9f49acff97e20b668fbeb95388c870 Mon Sep 17 00:00:00 2001
From: yanyilin <yanyilin@dcloud.io>
Date: Thu, 20 Jun 2024 19:35:00 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=85=BE=E8=AE=AF=E5=AE=9A?=
 =?UTF-8?q?=E4=BD=8D=E6=8F=92=E4=BB=B6=E8=AF=B4=E6=98=8E=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 uni_modules/uni-getLocation-tencent/readme.md | 72 +++++++++++++++----
 1 file changed, 57 insertions(+), 15 deletions(-)

diff --git a/uni_modules/uni-getLocation-tencent/readme.md b/uni_modules/uni-getLocation-tencent/readme.md
index 87169df..a8c1998 100644
--- a/uni_modules/uni-getLocation-tencent/readme.md
+++ b/uni_modules/uni-getLocation-tencent/readme.md
@@ -6,37 +6,79 @@
 
 [申请网址](https://lbs.qq.com/mobile/androidMapSDK/developerGuide/getKey)
 
-2. 配置key到插件中
+2. 配置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" />
 
-修改项目根目录下 AndroidManifest.xml
-`<meta-data android:name="TencentMapSDK" android:value="您申请的Key" />`
+  </application>
+
+</manifest>
+```
 
 3. 制作自定义基座运行后生效
+提交云端打包制作自定义基座后，再在HBuilderX中真机运行。
 
-## iOS 平台
+## iOS 平台（暂未支持）
 
-1.申请腾讯地图key
+1. 申请腾讯地图key
 
 [申请网址](https://lbs.qq.com/mobile/androidMapSDK/developerGuide/getKey)
 
-2.配置key到插件中
+2. 配置key到插件中
 
-将申请的key配置到插件目录下 app-ios -> info.plist 中 TencentLBSAPIKey 对应的值
+在项目根目录下添加 Info.plist 文件，详情参考：[iOS原生应用配置文件](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#infoplist)。将申请的 key 配置到项目 Info.plist 的 TencentLBSAPIKey 键值中，如下：
 
 ```xml
-<key>TencentLBSAPIKey</key>
-<string>您申请的Key</string>
+<?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>
 ```
 
-3.配置访问位置权限描述信息
+3. 配置访问位置权限描述信息
+在项目根目录下 Info.plist 文件中添加以下权限描述信息：
+```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>NSLocationAlwaysUsageDescription</key>
+    <string>后台运行期访问位置信息的许可描述</string>
+    <key>NSLocationWhenInUseUsageDescription</key>
+    <string>运行期访问位置信息的许可描述</string>
+    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+    <string>访问位置信息的许可描述</string>
+  </dict>
+</plist>
+```
+
+> 许可描述信息需根据应用实际业务情况准确描述，否则可能无法通过 AppStore 上架审核
+
+3. 制作自定义基座运行后生效
+提交云端打包制作自定义基座后，再在HBuilderX中真机运行。
+
+## 注意事项
+
+### 隐私合规问题
+此插件使用了腾讯位置服务SDK，调用定位API会采集个人隐私信息，在业务中请确保最终用户已经同意了App的隐私协议后再调用定位API，否则会因为隐私合规问题无法上架应用市场。
 
-选中工程中的 manifest.json -> App权限配置 -> iOS隐私信息访问的许可描述，分别配置下列权限描述信息
+App的隐私政策中需披露使用的三方SDK相关情况：
 
-- NSLocationAlwaysUsageDescription
-- NSLocationWhenInUseUsageDescription
-- NSLocationAlwaysAndWhenInUseUsageDescription
+- Android平台腾讯位置服务SDK [合规说明](https://lbs.qq.com/mobile/androidLocationSDK/androidLBSInfo)
+- iOS平台腾讯位置服务SDK [合规说明](https://lbs.qq.com/mobile/iosLocationSDK/iosLBSInfo)
 
-4.制作自定义基座运行后生效
 
 ## 相关开发文档
 
-- 
GitLab