tmui-cli 2.0.2 → 2.0.4

package/data/uni-app-x-docs/api/ext.md

@@ -0,0 +1,61 @@
+# 其它api
+
+在App平台，与uni-app相比，uni-app x多了不少API，但也还有一些API没有，需要通过插件市场的插件替代。
+
+## uni api替代@uni
+- 谷歌登录：[见插件市场](https://ext.dcloud.net.cn/search?q=%E8%B0%B7%E6%AD%8C%E7%99%BB%E5%BD%95&orderBy=Relevance&uni-appx=1)
+- 谷歌支付：[见插件市场](https://ext.dcloud.net.cn/search?q=%E8%B0%B7%E6%AD%8C%E6%94%AF%E4%BB%98&orderBy=Relevance&uni-appx=1)
+- 蓝牙：Bluetooth。[见插件市场](https://ext.dcloud.net.cn/search?q=%E8%93%9D%E7%89%99&orderBy=Relevance&cat1=8&cat2=81)
+- NFC：[见插件市场](https://ext.dcloud.net.cn/search?q=nfc&orderBy=Relevance&cat1=8&cat2=81)
+
+## plus api替代@plus
+uni-app x 中不再支持plus和weex的API。对于plus api中一些常用的api，在uni-app x中进行了替换增补。
+- plus.runtime.quit => [uni.exit](./exit.md)
+- plus.runtime.install => [uni.installApk](./install-apk.md)
+- plus.zip => [uni.getFileSystemManager](./get-file-system-manager.md) 中有一批 zip 相关的api。
+
+一些plus api在插件市场有替代：
+- plus.sqlite [插件市场](https://ext.dcloud.net.cn/search?q=sqlite&uni-appx=1)
+- plus.speech [插件市场](https://ext.dcloud.net.cn/search?q=%E6%96%87%E5%AD%97%E8%BD%AC%E8%AF%AD%E9%9F%B3&orderBy=Relevance&uni-appx=1)
+- plus.runtime.openURL [插件市场](https://ext.dcloud.net.cn/plugin?id=17828)
+
+插件市场有一些抹平plus写法的插件，自定义了一个plus对象，方法内部再调用uni或uts的api，以兼容历史的plus写法，[详见](https://ext.dcloud.net.cn/search?q=plus&orderBy=Relevance&uni-appx=1)
+
+## kotlin代码转uts简易指南@kt2uts
+
+扩展原生API在uni-app x中很简单，以上面的打开schema代码为例。
+
+1. 打开一个靠谱的ai，询问："kotlin中打开系统浏览器的代码"，得到如下代码：
+```kotlin
+import android.content.Intent  
+import android.net.Uri  
+  
+fun openSystemBrowser(url: String) {  
+    val intent = Intent(Intent.ACTION_VIEW, Uri.parse(url))  
+    startActivity(intent)  
+}
+```
+
+2. 然后新建一个uni_modules，选uts插件，定义下如何在你的代码中调用这个原生能力，然后通过uts混编的方式调用kt代码，或者通过ai转换为uts代码。
+```ts
+import Intent from 'android.content.Intent';
+import Uri from 'android.net.Uri';
+
+function openSystemBrowser(url: string): void {  
+  const intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));  
+  startActivity(intent);  
+}
+```
+
+这里注意几个差别：
+- kotlin中import包，是`import android.content.Intent`，而uts是`import Intent from 'android.content.Intent'`。import后面需要跟名字，from后面需要引号括起来。
+- kotlin定义一个函数是`fun`，而uts是`function`
+- kotlin中定义一个常量是val，而uts是const；kotlin的变量定义是var，而uts推荐使用let。
+- uts中实例化对象需要使用new关键字。
+- kotlin中是自己创建activity、自己管理。而uts中activity已经被uni-app x框架创建好了，要获取当前activity，有专门的api，`const context = UTSAndroid.getUniActivity()!`
+
+一般推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，只需要告诉uni-agent你的需求，定义好调用方式、说明要调用的原生能力，uni-agent就可以给你写出原生插件。
+
+官方的uni api，都是uts插件，这里面很多例子可以参考：[https://gitcode.com/dcloud/uni-api](https://gitcode.com/dcloud/uni-api)
+
+完整的uts插件开发指南，[详见](../plugin/uts-plugin.md)

package/data/uni-app-x-docs/api/facial-recognition-meta-info.md

@@ -0,0 +1,47 @@
+# uni实人认证
+
+uni实人认证是DCloud与合作伙伴共同推出的金融级实人认证服务，通过对比人脸、活体检测、姓名和身份证号码，来确认用户身份的有效性。
+
+实人认证涉及业务开通和付费，涉及客户端和服务器交互，有较多文档：
+1. 业务介绍：介绍业务流程、开通和付费。[详见](https://doc.dcloud.net.cn/uniCloud/frv/intro.html)
+2. 客户端API，即本文
+3. 服务器API，[详见](https://doc.dcloud.net.cn/uniCloud/frv/dev.html)
+
+uni-id-pages，已经内置实人认证，从云端到客户端均已开发好并开源，推荐使用。[详情](https://doc.dcloud.net.cn/uniCloud/uni-id/app-x.html)
+
+## uni.getFacialRecognitionMetaInfo() @getfacialrecognitionmetainfo
+
+<!-- UTSAPIJSON.getFacialRecognitionMetaInfo.description -->
+
+<!-- UTSAPIJSON.getFacialRecognitionMetaInfo.compatibility -->
+
+<!-- UTSAPIJSON.getFacialRecognitionMetaInfo.param -->
+
+<!-- UTSAPIJSON.getFacialRecognitionMetaInfo.example -->
+
+<!-- UTSAPIJSON.getFacialRecognitionMetaInfo.tutorial -->
+
+## uni.startFacialRecognitionVerify(faceStyle) @startfacialrecognitionverify
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.description -->
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.compatibility -->
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.param -->
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.returnValue -->
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.example -->
+
+<!-- UTSAPIJSON.startFacialRecognitionVerify.tutorial -->
+
+<!-- UTSAPIJSON.facialRecognitionMetaInfo.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## Tips
+* 获取手机端app是否拥有摄像头权限，请使用API [uni.getAppAuthorizeSetting](get-app-authorize-setting.md)
+* 从HBuilderX 3.99起，标准基座真机运行可直接体验实人认证，涉及费用扣除开发者的费用。无需自定义基座。
+* Android 实人认证支持的CPU类型为`armeabi-v7a`和`arm64-v8a`，其他CPU类型设备调用`uni.getFacialRecognitionMetaInfo()`会返回空字符串，调用`uni.startFacialRecognitionVerify()`会触发错误码为`10002`的错误回调。

package/data/uni-app-x-docs/api/facial-recognition-verify.md

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

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

@@ -0,0 +1,224 @@
+# 文件系统
+
+>  [uni.env 参见](./env.md)
+
+除了web，在App和小程序上都有访问文件系统的能力。
+
+开发者可以通过API [uni.getFileSystemManager](get-file-system-manager.md)获取到文件系统管理器，进一步对文件目录进行增删改查。
+```uts
+const fs = uni.getFileSystemManager()
+```
+
+uni-app x框架因为需要也会产生一些文件在CACHE目录中，比如拍照、截图等API。下文会介绍框架已经使用了哪些目录和文件。
+
+注意：`DCloud-`、`DCloud_`、`uni-`、`uni_`开头的目录和文件是保留目录。开发者自用的文件目录需避免使用这些前缀。
+
+文件主要分两大类，代码包和本地磁盘文件：
+- 代码包文件：指 uni-app x 项目目录中添加的文件，比如static目录下的文件。Android发行后存放在assets目录下。只读。
+	+ assets
+	+ hybrid
+	+ static
+	+ uni_modules
+- 本地磁盘文件：指应用在手机端运行时可访问的磁盘文件。又分以下目录：
+	+ 应用外置沙盒目录（`uni.env.SANDBOX_PATH`）：手机应用的沙盒目录，其中包括缓存文件目录和用户文件目录。在文件管理器中可看到。
+		* 缓存文件目录（`uni.env.CACHE_PATH`）：手机运行过程中框架保存缓存文件的目录（cache），系统空间不足时会被自动清理掉
+		* 用户文件目录（`uni.env.USER_DATA_PATH`）：提供给开发者操作的本地文件目录（files）
+	+ 应用内置沙盒目录（`uni.env.ANDROID_INTERNAL_SANDBOX_PATH`）：存放框架的网络缓存（如网络图片、视频、web-view的缓存）、storage。
+	+ 沙盒外目录
+
+**uts插件开发**  
+在uts插件开发中调用系统 API 时可能需要平台相关的绝对路径，可以通过以下方式进行转换：  
+- app-android平台  
+  [UTSAndroid.convert2AbsFullPath](../uts/utsandroid.md#convert2absfullpath-path-string)  
+- app-ios平台  
+  [UTSiOS.convert2AbsFullPath](../uts/utsios.md#convert2absfullpath)  
+
+## 代码包文件@package
+
+代码包文件，是源码工程中的静态资源文件，由编译器打包到发行包（如apk）中。全平台都如此。
+
+uni-app x的应用在安装后，代码包文件有4个目录：
+- assets
+- hybrid
+- static
+- uni_modules
+
+这些目录的来源和作用，[详见](../compiler/README.md#static)
+
+assets目录下文件有随机数的存在，很难使用FileSystemManager访问；hybrid下的文件用于web-view组件。\
+所以通过FileSystemManager访问较多的是static目录。
+
+FileSystemManager访问代码包文件时，直接写文件路径，如：/static/uni.png、/uni_modules/xxx/static/clear.png。
+
+**示例**
+
+假设static目录下有如下文件："/static/list-mock/mock.json"，要copy到沙盒的files目录（该目录的介绍详见下一章节），可使用如下代码：
+```ts
+let fileManager = uni.getFileSystemManager()
+
+fileManager.copyFile({
+  srcPath: "/static/list-mock/mock.json",
+  destPath: `${uni.env.USER_DATA_PATH}/mock.json`,
+  success: function (res : FileManagerSuccessResult) {
+    console.log('success', res)
+  },
+  fail: function (res : UniError) {
+    console.log('fail', res)
+  },
+  complete: function (res : any) {
+    console.log("complete", res)
+  }
+} as CopyFileOptions)
+```
+
+> 注意：代码包文件只读，无法动态修改或删除。修改代码包文件一般会copy到沙盒目录后再修改。
+
+### 真机运行时代码包文件目录 @packageDebug  
+
+**注意：真机运行时代码包文件目录有特殊处理**  
+
+Android/iOS端真机运行期间，为了实现动态性，将代码包文件同步到`应用沙盒目录`下的特定目录：
+- Android平台
+	保存在应用专属存储空间的外置存储空间根目录下的apps目录，通常为“/sdcard/Android/data/%应用包名%/apps/%应用AppID%/www/”
+- iOS平台
+	保存在应用沙盒目录下的Documents/uni-app-x目录，通常为“/%应用沙盒目录%/Documents/uni-app-x/apps/%应用AppID%/www/”
+
+请开发者不要使用FileManage API操作应用代码包文件。虽然真机运行时可以访问，但打包后代码包不在沙盒中，无法再访问。
+
+## 本地磁盘文件@disk
+本地磁盘文件分沙盒内和沙盒外。
+
+沙盒内是指应用安装到设备（通常指手机）后，系统会提供一块独立的文件存储区域。以应用维度隔离，即在同一台设备，不同应用间的本地磁盘文件不能直接相互访问。
+
+而沙盒目录，又分内置和外置。外置可以在Android手机自带的系统文件管理器里看到，并且用户可以改动。内置的保护级别更高，无法在系统文件管理器中看到。
+
+本地磁盘文件路径格式为：
+```
+{{协议名}}://文件路径
+```
+> App端，协议名为"unifile"，不应该直接拼写协议名路径访问本地磁盘文件，推荐使用uni.env中的目录常量获取本地磁盘文件目录的路径。
+
+**通过uni.env的目录常量访问本地磁盘文件**
+
+uni-app x提供了一批uni.env常量，来指定不同的可访问目录。
+
+以下示例为在`用户数据目录`下写入hello.txt文件：
+```ts
+const fs = uni.getFileSystemManager();
+fs.writeFile({
+	filePath: `${uni.env.USER_DATA_PATH}/hello.txt`,
+	data: 'hello uni-app x!',
+	encoding: 'utf-8'
+} as WriteFileOptions);
+```
+
+
+### 外置应用沙盒目录@sandbox
+目录常量名称：`uni.env.SANDBOX_PATH`
+
+App端专有目录，为应用沙盒根目录，其下包含了`缓存文件目录`和`用户数据目录`，真机运行时还包括应用资源目录。此目录在不同平台差异较大，不建议直接使用此目录，建议直接按需使用下方的缓存目录`uni.env.CACHE_PATH`和数据目录`uni.env.USER_DATA_PATH`。
+
+沙盒实际保存的目录在不同平台存在差异：
+- Android平台
+	应用专属存储空间的外置存储空间根目录，通常为“/Android/data/%应用包名%/”，其下的cache目录为`缓存文件目录`，其下的files目录为`用户数据目录`
+- iOS平台
+	应用沙盒虚拟目录，其下包括Documents、Library、tmp目录，此目录只可读，不可创建其它目录
+
+本目录可以在Android系统的文件管理器中看到。用户在文件管理器中可以查阅删改。
+
+App和小程序上都给应用提供了文件沙盒系统（SANDBOX）。即App或小程序可以访问自己的沙盒文件系统，不同的应用之间是隔离的，应用默认无法访问自己沙盒之外的文件系统。
+
+较早期的Android没有外部文件访问权限，目前主流的Android均已补充这块的权限，并且该权限管理越来越严格。
+
+所以一般应用可以自由的访问自己的沙盒文件系统。想访问自己沙盒之外的公共目录，App需要额外申请权限。
+
+当然如果手机被root，沙盒机制也会失效，将可以被其他app操作。
+
+应用沙盒目录SANDBOX下，一般有3类概念：
+1. 数据文件USER_DATA：存放应用启动后创造、下载的，用户所需要的数据。需要应用自己提供清理方式。
+2. 缓存CACHE：不重要的文件，当磁盘空间不足时，OS会清除该目录以回收磁盘空间。
+3. 临时文件TEMP：在鸿蒙系统和小程序上有这个概念，随时都会被清理，基本上就是一次性使用。
+
+在Android的设置->应用详情中，可以看到应用所占空间有3部分：应用本身、数据文件、缓存文件。
+当用户点击清空缓存时，即清空了CACHE目录。当用户点击了清空用户数据后，即清空了USER_DATA目录，应用即回到了刚安装的状态。
+
+#### 缓存目录cache@cache
+目录常量名称：`uni.env.CACHE_PATH`
+
+缓存文件目录，保存应用运行过程中产生的缓存文件。操作系统或小程序宿主会在存储空间不足时清除缓存文件，因此不要在此目录中保存应用的关键业务数据文件。
+
+实际保存的目录在不同平台存在差异：
+- Android平台
+	应用专属存储空间的外置存储空间根目录下的cache目录，通常为“/Android/data/%应用包名%/cache/”
+- iOS平台
+	应用沙盒目录下的Library/Caches目录
+
+uni-app x的部分内置API，在App平台会产生临时文件会放置在本cache目录，如：
+- uni.downloadFile下载的文件
+- uni.chooseImage、uni.chooseVideo、uni.chooseMedia(iOS平台)拍摄或选择的相册文件
+- uni.compressImage、uni.compressVideo压缩后的文件
+- uni.getImageInfo网络图片下载到本地的文件
+- uni.createInnerAudioContext缓存的网络audio文件
+- uni.getBackgroundAudioManager缓存的网络audio文件
+- uni.getRecorderManager录音存储的audio文件
+- dom element的截图API
+
+从HBuilderX 3.99起，定义如下缓存目录的使用规范。
+
+在`uni.env.CACHE_PATH`目录下，uni官方使用了如下目录，请开发者避免使用uni-开头的目录：
+- uni-download // uni.downloadFile的默认下载地址 （在HBuilderX 3.98时曾使用目录uniDownloads，从3.99起调整为uni-download）
+- uni-media // uni.chooseImage、uni.chooseVideo拍摄或选择的相册文件，uni.compressImage、uni.compressVideo压缩后的文件，uni.getImageInfo网络图片下载到本地的文件
+  * iOS平台uni.chooseMedia拍摄或选择的相册文件
+- uni-snapshot // element takeSnapShot截图APi存储的路径
+- uni-audio //存放网络缓存音频文件
+- uni-recorder //存放录音文件
+- uni-store // uni.getFileSystemManager().saveFile/saveFileSync 默认保存路径
+- uni-crash //存放崩溃日志
+	* java //java、kotlin层崩溃日志
+	* c //c、so库崩溃日志
+
+App平台上述API在调用后产生在cache目录的文件，需要自行判断后续是否还要使用。\n
+如需要使用，则需调用 `uni.getFileSystemManager` 的API把要使用的文件挪到用户数据目录（`USER_DATA_PATH`）下；\n
+如不再使用，最好是调用API把文件删掉。如果不删，那就是等着OS的磁盘清理工具来回收。
+
+#### 用户数据目录files@files
+目录常量名称：`uni.env.USER_DATA_PATH`
+
+App端和小程序提供了用户文件目录，用于开发者在应用运行期读写文件，此目录不会被操作系统自动清除，由开发者自主管理。
+
+实际保存的目录在不同平台存在差异：
+- Android平台
+	应用专属存储空间的外置存储空间根目录下的files目录，通常为“/sdcard/Android/data/%应用包名%/files/”
+- iOS平台
+	应用沙盒目录下的Documents目录  
+	此目录下保留 uni-app-x 子目录用于真机运行时使用，避免业务代码操作此目录，[详情](#packagedebug)  
+
+### 内置应用沙盒目录@internalsandbox
+
+目录常量名称：`uni.env.ANDROID_INTERNAL_SANDBOX_PATH`
+
+仅Android支持。该目录无法在手机自带的文件管理器中查看，用户无法修改。除非手机被root。
+
+uni-app x框架的一些内置组件和API会涉及缓存文件，存放到本目录，如：
+- image/video组件的网络图片视频缓存
+- web-view组件的缓存
+
+FileSystemManager目前对内置应用沙盒目录为只读。如需写入，需开发uts插件。
+
+### 沙盒外目录
+FileSystemManager API暂不支持访问沙盒外目录。
+
+保存图片和视频到相册，有专门的API：[uni.saveImageToPhotosAlbum](./save-image-to-photos-album.md)、[uni.saveVideoToPhotosAlbum](./save-video-to-photos-album.md)、
+
+如还想访问以上API不支持的目录，需开发uts插件。
+
+## 常见问题  
+### 文件路径中字母大小写敏感问题@casesensitive  
+- Android平台  
+	+ 本地磁盘文件路径中字母大小写不敏感，真机运行时会将应用资源同步到设备的SD卡中，此时路径中字母大小写不敏感  
+	+ 代码包文件中的文件打包后到apk中后，由于Android系统的要求是大小写敏感，因此发布为后应用资源路径中的字母大小写敏感  
+- iOS平台  
+	+ iOS真机文件路径中字母大小写敏感  
+	+ iOS模拟器文件路径中字母大小写不敏感  
+
+> 为了有更好的兼容性，建议处理文件路径时按大小写敏感原则处理  

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

@@ -0,0 +1,23 @@
+<!-- ## uni.getAccessibilityInfo() @getaccessibilityinfo -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.name -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.description -->
+
+如果手机启用了辅助应用功能，可以识别有哪些辅助应用的服务。辅助应用有时会被用于灰黑产实施自动点击，本API有助于开发者识别当前运行环境。
+
+<!-- UTSAPIJSON.getAccessibilityInfo.compatibility -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.param -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.returnValue -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.example -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.tutorial -->
+
+<!-- UTSAPIJSON.getAccessibilityInfo.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,29 @@
+<!-- ## uni.getAppAuthorizeSetting() @getappauthorizesetting -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.name -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.description -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.compatibility -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.param -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.returnValue -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.example -->
+
+<!-- UTSAPIJSON.getAppAuthorizeSetting.tutorial -->
+
+如需跳转到权限设置界面，参考[uni.openAppAuthorizeSetting](./open-app-authorize-setting.md)
+
+注意：
+
+Android和iOS的权限设计并不相同，比如iOS有相册权限，而Android不同版本的相册权限逻辑不一样，低版本没有单独的相册权限，归入本地文件读写权限（非沙盒文件），高版本又独立出来。还有很多权限只有一个平台才有。
+
+权限的命名各平台也不相同，所以本API返回的权限名称不是Android和iOS原始的命名，只是一个示意名称。
+
+本API只返回部分权限，Android平台的权限非常多，在Android上获取所有未授权权限，另见[UTSAndroid.getSystemPermissionDenied](../uts/utsandroid.md#getsystempermissiondenied)，这里的权限名称就是Android原始的权限名称了。
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,32 @@
+<!-- ## uni.getAppBaseInfo(options?) @getappbaseinfo -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.name -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.description -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.compatibility -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.param -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.returnValue -->
+
+#### appTheme @apptheme
+获取应用的主题配置信息，仅app平台支持。
+appTheme返回值为`auto`，代表跟随系统。此时需通过[getSystemInfo](./get-system-info.md)或[getDeviceInfo](./get-device-info.md)查询osTheme获取当前到底是light还是dark。
+
+#### hostTheme
+在浏览器中，hostTheme可能是os的Theme而不是浏览器的外观。这取决于浏览器的实现。
+
+#### channel @channel
+获取应用的渠道信息，仅app-android平台支持渠道包。
+- 云打包时需在“App打包”界面中配置，详情参考[配置渠道包](../tutorial/app-package.md#channel)。
+- 离线打包时需在原生工程中配置，详情参考[Android平台配置应用渠道包](../native/use/android.md#androidmanifest)
+
+
+<!-- UTSAPIJSON.getAppBaseInfo.example -->
+
+<!-- UTSAPIJSON.getAppBaseInfo.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,28 @@
+## getApp() @getapp
+
+<!-- UTSAPIJSON.getApp.description -->
+
+- HBuilderX 4.31 以前，`getApp()` 返回的是 Vue 实例，且无法在 uts 插件中使用。
+- 从 HBuilderX 4.31+ 起，新增 `UniApp` 对象用于管理 app，`getApp()` 返回 `UniApp` 对象；Vue 实例则作为 `UniApp` 对象的 `vm` 属性提供。
+- `getApp()` 只能在 `script` 中调用，不能直接在模板中使用。
+
+`UniApp` 对象可同时在 uts 插件和 uvue 页面中使用，但 `vm` 属性及其相关的 `globalData` 仍然只能在 uvue 页面中使用。
+
+<!-- UTSAPIJSON.getApp.compatibility -->
+
+<!-- UTSAPIJSON.getApp.param -->
+
+<!-- UTSAPIJSON.getApp.returnValue -->
+
+<!-- UTSAPIJSON.getApp.example -->
+
+### 全局方法调用@appmethods
+以上示例，getApp()后调用了app.uvue里定义的increasetLifeCycleNum方法。app.uvue的源码[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/App.uvue)
+
+**调整** ：HBuilderX 4.31 `getApp()` 返回值调整为 `UniApp` 类型，调用 `App.uvue` 中定义的全局方法，需要由 `getApp().methodName()` 调整为 `getApp().vm?.methodName()`。
+
+<!-- UTSAPIJSON.getApp.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,54 @@
+<!-- ## uni.getBackgroundAudioManager() @getbackgroundaudiomanager -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.name -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.description -->
+
+背景音频，常见于音乐播放、听书等场景。在页面关闭、应用切换到后台时，仍然可以继续播放，并且可以在手机的通知栏里进行播放、暂停、拖进度等操作。
+
+**支持格式**
+
+|格式	|Android|iOS|HarmonyOS|
+|:-		|:-			|:-	|:-	|
+|mp3	|√			|√	|√|
+|mp4	|√			|√	|x|
+|m4a	|√			|√	|√|
+|wav	|√			|√	|√|
+|aac	|√			|√	|√|
+|flac	|√			|√	|x|
+|aiff	|x			|√	|x|
+|amr	|√			|x	|√|
+|ape	|√			|x	|x|
+|caf	|x			|√	|x|
+|ogg	|√			|x	|√|
+|wma	|√			|x	|x|
+
+- web平台的支持取决于浏览器的实现，一般浏览器上述音频格式均支持
+- 小程序平台支持的格式见各家小程序的文档
+- HarmonyOS 平台使用 [AudioPlayer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-media#audioplayerdeprecated?ha_source=Dcloud&ha_sourceId=89000448) 实现
+
+**缓存说明**
+
+- App-Android 平台播放的网络音频，默认会缓存到应用cache目录的uni-audio/background文件夹下，默认大小为100M，超过后会根据最近最少使用的缓存算法自动进行清除；
+- 4.51 版本以上 App-iOS 平台支持Cache功能，缓存路径、默认大小和自动清理机制和 Android 一样；
+
+**关于Cookie与UA**
+
+- App 平台会将应用的Cookie与UA信息自动带入到请求链接
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.compatibility -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.param -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.returnValue -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.tutorial -->
+
+<!-- UTSAPIJSON.getBackgroundAudioManager.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## 注意
+1，audio默认开启了缓存策略

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

@@ -0,0 +1,31 @@
+## uni.getBatteryInfo(options) @getbatteryinfo
+
+<!-- UTSAPIJSON.getBatteryInfo.description -->
+
+<!-- UTSAPIJSON.getBatteryInfo.compatibility -->
+
+<!-- UTSAPIJSON.getBatteryInfo.param -->
+
+<!-- UTSAPIJSON.getBatteryInfo.returnValue -->
+
+<!-- UTSAPIJSON.getBatteryInfo.example -->
+
+<!-- UTSAPIJSON.getBatteryInfo.tutorial -->
+
+## uni.getBatteryInfoSync() @getbatteryinfosync
+
+<!-- UTSAPIJSON.getBatteryInfoSync.description -->
+
+<!-- UTSAPIJSON.getBatteryInfoSync.compatibility -->
+
+<!-- UTSAPIJSON.getBatteryInfoSync.param -->
+
+<!-- UTSAPIJSON.getBatteryInfoSync.returnValue -->
+
+<!-- UTSAPIJSON.getBatteryInfoSync.example -->
+
+<!-- UTSAPIJSON.getBatteryInfoSync.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,39 @@
+## getCurrentPages() @getcurrentpages
+
+<!-- UTSAPIJSON.getCurrentPages.description -->
+
+HBuilderX 4.31+，强化了页面对象，新增了UniPage对象。getCurrentPages()返回值改为UniPage对象数组。
+
+UniPage对象强化了开发者对页面的管理功能，并且支持在uts插件中使用。
+
+`getCurrentPages()`获取的是主页面栈，不能直接获取[dialogPage](./dialog-page.md)页面。拿到主页面UniPage对象后，可以再通过getDialogPages()方法获取这个主页面的子弹窗页面栈。
+
+选项式的vue中通过`this.$page`，是另一种快速获取当前页面对象的方式。它得到的不是一个页面数组，而是一个具体的当前页面。并且这种方式支持主页面，也支持dialogPage。组合式写法[见下](#tips)
+
+<!-- UTSAPIJSON.getCurrentPages.compatibility -->
+
+<!-- UTSAPIJSON.getCurrentPages.param -->
+
+<!-- UTSAPIJSON.getCurrentPages.returnValue -->
+
+`getCurrentPages()`返回了UniPage对象数组。
+
+每个页面是一个UniPage对象，这个对象上有较多方法，比如获取/修改pageStyle、获取高宽和安全区等。[详见](./unipage.md)
+
+<!-- UTSAPIJSON.getCurrentPages.example -->
+
+<!-- UTSAPIJSON.getCurrentPages.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## 直接获取当前页面的UniPage@currentpage
+* `4.32` 新增选项式通过 `this.$page` 获取当前 `UniPage` 实例, 组合式通过`getCurrentInstance`，代码示例：
+```js
+// 选项式 API
+const curPage = this.$page
+// 组合式 API
+const currentInstance = getCurrentInstance()
+const curPage = currentInstance?.proxy?.$page
+```

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

@@ -0,0 +1,35 @@
+<!-- ## uni.getDeviceInfo(options?) @getdeviceinfo -->
+
+<!-- UTSAPIJSON.getDeviceInfo.name -->
+
+<!-- UTSAPIJSON.getDeviceInfo.description -->
+
+<!-- UTSAPIJSON.getDeviceInfo.compatibility -->
+
+<!-- UTSAPIJSON.getDeviceInfo.param -->
+
+<!-- UTSAPIJSON.getDeviceInfo.returnValue -->
+
+::: warning 注意事项
+- 获取OAID、AndroidID等其他设备信息，[见插件市场](https://ext.dcloud.net.cn/search?q=oaid&orderBy=Relevance&uni-appx=1)
+- romName值域候选 [详见](./get-system-info.md#romname)
+- app平台devicePixelRatio属性，HBuilderX4.22及以下版本类型为string，HBuilderX4.23版本调整为number
+- 在4.51以前，调用本api会获取传感器列表，原因是isSimulator属性判断模拟器时，需要根据传感器信息才能做出更准确的判断。但是，应用商店不允许在同意隐私协议前调用传感器。解决方案有2个：1、在同意隐私协议之后再调用，且隐私协议里声明调用传感器的用途；2、按需加载需要的信息，例如下面的代码，只获取品牌，不获取isSimulator：
+  ```
+  uni.getDeviceInfo({filter:["brand"]})
+  ```
+  从4.51+，本api的isSimulator调整为不再获取传感器信息，但判断模拟器的准确度会下降。如需更准确的判断模拟器，需要单独使用uni.isSimulator。注意也需要在同意隐私协议之后获取。
+- 自 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 区分
+:::
+
+<!-- UTSAPIJSON.getDeviceInfo.example -->
+
+<!-- UTSAPIJSON.getDeviceInfo.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->