npm - tmui-cli - Versions diffs - 2.0.2 → 2.0.4 - Mend

tmui-cli 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1564) hide show

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

@@ -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 ADDED Viewed

@@ -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&lt;string&gt; | 是 | 过滤字段的字符串数组，假如要获取指定字段，传入此数组。 |
+### 返回值
+| 类型 |
+| :- |
+| **GetAppBaseInfoResult** |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| appId | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用标识，即DCloud AppID<br/> |
+| appName | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用名称<br/> |
+| appVersion | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用版本名称<br/> |
+| appVersionCode | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | `manifest.json` 中的应用版本号<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 |
+| channel | string | 否 | Web x / 微信小程序 x / Android 4.28 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 应用的分发渠道<br/> |
+| language | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用设置的语言<br/> |
+| appWgtVersion | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 应用资源（wgt）的版本名称<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 x（部分支持，见上） | 是否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 x（部分支持，见上） | 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 |
+| packageName | string | 否 | Web x / 微信小程序 5.13 / Android 3.97 / iOS x / 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 |
+| ~~version~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 引擎版本号。已废弃，仅为了向下兼容保留  **已废弃，仅为了向下兼容保留** |
+| ~~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 编译器版本号  **已废弃，仅为了向下兼容保留** |
+#### 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 ADDED Viewed

@@ -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 | 是 | 错误信息 |