tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/api/get-image-info.md

@@ -0,0 +1,143 @@
+## uni.getImageInfo(options) @getImageInfo
+
+获取图片信息
+
+### getImageInfo 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.18 | 4.25 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **GetImageInfoOptions** | 是 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| src | string.ImageURIString | 是 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 图片的路径，可以是相对路径，临时文件路径，存储文件路径，网络图片路径 |
+| success | (callback: [GetImageInfoSuccess](#getimageinfosuccess-values)) => void | 否 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (callback: [GetImageInfoFail](#getimageinfofail-values)) => void | 否 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (callback: any) => void | 否 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### GetImageInfoSuccess 的属性值 @getimageinfosuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| width | number | 是 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 图片宽度，单位px |
+| height | number | 是 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 图片高度，单位px |
+| path | string | 是 | 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 返回图片的本地路径 |
+| orientation | string | 否 | Web x / 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 返回图片的方向 |
+| 合法值 | 兼容性 |
+| :- |  :-: |
+| 'up' | Web x / 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） |
+| down |   |
+| left |   |
+| right |   |
+| up-mirrored |   |
+| down-mirrored |   |
+| left-mirrored |   |
+| right-mirrored |   |
+| type | string | 否 | Web x / 微信小程序 4.41 / Android 4.18 / iOS 4.25（部分支持，见上） | 返回图片的格式 |
+
+#### GetImageInfoFail 的属性值 @getimageinfofail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 描述 |
+| :- | :- |
+| 1101001 | 用户取消 |
+| 1101002 | urls至少包含一张图片地址 |
+| 1101003 | 文件不存在 |
+| 1101004 | 图片加载失败 |
+| 1101005 | 未获取权限 |
+| 1101006 | 图片或视频保存失败 |
+| 1101007 | 图片裁剪失败 |
+| 1101008 | 拍照或录像失败 |
+| 1101009 | 图片压缩失败 |
+| 1101010 | 其他错误 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.media.getImageInfo)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/media/image.html#getimageinfo)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.getImageInfo.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getImageInfo&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getImageInfo&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getImageInfo&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getImageInfo&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getImageInfo)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getImageInfo&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### tips
+web平台读取图片的exif信息，需要引入三方库。考虑到影响web runtime的体积大小，这些三方库并没有内置在uni-app x中。
+
+目前比较主流的库是ExifReader，开发者可自行使用。
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-image-info/get-image-info.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-image-info/get-image-info.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/get-image-info/get-image-info
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-image-info/get-image-info
+
+>示例
+```vue
+<template>
+  
+  <scroll-view style="flex:1">
+  
+    <page-head :title="title"></page-head>
+    <view class="uni-padding-wrap">
+      <view class="uni-title">
+        <text class="uni-subtitle-text">获取本地相对路径图片信息</text>
+      </view>
+      <image class="image" :src="relativeImagePath" mode="aspectFit"></image>
+      <text class="margin-top-10">{{absoluteImageInfo}}</text>
+      <view class="uni-title">
+        <text class="uni-subtitle-text">获取网络路径图片信息</text>
+      </view>
+      <image class="image" :src="remoteImagePath" mode="aspectFit"></image>
+      <text class="margin-top-10">{{remoteImageInfo}}</text>
+      <view class="uni-title">
+        <text class="uni-subtitle-text">获取本地绝对路径图片信息</text>
+      </view>
+      <image class="image" :src="absoluteImagePath" mode="aspectFit"></image>
+      <text class="margin-top-10">{{relativeImageInfo}}</text>
+      <view class="uni-btn-v">
+        <button type="primary" @click="chooseImage">拍摄照片或从相册中选择照片</button>
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .image {
+    align-self: center;
+  }
+
+  .margin-top-10 {
+    margin-top: 10px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

package/data/uniappx/api/get-launch-options-sync.md

@@ -0,0 +1,3 @@
+layout: SimpleLayout
+
+文档已迁移，请前往[launch](launch.md)查看最新文档

package/data/uniappx/api/get-location.md

@@ -0,0 +1,362 @@
+::: sourceCode
+## uni.getLocation(options) @getlocation
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-location
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-location
+
+获取当前的地理位置、速度
+
+### getLocation 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.9.0 | 4.11 | 5.0.0(11) | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **GetLocationOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| provider | string | 否 | system | Web x / 微信小程序 x / Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 定位服务提供商，通过 [uni.getProvider](https://doc.dcloud.net.cn/uni-app-x/api/provider.html) 获取,目前支持系统定位(system)、腾讯定位(tencent)<br/>腾讯定位是4.25版本后支持的；<br/>web端暂不支持provider机制； |
+| type | string | 否 | wgs84 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 默认为 wgs84 返回 gps 坐标，gcj02 返回可用于uni.openLocation的坐标，web端需配置定位 SDK 信息才可支持 gcj02； |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| wgs84 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11（部分支持，见上） | wgs84坐标系，系统定位默认取值wgs84，系统定位仅支持wgs84坐标系 |
+@@| gcj02 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11（部分支持，见上） | gcj02坐标系，腾讯定位默认取值gcj02，腾讯定位仅支持gcj02坐标系 |
+| altitude | boolean | 否 | false | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 |
+| geocode | boolean | 否 | false | Web x / 微信小程序 x / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 传入 true 会解析地址；<br/>使用系统定位时平台差异：iOS支持逆地理编码，Android、HarmonyOS 不支持； |
+| highAccuracyExpireTime | number | 否 | 3000 | Web x / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果 |
+| isHighAccuracy | boolean | 否 | false | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 开启高精度定位 |
+| success | (result: [GetLocationSuccess](#getlocationsuccess-values)) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 接口调用成功的回调函数 |
+| fail | (result: [GetLocationFail](#getlocationfail-values)) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### GetLocationSuccess 的属性值 @getlocationsuccess-values 
+
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 经度，范围为-180~180，负数表示西经 |
+| speed | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 速度，浮点数，单位m/s |
+| accuracy | number | 是 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 位置的精确度 |
+| altitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 高度，单位 m |
+| verticalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 垂直精度，单位 m（Android 无法获取，返回 0） |
+| horizontalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 水平精度，单位 m（Android、HarmonyOS 无法获取，返回 0） |
+| address | string | 否 | null | Web x / 微信小程序 x / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 地址信息 |
+
+#### GetLocationFail 的属性值 @getlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 注意
+
+<md-hperm :permissions="['ohos.permission.APPROXIMATELY_LOCATION', {name:'ohos.permission.LOCATION', desc:'仅当 isHighAccuracy 为 true 时申请该权限。'}]" />
+
+### 坐标系、系统定位、三方定位等概念
+
+wgs84坐标是国际GPS坐标系，gcj02是中国国内坐标系。同一个位置，2种坐标系数值不同。
+
+中国的地图厂商（如高德、腾讯、百度），仅能使用gcj02坐标。如果将wgs84坐标显示在中国地图上，就会发现偏移。
+
+同理，将gcj02坐标显示在google地图上，也会偏移。
+
+|						|Web					|Android			|iOS					|harmonyOS|微信小程序		|支付宝小程序	|抖音小程序						|
+|--					|--						|--						|--						|--				|--						|--						|--										|
+|wgs84			|系统定位			|系统定位			|系统定位			|系统定位	|内置定位			|内置定位			|内置定位							|
+|gcj02			|需三方SDK定位	|需三方SDK定位	|需三方SDK定位	|系统定位	|内置定位			|内置定位			|内置定位							|
+|逆地址解析	|需三方SDK定位	|需三方SDK定位	|系统定位			|系统定位	|需三方SDK定位	|内置定位			|内置定位iOS上有限支持	|
+
+逆地址解析：指传入坐标、返回地址信息（城市、街道等）。
+
+三方SDK定位是需要商业授权的，需要在地图厂商注册开发者账户、创建应用、申请key或secret信息，并且在发行时要把三方SDK打包进去。
+
+地图厂商的商业授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
+
+如果运行在微信浏览器中的Web应用，可以使用微信的jssdk的定位能力。此时开发者无需配置自己的key，不涉及商业授权。
+
+Android/iOS手机厂商默认都是wgs84坐标，也即入参type设为system或不填时，只能返回wgs84坐标。
+
+iOS设备的系统定位会返回逆地址解析，即geocode，将坐标转换为城市街道信息。Android设备的系统定位不支持逆地址解析。
+
+某些老型号国产Android Rom（常见于Android6以下）因gms阉割问题不支持系统定位，另部分国产Rom可能不支持高度信息。
+
+纯血鸿蒙手机的系统定位功能较全面，wgs84、gcj02坐标、逆地址解析都支持。
+
+在Android/iOS上，如不使用系统定位，而使用专业地图厂商provider，则可以使用gcj02坐标、逆地址解析geocode功能、以及稳定的所有设备均支持的定位服务。
+
+获取gcj02坐标，有2种方式：
+1. 使用国内地图厂商的SDK，也即使用provider，打包时需包含相应模块，并配置向地图厂商申请的key信息。
+2. 手机端获取系统定位，拿到wgs84坐标后，使用国内地图厂商的web接口，将wgs84坐标转换为gcj02坐标，web接口也有逆地址解析功能。
+
+不管通过哪种方式获取gcj02坐标，都需要向地图厂商缴纳商业授权费用。DCloud提供了优惠获取地图商业授权的方案，[详见](https://uniapp.dcloud.net.cn/tutorial/app-geolocation.html#lic)
+
+### 定位模块配置  
+定位功能使用 [provider机制](../api/provider.md) 实现，需在 `manifest.json` 中配置使用的定位服务。  
+
+使用三方定位，需要在地图厂商注册账户、创建应用、获取key。然后将key填写到 `manifest.json` 中。
+
+地图厂商在App端大多会校验包名和证书，请务必保证在地图厂商后台创建的应用，填写的包名、证书摘要，和实际运行的应用匹配，否则无法使用三方定位。
+
+web平台也分系统定位的SDK定位。系统定位只有wgs84坐标。三方SDK定位，在manifest的Web配置中寻找定位和地图。填入key后需注意校验，如果在地图厂商后台开启了域名、ip校验，那么如果Web运行或发行后的域名与地图厂商后台配置的不符，就无法获取定位。
+
+小程序平台的定位，是小程序引擎自身集成的定位SDK。比如微信小程序使用的是腾讯定位、支付宝小程序使用的是高德定位。由小程序平台免费给开发者提供。
+
+#### Android平台
+参考 [Android平台配置“uni-location（定位）”](../collocation/manifest-android.md#moduleslocation)  
+
+使用腾讯定位时，需配置对应的Key，参考[Android平台配置腾讯定位](../collocation/manifest-android.md#locationtencent)
+
+#### iOS平台
+参考 [iOS平台配置“uni-location（定位）”](../collocation/manifest-ios.md#moduleslocation)。
+
+使用腾讯定位时，需配置对应的Key，参考[iOS平台配置腾讯定位](../collocation/manifest-ios.md#locationtencent)。
+
+使用高精度定位，需要配置 `NSLocationTemporaryUsageDescriptionDictionary`，参考[](../collocation/manifest-ios.md#hightprecision)。
+
+如果应用需要后台定位能力，需在 `manifest.json` 中的 [后台运行能力](../collocation/manifest-ios.md#backgroundmodes) 配置 `location`。  
+
+#### 鸿蒙平台
+参考 [鸿蒙平台配置“uni-location（定位）”](../collocation/manifest-harmony#moduleslocation)。
+
+鸿蒙平台暂时仅支持系统定位，参考 [鸿蒙平台配置“系统定位”](../collocation/manifest-harmony.md#locationsystem)。
+
+### 权限@permission
+
+定位属于隐私权限，不管在浏览器、App还是小程序，都需要用户同意授权才可以获取。
+
+并且普通精度定位和高精度定位的权限也不同。
+
+获取手机端app是否拥有定位权限，请使用API [uni.getAppAuthorizeSetting](get-app-authorize-setting.md)
+
+除了用户未给app赋予定位权限，有的设备可能直接关闭了定位功能。此时可通过 [uni.getSystemSetting](get-system-setting.md) 来获取系统定位开关。
+
+HarmonyOS平台调用此 API 需要申请定位权限`ohos.permission.APPROXIMATELY_LOCATION`、`ohos.permission.LOCATION`，需自行在项目中配置权限。
+
+### 定位的原理和精度
+
+定位包括gps等卫星定位和基站wifi等网络定位。
+
+卫星定位的精度较高，但卫星定位要求手机设备与高空卫星之间没有阻挡，在阴天、室内，卫星定位会受影响。
+
+有时设备可连接的高空卫星数量较少，定位精度就会较差。如果连接不到任何卫星，定位会失败。
+
+而基于基站和wifi路由的网络定位，精度要被卫星定位差很多。网络定位的核心是手机要有网，无需顾忌和高空卫星之间的阻挡。网络定位一般只能知道设备在某个基站周围，但没有很精细的位置。
+
+- 当设备无法获取定位坐标时，需检查：
+	* 手机定位开关是否关闭
+	* web站或App是否被拒绝了定位权限
+	* 设备是否即没有卫星信号又没有网络
+	* 使用三方定位时，地图厂商的校验是否通过，web的域名、ip、签名；app的包名、证书摘要，这些信息在地图厂商配置的和实际运行的，是否一致
+	* 地图厂商后台的配额是否足够、权限是否开通
+
+- 当设备可以获取坐标，但在地图上有偏差时，需检查：
+	* 是否没有卫星信号，只有网络定位的话精度确实有误差
+	* 是否没有高精度定位权限
+	* 坐标系是否匹配，把wgs84坐标显示在只支持gcj02的中国地图上肯定是会偏差的
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.getLocation)
+- [参见uni-app相关文档](http://uniapp.dcloud.io/api/location/location?id=getlocation)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.getLocation.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getLocation&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getLocation&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getLocation&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getLocation&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getLocation)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getLocation&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-location/get-location.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-location/get-location.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/get-location/get-location
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-location/get-location
+
+>示例
+```vue
+<template>
+  
+  <scroll-view style="flex: 1;">
+  
+    <page-head :title="title"></page-head>
+    <view style="padding: 4px">
+      <text class="hello-text">
+        定位功能默认调用操作系统定位API实现。也支持三方SDK定位\n
+        部分老款Android手机因gms问题可能导致无法使用系统定位。\n
+        Web、Android、iOS平台，gcj国标、逆地理信息等功能需调用腾讯定位。</text>
+    </view>
+
+    <view class="uni-padding-wrap uni-common-mt">
+      
+      <view class="uni-list-cell-db"><text class="uni-list-cell-db-text">定位服务商provider(如系统定位，腾讯定位等)</text></view>
+      <view class="uni-list" style="margin-bottom: 20px">
+        <radio-group @change="radioChangePV">
+          <view class="uni-list-cell uni-list-cell-pd" v-for="(item, index) in providerList" :key="item.id"
+            :class="index < providerList.length - 1 ? 'uni-list-cell-line' : ''">
+            <radio :value="item.id" :checked="index === currentProvider" />
+            <text>{{ item.name }}</text>
+          </view>
+        </radio-group>
+      </view>
+      
+      <view class="uni-list-cell-db"><text class="uni-list-cell-db-text">定位类型</text></view>
+      <view class="uni-list">
+        <radio-group @change="radioChange">
+          <view class="uni-list-cell uni-list-cell-pd" v-for="(item, index) in items" :key="item.value"
+            :class="index < items.length - 1 ? 'uni-list-cell-line' : ''">
+            <radio :value="item.value" :checked="index === current" />
+            <text>{{ item.name }}</text>
+          </view>
+        </radio-group>
+      </view>
+      <boolean-data style="margin-top: 20px" :defaultValue="altitudeSelect" title="高度信息"
+        @change="altitudeChange"></boolean-data>
+      <boolean-data :defaultValue="isHighAccuracySelect" title="开启高精度定位"
+        @change="highAccuracySelectChange"></boolean-data>
+      <boolean-data :defaultValue="geocodeSelect" title="是否解析地址信息"
+        @change="geocodeChange"></boolean-data>
+      <view class="get-location-result">{{ exeRet }}</view>
+      <view class="uni-btn-v">
+        <button class="uni-btn" type="default" @tap="getLocationTap">
+          获取定位
+        </button>
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+<style>
+  .get-location-result {
+    /* #ifdef WEB || MP */
+    word-break: break-all;
+    /* #endif */
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## 定位provider对象描述 @providerdes
+
+UniLocationSystemProvider(系统定位)继承自[UniProvider](./provider.md#uniprovider)
+
+UniLocationTencentProvider(腾讯定位)继承自[UniProvider](./provider.md#uniprovider)
+
+## 自定义定位provider接入到uni API @customprovider
+
+背景：目前uni-app x引擎已经内置了系统定位、腾讯定位。但还有高德定位等其他定位SDK。
+
+以往这些SDK可以通过独立插件的方式集成到uni-app x中，但需要提供单独的API给开发者使用，无法使用uni.getLocation。
+
+uni-app x从4.25起，开放了App平台的provider自接入机制，让三方SDK可以以[provider](./provider.md)方式被开发者集成。
+
+开发一个UTS插件，对接uni规范化的API、错误信息描述等实现自己的定位插件，这样插件使用者就可以通过uni的标准API使用三方SDK。
+
+举个例子，用户想使用uni.getLocation()的方式调用高德定位，但是内置定位api不支持，
+
+那只需要按照下面四个步骤实现即可:
+
+第一步，新建一个UTS插件，在interface.uts 中定义接口，继承 UniLocationProvider，代码如下
+
+```ts
+export interface UniLocationAMapProvider extends UniLocationProvider{}
+```
+
+第二步，在app-android或者app-ios的index.uts中实现接口，代码如下
+
+```ts
+import { UniLocationAMapProvider } from '../interface';
+
+export class UniLocationAMapProviderImpl implements UniLocationAMapProvider{
+
+	override id : String = 'amap' //id必须有插件作者前缀，避免冲突，避免不同插件作者的插件id重名
+
+	override description : String = "高德地图"
+
+	override isAppExist : boolean | null = null
+
+	override getLocation(options : GetLocationOptions) {
+		//todo 具体逻辑，接收uni规范的入参，进行业务处理，返回uni规范的返回值。如遇到错误，按uni的规范返回错误码
+	}
+
+	constructor() {
+	}
+
+}
+```
+
+第三步，在manifest.json中配置
+
+```ts
+  "app": {
+    "distribute": {
+      /* android打包配置 */
+      "modules": {
+        "uni-location":{
+          "amap":{}
+        }
+      }
+    }
+  }
+```
+
+第四步，打包自定义基座然后运行
+
+通过以上步骤就可以实现自定义定位provider接入到uni API。
+
+由于uni-app x自带的腾讯定位，也是基于provider注册机制开发的，可参考[腾讯定位插件的实现源码](https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-location-tencent)
+
+App平台，腾讯定位SDK，除了本API封装的功能，还有一些其他功能。如开发者需要调用这些SDK的其他API，可以使用uts直接调用，同样参考上述源码。
+
+## 历史变更
+- Web平台本API调用了腾讯地图的免费gcj02坐标转换接口，该接口从2024年7月18日起被腾讯下线，导致老版本中本API无法使用。请立即升级到 `uni-app 4.24版`。
+
+升级后注意：
+1. manifest中配置好自己的地图厂商key
+2. 确保在地图厂商那里配额足够
+3. 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
+4. 确保自己的域名在地图厂商那里正确配置了域名白名单

package/data/uniappx/api/get-network-type.md

@@ -0,0 +1,96 @@
+::: sourceCode
+## uni.getNetworkType(options) @getnetworktype
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-getNetworkType
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-getNetworkType
+
+获取网络类型
+
+### getNetworkType 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.9 | 4.11 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **GetNetworkTypeOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 描述 |
+| :- | :- | :- | :- | :- |
+| success | (result: [GetNetworkTypeSuccess](#getnetworktypesuccess-values)) => void | 否 | null | 接口调用成功的回调函数 |
+| fail | (result: UniError) => void | 否 | null | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### GetNetworkTypeSuccess 的属性值 @getnetworktypesuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| networkType | string | 是 |   | 网络类型 |
+| hasSystemProxy | boolean | 否 | 微信小程序 4.41（部分支持，见上） | 需要基础库： `2.22.1`<br/><br/>设备是否使用了网络代理<br/> |
+| signalStrength | number | 否 | 微信小程序 4.41（部分支持，见上） | 信号强弱，单位 dbm<br/> |
+| weakNet | boolean | 否 | 微信小程序 4.41（部分支持，见上） | 需要基础库： `3.5.3`<br/><br/>是否处于弱网环境<br/> |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-network-type/get-network-type.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-network-type/get-network-type.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/get-network-type/get-network-type
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-network-type/get-network-type
+
+>示例
+```vue
+<template>
+  <page-head :title="data.title"></page-head>
+  <view class="uni-padding-wrap uni-common-mt">
+    <view class="uni-container">
+      <view class="uni-center">网络状态</view>
+      <view v-if="data.hasNetworkType == false">
+        <view class="uni-center uni-common-mt">未获取</view>
+        <view class="uni-center uni-common-mt">请点击下面按钮获取网络状态</view>
+      </view>
+      <view v-if="data.hasNetworkType == true">
+        <view class="uni-center uni-common-mt">{{data.networkType}}</view>
+      </view>
+    </view>
+    <view class="uni-btn-v uni-common-mt">
+      <button type="primary" @tap="getNetworkType">获取设备网络状态</button>
+      <button class="uni-common-mt" @tap="clear">清空</button>
+    </view>
+  </view>
+</template>
+
+
+<style>
+
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.network.getNetworkType)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/system/network.html#getnetworktype)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/network/wx.getNetworkType.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getNetworkType&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getNetworkType&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getNetworkType&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getNetworkType&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getNetworkType)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getNetworkType&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 注意
+
+<md-hperm permissions="ohos.permission.GET_NETWORK_INFO" />
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |