tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/api/get-app-authorize-setting.md

@@ -0,0 +1,276 @@
+::: sourceCode
+## uni.getAppAuthorizeSetting() @getappauthorizesetting
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-getAppAuthorizeSetting
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-getAppAuthorizeSetting
+
+获取 APP 授权设置。
+
+### getAppAuthorizeSetting 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 3.9 | 4.11 | 4.61 |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| **GetAppAuthorizeSettingResult** |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| albumAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 4.25 / iOS 4.11（部分支持，见上） | 允许 App 使用相册的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台：表示没有配置[相册相关权限](https://doc.dcloud.net.cn/uni-app-x/native/permission/android_permission_adapter.html)，[权限配置详情](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)；iOS平台：当前应用没有配置相册权限描述 |
+| bluetoothAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 4.25 / iOS 4.11（部分支持，见上） | 允许 App 使用蓝牙的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请蓝牙相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台：表示没有配置[蓝牙相关权限](https://doc.dcloud.net.cn/uni-app-x/native/permission/android_permission_adapter.html)，[权限配置详情](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)；iOS平台：当前应用没有配置蓝牙权限描述 |
+| cameraAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 允许 App 使用摄像头的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请摄像头相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台：表示没有配置 `android.permission.CAMERA` 权限，[权限配置详情](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)；iOS平台：当前应用没有配置相机权限描述 |
+| locationAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 允许 App 使用定位的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请定位相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台：表示没有配置 `android.permission.ACCESS_COARSE_LOCATION` 权限，[权限配置详情](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)；iOS平台：当前应用没有配置定位权限描述 |
+| locationAccuracy | string | 否 | Web x / Android 3.9 / iOS 4.11（部分支持，见上） | 定位准确度。<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| reduced | Web x（部分支持，见上） | 模糊定位 |
+@@| full | Web x（部分支持，见上） | 精准定位 |
+@@| unsupported | Web x（部分支持，见上） | 不支持（包括用户拒绝定位权限和没有包含定位权限描述） |
+| locationReducedAccuracy | boolean | 否 | Web x / 微信小程序 4.41 / Android x / iOS 4.11（部分支持，见上） | 定位准确度（推荐使用 locationAccuracy 属性）。true 表示模糊定位，false 表示精确定位（仅 iOS 支持） |
+| microphoneAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 允许 App 使用麦克风的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请麦克风相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台：表示没有配置 `android.permission.RECORD_AUDIO` 权限，[权限配置详情](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)；iOS平台：当前应用没有配置麦克风权限描述 |
+| notificationAuthorized | string | 是 | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 允许 App 通知的开关<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。Android平台：需要申请通知相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | Android平台没有该值；iOS平台：没有包含推送权限描述 |
+| notificationAlertAuthorized | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS 4.11（部分支持，见上） | 允许 App 通知带有提醒的开关（仅 iOS 支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | 当前应用没有配置推送权限描述 |
+| notificationBadgeAuthorized | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS 4.11（部分支持，见上） | 允许 App 通知带有标记的开关（仅 iOS 支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | 当前应用没有配置推送权限描述 |
+| notificationSoundAuthorized | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS 4.11（部分支持，见上） | 允许 App 通知带有声音的开关（仅 iOS 支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） |
+@@| config error | Web x（部分支持，见上） | 当前应用没有配置推送权限描述 |
+| phoneCalendarAuthorized | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 允许读写日历的开关（仅微信小程序支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求； |
+@@| config error | Web x（部分支持，见上） | 当前应用没有配置读写日历权限描述 |
+| readPhoneCalendarAuthorized | string | 否 | Web x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 允许读日历的开关（仅鸿蒙支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权。 |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求； |
+@@| config error | Web x（部分支持，见上） | 当前应用没有配置读日历权限描述 |
+| writePhoneCalendarAuthorized | string | 否 | Web x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 允许写日历的开关（仅鸿蒙支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权；（此情况需要引导用户打开系统设置，在设置页中打开权限） |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求； |
+| pasteboardAuthorized | string | 否 | Web x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 允许读取剪切版（仅鸿蒙支持）<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| authorized | Web x（部分支持，见上） | 已经获得授权，无需再次请求授权 |
+@@| denied | Web x（部分支持，见上） | 请求授权被拒绝，无法再次请求授权；（此情况需要引导用户打开系统设置，在设置页中打开权限） |
+@@| not determined | Web x（部分支持，见上） | 尚未请求授权，会在App下一次调用系统相应权限时请求； |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-app-authorize-setting/get-app-authorize-setting.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-app-authorize-setting/get-app-authorize-setting.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-app-authorize-setting/get-app-authorize-setting
+```uvue
+<template>
+  <view class="uni-theme-root">
+  <page-head :title="title"></page-head>
+  <view class="uni-common-mt">
+    <view class="uni-list">
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权使用相册</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.albumAuthorized" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权使用蓝牙</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.bluetoothAuthorized" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权使用摄像头</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.cameraAuthorized" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权使用定位</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.locationAuthorized" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">定位准确度</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.locationAccuracy" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权使用麦克风</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.microphoneAuthorized" />
+        </view>
+      </view>
+
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否授权通知</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.notificationAuthorized" />
+        </view>
+      </view>
+      
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否允许通知带有提醒</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.notificationAlertAuthorized" />
+        </view>
+      </view>
+
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否允许通知带有标记</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.notificationBadgeAuthorized" />
+        </view>
+      </view>
+      <view class="uni-list-cell">
+        <view class="uni-pd">
+          <view class="uni-label" style="width:180px;"><text class="system-info-text">是否允许通知带有声音</text></view>
+        </view>
+        <view class="uni-list-cell-db">
+          <input class="system-info-input" placeholder-class="system-info-placeholder" type="text" :disabled="true" placeholder="未获取" :value="data.notificationSoundAuthorized" />
+        </view>
+      </view>
+      
+    </view>
+    <view class="uni-padding-wrap">
+      <view class="uni-btn-v">
+        <button type="primary" @tap="getAppAuthorizeSetting">获取App授权设置</button>
+      </view>
+    </view>
+  </view>
+  </view>
+</template>
+
+
+<style>
+  .uni-pd {
+    padding-left: 15px;
+  }
+
+  .system-info-text,
+  .system-info-input {
+    color: var(--text-color, #333333);
+  }
+
+  .system-info-placeholder {
+    color: var(--active-color, #999999);
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.getAppAuthorizeSetting)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/system/getappauthorizesetting.html)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getAppAuthorizeSetting.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getAppAuthorizeSetting&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getAppAuthorizeSetting&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getAppAuthorizeSetting&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getAppAuthorizeSetting&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getAppAuthorizeSetting)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getAppAuthorizeSetting&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)
+
+如需跳转到权限设置界面，参考[uni.openAppAuthorizeSetting](./open-app-authorize-setting.md)
+
+注意：
+
+Android和iOS的权限设计并不相同，比如iOS有相册权限，而Android不同版本的相册权限逻辑不一样，低版本没有单独的相册权限，归入本地文件读写权限（非沙盒文件），高版本又独立出来。还有很多权限只有一个平台才有。
+
+权限的命名各平台也不相同，所以本API返回的权限名称不是Android和iOS原始的命名，只是一个示意名称。
+
+本API只返回部分权限，Android平台的权限非常多，在Android上获取所有未授权权限，另见[UTSAndroid.getSystemPermissionDenied](../uts/utsandroid.md#getsystempermissiondenied)，这里的权限名称就是Android原始的权限名称了。
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

package/data/uniappx/api/get-app-base-info.md

@@ -0,0 +1,175 @@
+::: sourceCode
+## uni.getAppBaseInfo(options?) @getappbaseinfo
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-getAppBaseInfo
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-getAppBaseInfo
+
+获取app基本信息
+
+### getAppBaseInfo 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 默认值 | 描述 |
+| :- | :- | :- | :- | :- |
+| options | **GetAppBaseInfoOptions** | 否 | 包含所有字段的过滤对象 | \[options=包含所有字段的过滤对象]  过滤的字段对象, 不传参数默认为获取全部字段。 |
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| filter | Array<string> | 是 | 过滤字段的字符串数组，假如要获取指定字段，传入此数组。 |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| **GetAppBaseInfoResult** |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| appId | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的标识，即DCloud AppID<br/> |
+| appName | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的名称<br/> |
+| appVersion | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的版本名称，app平台为原生应用安装包的版本名称<br/> |
+| appVersionCode | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的版本号，app平台为原生应用安装包的版本名称<br/> |
+| appLanguage | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的语言，如en、zh-Hans、zh-Hant、fr、es<br/> |
+| appTheme | string | 否 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 应用的主题<br/> |
+@@| 合法值 |
+@@| :- |
+@@| light |
+@@| dark |
+@@| auto |
+| appWgtVersion | string | 否 | Web x / 微信小程序 x / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 应用资源（wgt）的版本名称，app平台为当前应用资源`manifest.json`中的版本名称<br/> |
+| hostLanguage | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 小程序宿主语言<br/> |
+| hostVersion | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | App、小程序宿主版本。<br/> |
+| hostName | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 小程序宿主名称<br/> |
+| hostPackageName | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 小程序宿主包名<br/> |
+| hostSDKVersion | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | uni小程序SDK版本、小程序客户端基础库版本<br/> |
+| hostTheme | string | 否 | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 系统当前主题，取值为light或dark。微信小程序全局配置"darkmode":true时才能获取，否则为 null （不支持小游戏）<br/> |
+| isUniAppX | boolean | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 是否 uni-app x 项目<br/> |
+| uniCompilerVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uni 编译器版本名称<br/> |
+| uniCompilerVersionCode | number | 否 | Web 4.18 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uni 编译器版本号<br/> |
+| uniRuntimeVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.0 | uni 运行时版本名称<br/> |
+| uniRuntimeVersionCode | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni 运行时版本号<br/> |
+| uniPlatform | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni-app 运行平台<br/> |
+@@| 合法值 |
+@@| :- |
+@@| app |
+@@| web |
+@@| mp-weixin |
+@@| mp-alipay |
+@@| mp-baidu |
+@@| mp-toutiao |
+@@| mp-lark |
+@@| mp-qq |
+@@| mp-kuaishou |
+@@| mp-jd |
+@@| mp-360 |
+@@| quickapp-webview |
+@@| quickapp-webview-union |
+@@| quickapp-webview-huawei |
+| channel | string | 否 | Web x / 微信小程序 x / Android 4.28 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 应用的分发渠道<br/> |
+| packageName | string | 否 | Web x / 微信小程序 5.13 / Android 3.97 / iOS 5.11 / HarmonyOS 4.61（部分支持，见上） | 微信小程序: 小程序appId<br/>Android: 包名<br/>iOS: Bundle ID<br/>鸿蒙: bundleName<br/> |
+| bundleName | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 鸿蒙的包名<br/> |
+| bundleId | string | 否 | Web x / 微信小程序 x / Android x / iOS 4.11 / HarmonyOS x（部分支持，见上） | iOS的Bundle ID<br/> |
+| signature | string | 否 | Web x / 微信小程序 x / Android 3.97 / iOS 4.11 / HarmonyOS x（部分支持，见上） | Android: 应用签名证书的SHA1值（全部为小写，中间不包含“:”）。<br/>iOS: 应用签名证书中绑定的Bundle ID（AppleID）的md5值（全部为小写）。<br/> |
+| PCKernelVersion | string | 否 | 微信小程序 4.41（部分支持，见上） | PC 内核版本号，仅在 PC 端存在该值<br/> |
+| SDKVersion | string | 否 | 微信小程序 4.41（部分支持，见上） | 客户端基础库版本<br/> |
+| enableDebug | boolean | 否 | 微信小程序 4.41（部分支持，见上） |  |
+| fontSizeScaleFactor | number | 否 | 微信小程序 4.41（部分支持，见上） | 微信字体大小缩放比例<br/> |
+| fontSizeSetting | number | 否 | 微信小程序 4.41（部分支持，见上） | 需要基础库： `2.23.4`<br/><br/>微信字体大小，单位px<br/> |
+| host | **GetAppBaseInfoResultHost** | 否 | 微信小程序 4.41（部分支持，见上） | 当前小程序运行的宿主环境<br/> |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| appId | string | 否 | 微信小程序 4.41（部分支持，见上） | 宿主 app（第三方App） 对应的 appId （当小程序运行在第三方App环境时才返回）<br/> |
+| theme | string | 否 | 微信小程序 4.41（部分支持，见上） | 系统当前主题，取值为`light`或`dark`，全局配置`"darkmode":true`时才能获取，否则为 undefined （不支持小游戏）<br/><br/>可选值：<br/>- 'dark': 深色主题;<br/>- 'light': 浅色主题;<br/> |
+@@| 合法值 |
+@@| :- |
+@@| dark |
+@@| light |
+| ~~uniCompileVersion~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | uni 编译器版本名称  **已废弃，仅为了向下兼容保留** |
+| ~~uniCompileVersionCode~~ | number | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | uni 编译器版本号  **已废弃，仅为了向下兼容保留** |
+| ~~language~~ | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的语言  **已废弃，仅为了向下兼容保留** |
+| ~~version~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 引擎版本号  **已废弃，仅为了向下兼容保留** |
+
+#### 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)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-app-base-info/get-app-base-info.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-app-base-info/get-app-base-info.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/get-app-base-info/get-app-base-info
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-app-base-info/get-app-base-info
+
+>示例
+```vue
+<template>
+  <view class="uni-theme-root">
+    <page-head :title="title"></page-head>
+    <view class="uni-common-mt">
+      <view class="uni-list">
+        <view class="uni-list-cell" v-for="(item, index) in data.items" :key="index" style="align-items: center;">
+          <view class="uni-pd">
+            <view class="uni-label" style="width:180px;">
+              <text class="system-info-text">{{item.label}}</text>
+            </view>
+          </view>
+          <view class="uni-list-cell-db">
+            <text class="uni-list-cell-db-text system-info-text">{{ item.value == '' ? '未获取' : item.value }}</text>
+          </view>
+        </view>
+      </view>
+      <view class="uni-padding-wrap">
+        <view class="uni-btn-v">
+          <button type="primary" @tap="getAppBaseInfo">获取App基础信息</button>
+        </view>
+      </view>
+    </view>
+  </view>
+</template>
+
+
+<style>
+  .uni-pd {
+    padding-left: 15px;
+  }
+
+  .system-info-text {
+    color: var(--text-color, #333333);
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.getAppBaseInfo)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/system/getAppBaseInfo.html)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getAppBaseInfo.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getAppBaseInfo&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getAppBaseInfo&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getAppBaseInfo&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getAppBaseInfo&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getAppBaseInfo)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getAppBaseInfo&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)
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

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

@@ -0,0 +1,175 @@
+## getApp() @getapp
+
+`getApp()` 函数用于获取当前应用实例，可通过应用实例调用 App.uvue methods 中定义的方法, [详见](#appmethods)。
+
+- HBuilderX 4.31 以前，`getApp()` 返回的是 Vue 实例，且无法在 uts 插件中使用。
+- 从 HBuilderX 4.31+ 起，新增 `UniApp` 对象用于管理 app，`getApp()` 返回 `UniApp` 对象；Vue 实例则作为 `UniApp` 对象的 `vm` 属性提供。
+- `getApp()` 只能在 `script` 中调用，不能直接在模板中使用。
+
+`UniApp` 对象可同时在 uts 插件和 uvue 页面中使用，但 `vm` 属性及其相关的 `globalData` 仍然只能在 uvue 页面中使用。
+
+### getApp 兼容性  
+| Web | 微信小程序 | Android | Android(Vapor) UTS 插件 | iOS | iOS(VDOM) UTS 插件 | iOS(Vapor) UTS 插件 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- | :- | :- |
+| 4.0 | √ | √ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | √ | 4.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.61 |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| [UniApp](#uniapp-values) |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| vm | ComponentPublicInstance | 否 | Web 4.31 / 微信小程序 x / Android 4.31 / Android(Vapor) UTS 插件 x / iOS 4.31 / iOS UTS 插件 x / HarmonyOS 4.61（部分支持，见上） | App vue 实例对象 |
+| globalData | Record\<K, T> | 是 | Web 4.31 / 微信小程序 x / Android 4.31 / Android(Vapor) UTS 插件 x / iOS 4.31 / iOS(Vapor) UTS 插件 x / HarmonyOS 4.61（部分支持，见上） | 全局对象 |
+| ~~$vm~~ | ComponentPublicInstance | 否 | Web 4.31 / 微信小程序 x / Android 4.31 / Android(Vapor) UTS 插件 x / iOS 4.31 / iOS UTS 插件 x / HarmonyOS 4.61（部分支持，见上） | App vue 实例对象  **已废弃，仅为了向下兼容保留** |
+#### UniApp 的方法 @uniapp-values 
+
+#### getAndroidApplication(): Application @getandroidapplication
+getAndroidApplication
+获取 Android 应用 Application 上下文
+##### getAndroidApplication 兼容性  
+| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| x | x | 4.31 | x | x | x |
+
+##### 返回值 
+
+| 类型 |
+| :- |
+| Application |
+ 
+
+#### getHarmonyAbility(): UIAbility @getharmonyability
+getHarmonyAbility
+获取 鸿蒙应用 Ability 实例
+##### getHarmonyAbility 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- |
+| x | x | x | x | 4.61 | x |
+
+##### 返回值 
+
+| 类型 |
+| :- |
+| UIAbility |
+ 
+
+#### restart(url?: string): void @restart
+restart
+重启应用
+##### restart 兼容性  
+| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
+| :- | :- | :- | :- | :- | :- | :- |
+| x | x | x | 5.31 | x | 5.31 | x |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| url | string | 否 | Web x / 微信小程序 x / HarmonyOS x（部分支持，见上） | 重启后打开的页面地址 |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/get-app/get-app.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/get-app/get-app.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/get-app/get-app
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/get-app/get-app
+
+>示例
+```vue
+<template>
+  
+  <scroll-view style="flex: 1; padding-bottom: 20px">
+  
+    <view style="padding-bottom: 20px">
+      <page-head title="getApp"></page-head>
+      <view class="uni-padding-wrap">
+        <button @click="getGlobalData">get globalData</button>
+        <template v-if="data.originGlobalData.str.length">
+          <text class="uni-common-mt bold">初始的 globalData:</text>
+          <text class="uni-common-mt">globalData string: {{ data.originGlobalData.str }}</text>
+          <text class="uni-common-mt">globalData number: {{ data.originGlobalData.num }}</text>
+          <text class="uni-common-mt">globalData boolean: {{ data.originGlobalData.bool }}</text>
+          <text class="uni-common-mt">globalData object: {{ data.originGlobalData.obj }}</text>
+          <text class="uni-common-mt">globalData null: {{ data.originGlobalData.null }}</text>
+          <text class="uni-common-mt">globalData array: {{ data.originGlobalData.arr }}</text>
+          <text class="uni-common-mt">globalData Set: {{ data.originGlobalData.set }}</text>
+          <text class="uni-common-mt">globalData Map: {{ data.originGlobalData.map }}</text>
+          <text class="uni-common-mt">globalData fun 返回值: {{ data.originGlobalDataFuncRes }}</text>
+        </template>
+        <button @click="setGlobalData" class="uni-common-mt">
+          set globalData
+        </button>
+        <template v-if="data.newGlobalData.bool">
+          <text class="uni-common-mt bold">更新后的 globalData:</text>
+          <text class="uni-common-mt">globalData string: {{ data.newGlobalData.str }}</text>
+          <text class="uni-common-mt">globalData number: {{ data.newGlobalData.num }}</text>
+          <text class="uni-common-mt">globalData boolean: {{ data.newGlobalData.bool }}</text>
+          <text class="uni-common-mt">globalData object: {{ data.newGlobalData.obj }}</text>
+          <text class="uni-common-mt">globalData null: {{ data.newGlobalData.null }}</text>
+          <text class="uni-common-mt">globalData array: {{ data.newGlobalData.arr }}</text>
+          <text class="uni-common-mt">globalData Set: {{ data.newGlobalData.set }}</text>
+          <text class="uni-common-mt">globalData Map: {{ data.newGlobalData.map }}</text>
+          <text class="uni-common-mt">globalData fun 返回值: {{ data.newGlobalDataFuncRes }}</text>
+        </template>
+        <text class="uni-common-mt">点击按钮调用 App.uvue methods</text>
+        <text class="uni-common-mt">increaseLifeCycleNum 方法</text>
+        <button class="uni-common-mt" @click="_increaseLifeCycleNum">
+          increase lifeCycleNum
+        </button>
+        <text class="uni-common-mt">lifeCycleNum: {{ data.lifeCycleNum }}</text>
+        
+        <button class="uni-common-mt" @click="getAndroidApplication">
+          getAndroidApplication
+        </button>
+        <text class="uni-common-mt">androidApplication is null: {{ data.androidApplication == null }}</text>
+        
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .bold {
+    font-weight: bold;
+  }
+
+  .hr {
+    border-bottom: 1px solid #ccc;
+  }
+</style>
+
+```
+
+### 全局方法调用@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()`。
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.global.getApp)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/tutorial/page.html#getapp)
+- [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=getApp&doc_type=miniprogram)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getApp&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getApp&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getApp&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getApp&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getApp)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=getApp&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)
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |