tmui-cli 2.0.3 → 2.0.5

package/data/uni-app-x-docs/api/get-element-by-id.md

@@ -0,0 +1,55 @@
+<!-- ## uni.getElementById(id) @getelementbyid -->
+
+<!-- UTSAPIJSON.getElementById.name -->
+
+<!-- UTSAPIJSON.getElementById.description -->
+
+<!-- UTSAPIJSON.getElementById.compatibility -->
+
+**注意：** \
+uni是全局api，本方法获取的元素，是页面栈栈顶（不包括 dialogPage）的页面的元素，而不是执行本方法代码所在的页面的元素。\
+如果A页面被栈顶的B页面盖住，在A页面执行`uni.getElementById`会访问到B页面的元素。[详见](./README.md#toppage)
+
+如需寻找特定页面上的Element，应使用[UniPage对象的getElementById方法](../api/get-current-pages.md#getelementbyid)
+
+组合式 API 中可通过`getCurrentInstance()?.proxy?.$page`获取当前页面对象，这个方式可以获取到dialogPage页面。那么通用的、在当前页面获取UniElement的方式是：`getCurrentInstance()?.proxy?.$page.getElementById`
+
+另一种与页面绑定的获取元素的方式是定义与模板 ref 属性同名的 `ref` 变量。[详见](../tutorial/idref.md#ref方式)
+
+<!-- UTSAPIJSON.getElementById.param -->
+
+`3.93+` 支持泛型，可通过 `uni.getElementById<ElementType>(id)` 获取指定类型的元素。对于组件有自带方法的情况，通过泛型指定具体的元素类型，就可以调用该类型组件的专用方法，比如unicloud-db组件。\
+具体的组件元素类型，可查阅`组件文档/组件类型`获取。
+
+```html
+<template>
+	<view>
+		<text id='text' ref='textRef'>test text</text>
+	</view>
+</template>
+<script setup lang="uts">
+	const textRef = ref<UniTextElement | null>(null)
+
+	onReady(() => {
+		uni.navigateTo({
+			url: '/pages/test/test',
+			success() {
+				// 通过 ref 获取指定页面的元素
+				const textElement = textRef.value
+				// 通过 getElementById 获取指定页面的元素，此时当前页面为 test 页面，所以获取不到 #text 元素
+				const textNode = uni.getElementById('text')
+			}
+		})
+	})
+</script>
+```
+
+<!-- UTSAPIJSON.getElementById.returnValue -->
+
+<!-- UTSAPIJSON.getElementById.example -->
+
+<!-- UTSAPIJSON.getElementById.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-element.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移，请前往[getElementById](get-element-by-id.md)查看最新文档

package/data/uni-app-x-docs/api/get-file-system-manager.md

@@ -0,0 +1,62 @@
+<!-- ## uni.getFileSystemManager() @getfilesystemmanager -->
+
+<!-- UTSAPIJSON.getFileSystemManager.name -->
+
+<!-- UTSAPIJSON.getFileSystemManager.description -->
+
+<!-- UTSAPIJSON.getFileSystemManager.compatibility -->
+
+文件管理器对象，用于操作应用可访问的本地文件空间，在app平台是应用沙盒目录。
+
+可实现目录和文件的创建、删除、改名或改路径、遍历目录、获取文件信息、读写文件。
+
+注意：
+- `DCloud-`、`DCloud_`、`uni-`、`uni_`开头的目录和文件是保留目录。开发者自用的文件目录需避免使用这些前缀；
+
+- 读取文件API受具体设备内存大小限制，为了在老旧设备具备更好的兼容性，请避免一次性读取大文件的情况(建议文件大小不要超过16M)；
+
+- [ReadFileSuccessResult](./get-file-system-manager.md#readfilesuccessresult-values) 的data参数以前类型是string，Android平台4.31、iOS平台4.61起为了同时支持arraybuffer，类型改成了‘string | ArrayBuffer’，请在使用时手动as为指定类型；
+
+- app-ios平台4.11版本之前支持的api仅支持在uvue文件中使用文件管理器对象，uts插件中暂不支持； app-ios平台4.61版本后，所有api都支持在uts插件和uvue文件中使用，具体请查看兼容性；
+
+:::warning 注意
+
+##### 为了和微信小程序保持一致，`HBuilderX 4.71+` 涉及如下API调整
+
+| 相关 API                | 升级前                                                                                                                                                          | 升级后                                                                                                                                                                                                                                                                                                                                                 |
+|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `stat` / `statSync`    | - 返回路径是系统绝对路径                                                                                                                                   | - 返回路径是相对参数path的相对路径  <br> * 微信小程序规则：当 recursive 为 false 时，res.stats 是一个 Stats 对象。当 recursive 为 true 且 path 是一个目录的路径时，res.stats 是一个 Array，数组的每一项是一个对象，每个对象包含 path 和 stats  <br> * uniapp-x规则为避免返回值是联合类型，均返回数组，具体优化如下: <br> --- 当 path = 文件路径，返回数组，仅包含本身stats，返回 stats.path= "" <br> --- 当 path = 目录路径 && recursive = false，返回数组，仅包含本身stats，返回 stats.path= "/" <br> --- 当 path = 目录路径 && recursive = true，返回数组，包含本身stats和其递归子文件stats和目录文件stats                                                                                                                                                                                                                                                                                                                    |
+| `saveFile` / `saveFileSync` | **参数 `filePath`**  <br> - 传入nil：默认保存到 `uni.env.USER_DATA_PATH` 目录  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到filePath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br> <br> **返回路径 `savedFilePath`** <br> - 返回绝对路径   | **参数 `filePath`** <br> - 传入nil：默认保存到 `uni.env.CACHE_PATH/uni-store/` 目录 <br> - 传入错误路径：比如无权限的路径，返回 error  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存 <br> -传入filePath是目录路径且已存在，则返回错误码`1300021`   <br>  -传入filePath是文件路径且已存在，则覆盖写入  <br>- 判断传入路径尾部是否带斜线，如xxx/path、 xxx/path/，直接视为写入到path文件，如xxx/path/sub.txt 具体的是写入到具体的文件，path是目录 <br> <br> **返回路径 `savedFilePath`** <br> - 使用 `unifile://` 路径, 如果参数filePath=nil, savedFilePath= `unifile://cache/uni-store/xxx`; 否则savedFilePath= `unifile://cache/xxx`/`unifile://usr/xxx`/`unifile://sandbox/xxx` <br>  <br> **其他** <br> - 成功保存后删除临时文件 |
+| `getSavedFileList`     | 返回 `uni.env.USER_DATA_PATH` 目录中的文件列表, 均绝对路径                                                                                                                            | 返回 `unifile://cache/uni-store/`(uni.env.CACHE_PATH/uni-store/) 目录中的文件列表                                                                                                                                                                                                                                                            |
+| `rmdir` / `rmdirSync`  | iOS 无法删除空的 `uni.env.USER_DATA_PATH`、`uni.env.CACHE_PATH` 目录（系统限制）<br>Android/Harmony 可删除任意目录                                                         | **删除特殊目录，只删除子，保留本身**  <br>  - `uni.env.SANDBOX_PATH` <br> - `uni.env.CACHE_PATH` <br>  - `uni.env.USER_DATA_PATH` <br> - `uni.env.ANDROID_INTERNAL_SANDBOX_PATH` <br> <br> **其他创建的目录可以删除子和本身**  <br>                                                                                                                                                                                   |
+| `copyFile` / `copyFileSync` | **参数 `destPath`**  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到destPath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br>  | **参数 `destPath`** <br>  <br> - 传入错误路径：比如无权限的路径，返回 error  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存 <br> -传入destPath是目录路径且已存在，则返回错误码`1300021`   <br>  -传入destPath是文件路径且已存在，则覆盖写入  <br>- 判断传入路径尾部是否带斜线，如xxx/path、 xxx/path/，直接视为写入到path文件，如xxx/path/sub.txt 具体的是写入到具体的文件，path是目录 <br> <br> |
+
+
+##### iOS 无返回值同步api说明：
+1. 在uvue中不能依赖无返回值的同步api，因为iOS目前无法在uvue层面捕获失败，仅可用于调试，不能用于运行，try···catch无效，不会进入catch回调；
+2. 用于调试时：无返回值的同步api可以通过控制台看到具体的失败或成功console log；
+3. 相关api：writeFileSync、unlinkSync、truncateSync、removeSavedFile、renameSync、rmdirSync、mkdirSync、ftruncateSync、copyFileSync、closeSync、appendFileSync、accessSync
+
+:::
+
+
+
+<!-- UTSAPIJSON.getFileSystemManager.param -->
+
+<!-- UTSAPIJSON.getFileSystemManager.returnValue -->
+
+### 特殊说明
+
+- app-ios平台4.11版本之前支持的api仅支持在uvue文件中使用文件管理器对象，uts插件中暂不支持； 4.61版本后，所有api都支持在uts插件和uvue文件中使用，具体请查看兼容性
+
+- app-android平台API不支持代码包文件目录
+
+- app-android平台content:/\/ 路径文件是只读的
+
+<!-- UTSAPIJSON.getFileSystemManager.tutorial -->
+
+<!-- UTSAPIJSON.getFileSystemManager.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-image-info.md

@@ -0,0 +1,22 @@
+## uni.getImageInfo(options) @getImageInfo
+
+<!-- UTSAPIJSON.getImageInfo.description -->
+
+<!-- UTSAPIJSON.getImageInfo.compatibility -->
+
+<!-- UTSAPIJSON.getImageInfo.param -->
+
+<!-- UTSAPIJSON.getImageInfo.returnValue -->
+
+<!-- UTSAPIJSON.getImageInfo.tutorial -->
+
+### tips
+web平台读取图片的exif信息，需要引入三方库。考虑到影响web runtime的体积大小，这些三方库并没有内置在uni-app x中。
+
+目前比较主流的库是ExifReader，开发者可自行使用。
+
+<!-- UTSAPIJSON.getImageInfo.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-launch-options-sync.md

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

package/data/uni-app-x-docs/api/get-location.md

@@ -0,0 +1,210 @@
+<!-- ## uni.getLocation(options) @getlocation -->
+
+<!-- UTSAPIJSON.getLocation.name -->
+
+<!-- UTSAPIJSON.getLocation.description -->
+
+<!-- UTSAPIJSON.getLocation.compatibility -->
+
+<!-- UTSAPIJSON.getLocation.param -->
+
+<!-- UTSAPIJSON.getLocation.returnValue -->
+
+### 注意
+
+<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的中国地图上肯定是会偏差的
+
+<!-- UTSAPIJSON.getLocation.tutorial -->
+
+<!-- UTSAPIJSON.getLocation.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## 定位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/uni-app-x-docs/api/get-network-type.md

@@ -0,0 +1,23 @@
+<!-- ## uni.getNetworkType(options) @getnetworktype -->
+
+<!-- UTSAPIJSON.getNetworkType.name -->
+
+<!-- UTSAPIJSON.getNetworkType.description -->
+
+<!-- UTSAPIJSON.getNetworkType.compatibility -->
+
+<!-- UTSAPIJSON.getNetworkType.param -->
+
+<!-- UTSAPIJSON.getNetworkType.returnValue -->
+
+<!-- UTSAPIJSON.getNetworkType.example -->
+
+<!-- UTSAPIJSON.getNetworkType.tutorial -->
+
+### 注意
+
+<md-hperm permissions="ohos.permission.GET_NETWORK_INFO" />
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-performance.md

@@ -0,0 +1,17 @@
+## uni.getPerformance
+
+<!-- UTSAPIJSON.getPerformance.description -->
+
+<!-- UTSAPIJSON.getPerformance.compatibility -->
+
+<!-- UTSAPIJSON.getPerformance.param -->
+
+<!-- UTSAPIJSON.getPerformance.returnValue -->
+
+<!-- UTSAPIJSON.getPerformance.tutorial -->
+
+<!-- UTSAPIJSON.getPerformance.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-provider.md

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

package/data/uni-app-x-docs/api/get-recorder-manager.md

@@ -0,0 +1,51 @@
+<!-- ## uni.getRecorderManager() @getrecordermanager -->
+
+<!-- UTSAPIJSON.getRecorderManager.name -->
+
+<!-- UTSAPIJSON.getRecorderManager.description -->
+
+<!-- UTSAPIJSON.getRecorderManager.compatibility -->
+
+web平台可通过插件拉齐，[详见](https://ext.dcloud.net.cn/search?q=getRecorderManager&orderBy=Relevance&cat1=4&cat2=41&uni-app-platforms=&uni-app-x-platforms=)
+
+<!-- UTSAPIJSON.getRecorderManager.param -->
+
+<!-- UTSAPIJSON.getRecorderManager.returnValue -->
+
+::: tip 编码格式与采样率、码率的关系
+
+`Android、iOS、微信小程序`
+
+|采样率|编码码率|
+|:-|:-|
+|8000|16000 - 48000|
+|11025|16000 - 48000|
+|12000|24000 - 64000|
+|16000|24000 - 96000|
+|22050|32000 - 128000|
+|24000|32000 - 128000|
+|32000|48000 - 192000|
+|44100|64000 - 320000|
+|48000|64000 - 320000|
+
+`HarmonyOS`
+
+- aac 编码格式支持码率范围[32000 - 500000]
+- mp 编码格式支持码率范围[8000, 16000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000]
+  - 采样率使用16K以下时，对应码率范围为[8000 - 64000]
+  - 采样率使用16K~32K时对应的码率范围为[8000 - 160000]
+  - 采样率使用32K以上时对应的码率范围为[32000 - 320000]
+- wav 编码格式时，补丁码率 8000，采样率 64000，通道数 1
+:::
+
+<!-- UTSAPIJSON.getRecorderManager.example -->
+
+<!-- UTSAPIJSON.getRecorderManager.tutorial -->
+
+### 注意
+
+<md-hperm permissions="ohos.permission.MICROPHONE" />
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-system-info.md

@@ -0,0 +1,100 @@
+<!-- ## uni.getSystemInfo(options) @getsysteminfo -->
+
+<!-- UTSAPIJSON.getSystemInfo.name -->
+
+> HBuilderX4.13-alpha版本，uniPlatform属性在 app 平台临时调整过，由 `app` 改为 `app-android`、`app-ios`，HBuilderX 4.14-alpha版本已回撤此调整。如果开发者使用HBuilderX4.13-alpha版发布项目时使用了uni-id-common、uni-id、uni-id-pages或uni-id-pages-x，则需要分别升级到如下版本来兼容此次临时调整：uni-id@3.3.32、uni-id-common@1.0.17、uni-id-pages@1.1.20、uni-id-pages-x@1.1.1
+
+<!-- UTSAPIJSON.getSystemInfo.description -->
+
+<!-- UTSAPIJSON.getSystemInfo.compatibility -->
+
+uni-app 提供了异步(`uni.getSystemInfo`)和同步(`uni.getSystemInfoSync`)的2个API获取系统信息。
+
+按照运行环境层级排序，从底层向上，systemInfo有6个概念：
+- `device`：运行应用的设备，如iphone、huawei
+- `os`：设备的操作系统，如 ios、android、windows、mac、linux
+- `rom`：基于操作系统的定制，Android系统特有概念，如miui、鸿蒙
+- `host`：运行应用的宿主程序，即OS和应用之间的运行环境，如浏览器、微信等小程序宿主、集成uniMPSDK的App
+- `uni`：uni-app框架相关的信息，如uni-app框架的编译器版本、运行时版本
+- `app`：开发者的应用相关的信息，如应用名称、版本
+
+因本API涉及的信息越来越多，查询速度会逐渐变慢。由此拆解分出3个新API，[uni.getDeviceInfo](get-device-info.md)、[uni.getAppBaseInfo](get-app-base-info.md)、[uni.getWindowInfo](get-window-info.md)。新API包含的信息更多。
+
+微信小程序已经不推荐使用getSystemInfo，建议使用上述分拆的3个API。
+
+<!-- UTSAPIJSON.getSystemInfo.param -->
+
+<!-- UTSAPIJSON.getSystemInfo.returnValue -->
+
+::: warning 注意事项
+- appTheme如取值为`auto`，代表跟随系统。此时需查询osTheme获取当前到底是light还是dark。
+- 获取OAID、AndroidID等其他设备信息，[见插件市场](https://ext.dcloud.net.cn/search?q=oaid&orderBy=Relevance&uni-appx=1)
+- Android端的`windowHeight`属性是有时机的考量的，如果在全局作用域获取`windowHeight`，有可能当前Activity还未加载，所以导航栏和Tabbar的高度是不会计算进去的，稳妥起见，建议在`onReady`或者`onPageShow`内获取`windowheight`。
+- `windowHeight`属性是依赖于调用Api时栈顶Page的，比如延迟获取`windowHeight`，很可能页面已经切换了，这时候获取的高度是新的页面的。
+- 4.25开始，Android端安全区域top调整为手机状态栏高度
+- 自 5.11 起：
+  - web 平台在 macOS 上 platform 正确的返回 `mac` 值
+  - web 平台在 macOS 上获取到的 osVersion 固定为 `10.15.7`，这和系统版本不一致，这不是 bug，是浏览器 ua 的限制（从 macOS 11 开始，Apple 和 Google、Mozilla 等浏览器厂商达成共识，减少通过 UA 暴露精确的系统版本）
+  - web 平台运行在鸿蒙 PC 上时 osName 仅返回 `harmonyos`（不会返回 `ohos_pc`），可通过 deviceType 为 `pc` 区分
+  - 小程序平台统一标准：鸿蒙系统 osName、platform 为 `harmonyos`，手机、Tablet 和 PC 通过 deviceType 区分
+:::
+
+#### romName 返回值说明 @romname
+
+|值|解释|
+|:-|:-|
+|MIUI|小米|
+|EMUI|华为|
+|HarmonyOS|华为鸿蒙|
+|Magic OS|荣耀|
+|ColorOS|oppo|
+|Funtouch OS|vivo|
+|FLymeOS|魅族|
+|SmartisanOS|锤子|
+
+注意：不同rom的版本号规则不同，比如`MIUI`版本号是`V130`，而`HarmonyOS`的版本号是`2.0.0`
+
+#### hostName 返回值说明 @hostname
+
+|值|解释|
+|:-|:-|
+|WeChat|微信|
+|wxwork|微信企业版|
+|[百度宿主平台枚举值列表](https://smartprogram.baidu.com/docs/develop/api/device_sys/hostlist/)|百度|
+|alipay|支付宝|
+|amap|高德|
+|DINGTALK|钉钉|
+|UC|UC浏览器|
+|QUARK|夸克浏览器|
+|AK|阿里健康|
+|YK|优酷|
+|[抖音宿主平台枚举值列表](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/device/system-information/tt-get-system-info/#appname-%E8%AF%B4%E6%98%8E)|抖音系列|
+|qq|QQ|
+|KUAISHOU|快手|
+
+<!-- UTSAPIJSON.getSystemInfo.example -->
+
+<!-- UTSAPIJSON.getSystemInfo.tutorial -->
+
+<!-- ## uni.getSystemInfoSync() @getsysteminfosync -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.name -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.description -->
+
+本API是同步API，仅为上面异步API的同步形式，返回值内容没有区别。但由于本API涉及的查询内容较多，耗时长，一般情况下不推荐同步获取。\
+如果希望使用同步方式，推荐使用分拆后的API：[uni.getDeviceInfo](./get-device-info.md)、[uni.getWindowInfo](./get-window-info.md)、[uni.getAppBaseInfo](./get-app-base-info.md)。
+
+<!-- UTSAPIJSON.getSystemInfoSync.compatibility -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.param -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.returnValue -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.example -->
+
+<!-- UTSAPIJSON.getSystemInfoSync.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/get-system-setting.md

@@ -0,0 +1,24 @@
+<!-- ## uni.getSystemSetting() @getsystemsetting -->
+
+<!-- UTSAPIJSON.getSystemSetting.name -->
+
+<!-- UTSAPIJSON.getSystemSetting.description -->
+
+<!-- UTSAPIJSON.getSystemSetting.compatibility -->
+
+<!-- UTSAPIJSON.getSystemSetting.param -->
+
+<!-- UTSAPIJSON.getSystemSetting.returnValue -->
+
+## 注意事项
+
+- 如果出现 `bluetoothError`、`wifiError` 非空的情况就说明权限配置错误，需要根据 [文档](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions) 正确配置权限。
+
+<!-- UTSAPIJSON.getSystemSetting.example -->
+
+<!-- UTSAPIJSON.getSystemSetting.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+