tmui-cli 2.0.6 → 5.3.1

package/data/uni-app-x-docs/_sidebar.md

@@ -1,14 +1,11 @@
 * [概述](README.md)
 * [蒸汽模式](app-vapor.md)
+* benchmark
+  * [Android性能评测基准报告](benchmark/vapor-benchmark-android.md)
+  * [iOS性能评测基准报告](benchmark/vapor-benchmark-ios.md)
+  * [鸿蒙性能评测基准报告](benchmark/vapor-benchmark-harmony.md)
 * [项目](project.md)
 * [页面](page.md)
-* 教程
-	* Android VDOM模式注意
-		* [强类型下与js开发的差别](tutorial/codegap.md)
-		* [request联网教程](tutorial/request.md)
-	* [复杂列表开发指南](tutorial/stickynestlist.md)
-	* [全局变量与状态管理](tutorial/store.md)
-  * [几种组件标记的概念澄清](tutorial/idref.md)
 * web平台专题指南
   * [概述](web/README.md)
   * [跨域](tutorial/CORS.md)
@@ -51,8 +48,8 @@
     * [概述](tutorial/app-market.md)
     * [应用合规指南](tutorial/compliance.md)
     * [Android 16KB页面大小适配](tutorial/android-16kb.md)
-		* [iOS Appstore上架](https://uniapp.dcloud.net.cn/tutorial/ios-app-store.html)
-    * [iOS平台隐私清单](https://uniapp.dcloud.net.cn/tutorial/app-ios-privacyinfo.html)
+		* [iOS Appstore上架](tutorial/ios-app-store.md)
+    * [iOS平台隐私清单](tutorial/app-ios-privacyinfo.md)
 * 鸿蒙next平台专题指南
   * [概述](app-harmony/README.md)
   * [应用合规指南](tutorial/compliance.md)
@@ -65,35 +62,32 @@
     * [原生联调](native/debug/harmony.md)
 * 小程序平台专题指南
   * [概述](mp/README.md)
-  * [AI 开发模式接入指南](mp/mp-weixin-ai-develop.md)
   * [独立分包](mp/independent-subpackage.md)
-  * [组件和 WXS](mp/native-component-and-wxs.md)
+  * [组件和 WXS/SJS](mp/native-component-and-wxs.md)
   * [分包异步化](mp/miniprogram-subcontract-asynchrony.md)
-  * [适配 glass-easel](mp/mp-weixin-glass-easel.md)
+  * 微信
+    * [AI 开发模式接入指南](mp/mp-weixin-ai-develop.md)
+    * [适配 glass-easel](mp/mp-weixin-glass-easel.md)
 * 运行和调试
   * [Android/iOS运行](tutorial/run-app.md)
-  * [DevTools 审查元素、网络、存储](tutorial/debug/devtools.md)
+  * [鸿蒙运行](tutorial/harmony/runbuild.md)
   * [uts插件Android运行配置](tutorial/uts-development-android.md)
-  * [Android 审查元素](debug/android-inspector.md)
+  * [uts插件iOS运行配置](tutorial/uts-development-ios.md)
+  * [DevTools 审查元素、网络、存储](tutorial/debug/devtools.md)
   * [Android Debug断点](tutorial/uni-uts-debug.md)
+  * [iOS Debug断点](tutorial/uni-uts-debug-ios.md)
+  * [鸿蒙 Debug断点](tutorial/uni-uts-debug-harmony.md)
+  * [Android 审查元素](debug/android-inspector.md)
   * [Android 内存泄漏排查](tutorial/android-memoryleak.md)
-  * [uts插件iOS运行配置](tutorial/uts-development-ios.md)
-  * [uts插件iOS Debug](tutorial/uni-uts-debug-ios.md)
-  * [鸿蒙运行](tutorial/harmony/runbuild.md)
-  * [鸿蒙Debug断点](tutorial/uni-uts-debug-harmony.md)
-* [性能优化](performance.md)
 * [uni错误规范](err-spec.md)
 * [暗黑模式](api/theme-change.md)
 * [宽屏适配](adapt.md)
 * [国际化](i18n.md)
 * [源码和示例](sample.md)
 * [兼容性表格导读](tutorial/compatibility.md)
-* benchmark
-  * [Android性能评测基准报告](benchmark/vapor-benchmark-android.md)
-  * [iOS性能评测基准报告](benchmark/vapor-benchmark-ios.md)
-  * [鸿蒙性能评测基准报告](benchmark/vapor-benchmark-harmony.md)
 * 选型参考
 	* [一文讲透原生渲染和自渲染](./select/native-render-and-self-render.md)
+	* [uni-app x和uni-app的对比](./uniappvsuniappx.md)
 * [uni-app 升级 uni-app x](uniapptox.md)
 * 安全专题
   * [综述](tutorial/safe.md)
@@ -132,8 +126,15 @@
     * [安卓、鸿蒙厂商推送配置](uni-push/vendor_config.md)
     * [谷歌FCM配置](uni-push/google-fcm.md)
   * [uni统计](https://uniapp.dcloud.net.cn/uni-stat-uniappx)
-* cursor/vscode插件
-  * [语言服务插件](tutorial/ls-plugin.md)
+* 教程
+	* [性能优化](performance.md)
+	* [复杂列表开发指南](tutorial/stickynestlist.md)
+	* [全局变量与状态管理](tutorial/store.md)
+  * [几种组件标记的概念澄清](tutorial/idref.md)
+	* Android VDOM模式注意
+		* [强类型下与js开发的差别](tutorial/codegap.md)
+		* [request联网教程](tutorial/request.md)
+	* [cursor/vscode插件语言服务插件](tutorial/ls-plugin.md)
   * [AI Rules/MCP](tutorial/rules_mcp.md)
 * 更新日志
   * [正式版](release.md)

package/data/uni-app-x-docs/adapt.md

@@ -2,7 +2,7 @@
 
 uni-app-x 提供了两种宽屏适配方案，用于在不同屏幕尺寸下提供最佳的用户体验。本文档将详细介绍这两种方案的使用方法和实现思路。
 
-## 一、页面窗体级适配
+## 一、web页面窗体级适配
 
 > 只支持web端
 
@@ -30,7 +30,7 @@ uni-app-x 提供了两种宽屏适配方案，用于在不同屏幕尺寸下提
 ### 示例代码
 
 #### 配置示例
-leftWindow等配置，在pages.json里进行。[文档见](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pages-topwindow)
+leftWindow等配置，在pages.json里进行。[文档](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pages-topwindow)
 ```json
 {
 	"leftWindow": {
@@ -69,10 +69,10 @@ uni.$on('updateData', (data) => {
 
 
 #### 完整示例
-hello uni-app使用了topWindow和leftWindow，分为上左右3栏，[详见](https://hellouniappx.dcloud.net.cn/web#/)
+hello uni-app x 使用了topWindow和leftWindow，分为上左右3栏，[详见](https://hellouniappx.dcloud.net.cn/web#/)
 
 
-## 二、组件级适配 @component-adapt
+## 二、跨端组件级适配 @component-adapt
 
 > HBuilderX 4.71+ 全平台支持
 
@@ -116,6 +116,8 @@ const deviceType = uni.getDeviceInfo().deviceType
 isWideScreen.value = deviceType === 'pad' || deviceType === 'pc'
 ```
 
+也可以使用 [match-media组件](./component/match-media.md)。组件使用更简单，灵活性不如脚本编程。
+
 #### 布局实现
 宽屏窄屏模式，通过 CSS 类名动态控制布局，响应式设计适配不同屏幕尺寸
 
@@ -167,3 +169,4 @@ isWideScreen.value = deviceType === 'pad' || deviceType === 'pc'
 #### 完整示例
 
 完整的示例代码请参考插件：[宽屏适配示例](https://ext.dcloud.net.cn/plugin?name=uni-wide-screen)
+

package/data/uni-app-x-docs/alert.md

@@ -0,0 +1,79 @@
+---
+title: tmui 3.2.0 组件库
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+#### 展示组件
+
+# 警告 TmAlert
+
+样式丰富常用警告提醒
+
+## :hot_pepper: 示例
+
+<webview url="https://tmui.design/h5by32/#/pages/index/alert"></webview>
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/alert.vue{vue}
+
+:::
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| status | string | "primary" | 类型warn:警告success:成功error:错误info:信息primary:正常主题 | 
+| icon | string | "" | 警告图标,不填写取status默认图标填写以填写为准 | 
+| iconSize | string | "32" | 警告图标大小 | 
+| closeIcon | string | "close-line" | - | 
+| showClose | boolean | true | 显示还是隐藏关闭按钮 | 
+| showIcon | boolean | true | 显示左边按钮 | 
+| fontSize | string | "28" | 文字大小 | 
+| color | string | "" | 主题色，如果不填写以status为准 | 
+| fontColor | string | "" | 文字颜色，如果不填写以status为准 | 
+| darkColor | string | "" | 暗黑主题颜色，如果不填写自动计算 | 
+| fontDarkColor | string | "" | 暗黑文字颜色，如果不填写自动计算 | 
+| skin | string | "thin" | 它是建立在你没有提供color时才有效。如果提供了color是以你color为背景最终色。thin浅色模式，normal标准背景色 | 
+| round | string\|number\|Array\<string\|number\> | 16 | 圆角数组数字时[全部][顶左，顶右，底右，底左][顶左，底右][顶左，顶右，底右]空数组时取全局值 | 
+| border | string\|number\|Array\<string\|number\> | ():string[]=\>[] | 边线数组数字时数组数字时[全部][左，上，右，下][左右，上下][左，上，右]空数组时取全局值 | 
+| borderColor | string\|Array\<string\> | ():string[]=\>[] | 边框颜色格式同border边线。空数组时取全局值 | 
+| darkBorderColor | string\|Array\<string\> | ():string[]=\>[] | 如果不填写，自动计算 | 
+| borderStyle | string | 'solid' | 边线类型，默认solid,可以为none | 
+| margin | string\|number\|Array\<string\|number\> | ():string[]=\>['24','0','24','24']asstring[] | 间隙[x]全部,[x,x]左右，上下,[x,x,x]左上右,[x,x,x,x]左上右下空数组时取全局值 | 
+| padding | string\|number\|Array\<string\|number\> | ():string[]=\>['28','20']asstring[] | 内间隙[x]全部,[x,x]左右，上下,[x,x,x]左上右,[x,x,x,x]左上右下空数组时取全局值 | 
+| height | string | "auto" | 自定义高度，可以是数字，单位或者百分比,auto | 
+| width | string | "auto" | 宽，单位合法即可数字，字符串带单位，百分比,auto | 
+
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| close | - | - | 关闭时触发 | 
+| click | - | - | 组件被点击时触发 | 
+
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| left | - | 左边图标插槽 | 
+| default | - | - | 
+
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+
+

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

@@ -1,14 +1,15 @@
 # API概述
 
-uni-app x项目的uts代码中可以使用很多API。包括：
+uni-app x项目可以使用很多API。包括：
 
-1. uts的api，包括[内置对象](../uts/buildin-object-api/global.md)，以及平台专有对象[UTSAndroid](../uts/utsandroid.md)、[UTSiOS](../uts/utsios.md)、[UTSHarmony](../uts/utsharmony.md)
+1. js/uts的内置api，比如[内置对象](../uts/buildin-object-api/global.md)
 2. 全局api，前面不需要加`uni.`。如`getApp`
 3. uni.xxx的内置api。见左侧
 4. uniCloud.xxx的内置api [详见](./unicloud/README.md)
-5. dom的api [详见](../dom/README.md)
+5. dom的api [详见](./dom/README.md)
 6. vue的api [详见](../vue/README.md)
-7. 平台原生api
+7. uts插件平台专用API：[UTSAndroid](../uts/utsandroid.md)、[UTSiOS](../uts/utsios.md)、[UTSHarmony](../uts/utsharmony.md)
+8. 平台原生api
 	* Android 所有原生API
 	* iOS 所有原生API
 	* harmony 所有原生API
@@ -18,11 +19,12 @@ uni-app x项目的uts代码中可以使用很多API。包括：
 uni-app x中，不会限制任何平台原来的API无法调用。常用的跨平台API，都已经封装在uni的API中，但所有的平台API均可以在uni-app x中调用。
 
 ## os原生api的使用
+
 由于uts可以直接调用Android、iOS、鸿蒙的api，所以os和三方sdk的能力都可以在uts中调用。
 
 虽然Android VDOM 模式，以及鸿蒙 arkts 驱动 下可以在页面里调用原生API。但这并不规范，规范的做法是在uts插件中使用uts调用原生API。
 
-如下是一个Android vdom模式的例子：
+如下是一个Android VDOM模式的例子：
 
 ```vue
 <script setup lang="uts">
@@ -40,17 +42,13 @@ uni-app x中，不会限制任何平台原来的API无法调用。常用的跨
 - uni.getSystemInfoSync，是uni的api
 - import的Build，是Android os的api
 
-可以看出，在uni-app x里，可以直接调用os的能力，不受限制，语法是uts的语法，但需要了解什么功能在原生里是哪个api。
-
-使用`uni.getSystemInfoSync`则比较简单，看uni的文档即可，且可跨平台。
-
 其实，[uni.getSystemInfoSync](https://gitcode.com/dcloud/uni-api/blob/master/uni_modules/uni-getSystemInfo/utssdk/app-android/index.uts) 的内部实现就是一个uts模块，底层使用了一样的代码，也是import了android.os.Build。
 
 大多数uni.的api，都是uts开发的，它们开源在[uni-api](https://gitcode.com/dcloud/uni-api)。
 
 插件市场也有很多做好的uts插件，方便开发者拿来即用。[uts插件](https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate)
 
-虽然上述页面可以直接调用原生Android能力，但正规开发时，原生能力应封装为[uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)形式的[uts插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)。这样方便共享、方便跨平台。（iOS在js驱动模式时，uvue页面中不支持调用swift API，需封装为uts插件调用原生API）
+虽然上述Android VDOM模式页面可以直接调用原生Android能力，但正规开发时，原生能力应封装为[uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)形式的[uts插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)。这样方便共享、方便跨平台。
 
 uni-app x 中不再支持plus和weex的API。过去plus api中一些常用的api，一部分在uni-app x中进行了替换增补、一部分提供了uts操作原生的示例代码。[详见](ext.md)
 

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

@@ -11,6 +11,8 @@
   * [Base64](base64.md)
   * [拦截器](interceptor.md)
   * [启动](launch.md)
+  * [安装 WGT](install-wgt.md)
+  * [重启应用](./get-app.md#restart)
   * [退出应用](exit.md)
   * [获取服务提供商](provider.md)
   * [uni.getPerformance](get-performance.md)
@@ -139,6 +141,8 @@
   * [创建 editor 组件上下文对象](create-editor-context-async.md)
 * Worker
   * [创建 worker 对象](create-worker.md)
+* UASM
+  * [加载 UASM](uasm.md)
 * [DOM](dom/README.md)
   * [DOM概述](dom/README.md)
   * [UniElement](dom/unielement.md)

package/data/uni-app-x-docs/api/animation-frame.md

@@ -8,7 +8,11 @@
 
 <!-- UTSJSON.Global.requestAnimationFrame.test -->
 
-<!-- UTSJSON.Global.requestAnimationFrame.compatibility -->
+**兼容性 <Help />**
+
+| Web | Android | iOS | HarmonyOS | iOS(VDOM) UTS 插件 |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.25 | 4.25 | 4.61 | x |
 
 <!-- UTSJSON.Global.requestAnimationFrame.tutorial -->
 
@@ -22,7 +26,11 @@
 
 <!-- UTSJSON.Global.cancelAnimationFrame.test -->
 
-<!-- UTSJSON.Global.cancelAnimationFrame.compatibility -->
+**兼容性 <Help />**
+
+| Web | Android | iOS | HarmonyOS | iOS(VDOM) UTS 插件 |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.25 | 4.25 | 4.61 | x |
 
 <!-- UTSJSON.Global.cancelAnimationFrame.tutorial -->
 
@@ -54,4 +62,3 @@
 - 暂未提供关闭申请高刷的设置
 
 注意无论哪个平台，最终高刷是否生效仍受手机系统策略以及用户设置影响。
-

package/data/uni-app-x-docs/api/capture-screen.md

@@ -22,11 +22,6 @@
 
 <!-- UTSAPIJSON.offUserCaptureScreen.tutorial -->
 
-<!-- UTSAPIJSON.general_type.name -->
-
-<!-- UTSAPIJSON.general_type.param -->
-
-
 ## uni.setUserCaptureScreen(options) @setusercapturescreen
 
 <!-- UTSAPIJSON.setUserCaptureScreen.description -->

package/data/uni-app-x-docs/api/create-drama-ad.md

@@ -0,0 +1,56 @@
+<!-- UTSAPIJSON.createDramaAd.name -->
+
+<!-- UTSAPIJSON.createDramaAd.description -->
+
+短剧广告：通过短剧内容生态（穿山甲内容联盟）变现的高价值广告形式。开发者将短剧内容（列表、播放页）嵌入自己的应用，用户免费观看指定集数后，需观看激励视频解锁后续剧集，从而实现广告变现。
+
+uni-app x 内置短剧 uni-drama，提供两种接入方式：
+
+| 接入方式 | 说明 | 适用场景 |
+| :- | :- | :- |
+| API 模式 | 通过 `uni.createDramaAd` 创建实例，自行搭建短剧列表页，调用查询接口获取短剧数据，再调用 `open` 打开原生播放页 | 需要自定义短剧列表页样式、深度定制业务 |
+| 组件模式 | 使用 `<ad-drama>` 组件（native-view）| 快速接入，直接使用渠道提供的短剧首页 |
+
+组件模式另见：[ad-drama 组件](../component/ad-drama.md)。
+示例Demo另见：[详见](https://gitcode.com/dcloud/uni-ad-drama)
+
+**开通配置广告**
+
+[开通广告步骤详情](https://uniapp.dcloud.net.cn/uni-ad/ad-open.html)
+
+**Tips**
+- 标准基座不支持测试短剧功能。
+- 使用短剧组件需要先开通穿山甲广告。开通问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
+- 标准基座不包含短剧运行时，需制作自定义基座后运行，否则报错 `-5020`。
+
+### 配置文件
+
+在穿山甲后台 内容输出->接入管理 找到需要接入内容SDK的应用，点击"下载SDK参数配置"，然后将SDK配置文件（例如 sdk_setting_file.json）拷贝到项目的 assets 文件夹下。
+
+![](https://lf3-plat.pglstatp-toutiao.com/obj/union-platform/a30bc3001dff716fcf6876da15151ecf.png)
+
+文件下载之后重命名为：`gm_SDK_Setting.json`，然后将文件放到项目根目录的`nativeResources->android->assets`目录下。
+
+### 服务器回调
+
+用户观看激励视频解锁剧集后，为防止客户端伪造看完广告的凭据，解锁集数的发放由服务器回调完成，这是业内通行的安全方案。调用 `open` 时传入 `urlCallback`（userId/extra），激励发放时会透传到业务服务器参与校验。服务器回调机制详见 [激励视频广告服务器回调](https://uniapp.dcloud.net.cn/uni-ad/ad-rewarded-video.html#callback)。
+
+<!-- UTSAPIJSON.createDramaAd.compatibility -->
+
+<!-- UTSAPIJSON.createDramaAd.param -->
+
+<!-- UTSAPIJSON.createDramaAd.fileFormats -->
+
+<!-- UTSAPIJSON.createDramaAd.returnValue -->
+
+## Tips
+
++ 短剧广告仅支持 Android 平台。
+
+<!-- UTSAPIJSON.createDramaAd.example -->
+
+<!-- UTSAPIJSON.createDramaAd.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/create-inner-audio-context.md

@@ -28,6 +28,7 @@
 - web平台的支持取决于浏览器的实现，一般浏览器上述音频格式均支持
 - 小程序平台支持的格式见各家小程序的文档
 - HarmonyOS 平台使用 [AudioPlayer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-media#audioplayerdeprecated?ha_source=Dcloud&ha_sourceId=89000448) 实现
+- `innerAudioContext` 播放本地音频时不要使用 `../static/` 等相对路径；小程序应使用可访问的绝对路径。
 
 **缓存说明**
 

package/data/uni-app-x-docs/api/create-selector-query.md

@@ -155,6 +155,7 @@ uni.createSelectorQuery().select('.rect1').selectAll('.rect2').boundingClientRec
 **注意事项：**
 
 1. Web 平台 `<template>` 下如果存在多个节点，如果是在组件内部查询，可能会导致查询到其他组件或页面的元素
+2. 支付宝小程序中，`createSelectorQuery().in()` 只能将查询范围设置为自定义组件，不能用于页面；页面查询需要在页面渲染完成后调用，否则可能查询不到结果。
 
 <!-- UTSAPIJSON.general_type.name -->
 

package/data/uni-app-x-docs/api/dom/uninativeviewelement.md

@@ -96,3 +96,8 @@
 
 
 <!-- CUSTOMTYPEJSON.UniNativeViewElement.example -->
+
+## tips
+
+鸿蒙有多种原生视图可以绑定，有bindHarmonyController、bindHarmonyWrappedBuilder、bindHarmonyFrameNode。
+在 uni-app x 蒸汽模式下，bindHarmonyFrameNode的性能更高一些。

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

@@ -9,15 +9,25 @@
 - 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。
+uni-app x 中不再支持plus和weex的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)
+本身uni的api和plus的api有一些重叠，在老uni-app中，能用uni api替代的，也应该用uni api替代。
+
+对于老uni-app中，plus api未进行uni化替代的，在uni-app x 中进行了增补或插件替代。
+
+- plus.runtime.quit 改用 [uni.exit](./exit.md)
+- plus.runtime.install 分拆成为2个API [uni.installApk](./install-apk.md) 和 [uni.installWgt](./install-wgt.md)
+- plus.runtime.restart 改用 [getApp().restart](./get-app.md#appmethods)
+- plus.runtime.setBadgeNumber 改用 [uni.setAppBadgeNumber](./uni-push.md#setappbadgenumber)
 - plus.runtime.openURL [插件市场](https://ext.dcloud.net.cn/plugin?id=17828)
+- plus.runtime.openWeb [uni-link](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/uni-link.html)
+- plus.runtime.showPrivacyDialog 请自行调用dialogPage，弹出自己的uvue页面。
+- plus.runtime.agreePrivacy、plus.runtime.disagreePrivacy 改用 [button组件](../component/button.md)的opentype="agreePrivacyAuthorization"
+- plus.runtime.launcher、plus.runtime.arguments 改用[app.uvue](../collocation/app.md)中onLaunch、onShow生命周期中的options参数
+- plus.io、plus.zip 改用 [uni.getFileSystemManager](./get-file-system-manager.md) 中有一批文件和压缩相关的api。
+- plus.navigator 中控制顶部状态栏和底部导航栏的方法，改在 pages.json 的 [pageStyle](../collocation/pagesjson.md#pagesoptionspage-style) 中控制，也可以在 UniPage 的 [setStyle](./unipage.md#unipage-methods) 方法中控制。
+- plus.sqlite 改用 [uasm的sqlite标准插件](https://ext.dcloud.net.cn/plugin?id=29856) 或 [插件市场的其他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写法的插件，自定义了一个plus对象，方法内部再调用uni或uts的api，以兼容历史的plus写法，[详见](https://ext.dcloud.net.cn/search?q=plus&orderBy=Relevance&uni-appx=1)
 

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

@@ -20,10 +20,10 @@ uni-app x框架因为需要也会产生一些文件在CACHE目录中，比如拍
 	+ 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。
+	+ 应用沙盒目录`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插件开发**  
@@ -73,15 +73,18 @@ fileManager.copyFile({
 
 > 注意：代码包文件只读，无法动态修改或删除。修改代码包文件一般会copy到沙盒目录后再修改。
 
-### 真机运行时代码包文件目录 @packageDebug  
+### 真机运行时代码包文件目录 @packagedebug  
 
 **注意：真机运行时代码包文件目录有特殊处理**  
 
 Android/iOS端真机运行期间，为了实现动态性，将代码包文件同步到`应用沙盒目录`下的特定目录：
 - Android平台
-	保存在应用专属存储空间的外置存储空间根目录下的apps目录，通常为“/sdcard/Android/data/%应用包名%/apps/%应用AppID%/www/”
+  + VDOM模式  
+    保存在应用专属存储空间的外置存储空间根目录下的apps目录，通常为“/sdcard/Android/data/%应用包名%/apps/%应用AppID%/www/”
+  + 蒸汽（Vapor）模式  、
+    保存在应用专属存储空间的内置存储空间根目录下的apps目录，通常为“/data/data/%应用包名%/apps/%应用AppID%/www/”
 - iOS平台
-	保存在应用沙盒目录下的Documents/uni-app-x目录，通常为“/%应用沙盒目录%/Documents/uni-app-x/apps/%应用AppID%/www/”
+  保存在应用沙盒目录下的Documents/uni-app-x目录，通常为“/%应用沙盒目录%/Documents/uni-app-x/apps/%应用AppID%/www/”
 
 请开发者不要使用FileManage API操作应用代码包文件。虽然真机运行时可以访问，但打包后代码包不在沙盒中，无法再访问。
 
@@ -113,7 +116,7 @@ fs.writeFile({
 ```
 
 
-### 外置应用沙盒目录@sandbox
+### 应用沙盒目录@sandbox
 目录常量名称：`uni.env.SANDBOX_PATH`
 
 App端专有目录，为应用沙盒根目录，其下包含了`缓存文件目录`和`用户数据目录`，真机运行时还包括应用资源目录。此目录在不同平台差异较大，不建议直接使用此目录，建议直接按需使用下方的缓存目录`uni.env.CACHE_PATH`和数据目录`uni.env.USER_DATA_PATH`。
@@ -206,7 +209,7 @@ uni-app x框架的一些内置组件和API会涉及缓存文件，存放到本
 FileSystemManager目前对内置应用沙盒目录为只读。如需写入，需开发uts插件。
 
 ### 沙盒外目录
-FileSystemManager API暂不支持访问沙盒外目录。
+FileSystemManager API不支持访问沙盒外目录。
 
 保存图片和视频到相册，有专门的API：[uni.saveImageToPhotosAlbum](./save-image-to-photos-album.md)、[uni.saveVideoToPhotosAlbum](./save-video-to-photos-album.md)、
 

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

@@ -14,6 +14,8 @@
 
 <!-- UTSAPIJSON.getApp.returnValue -->
 
+restart，并非真正的应用整体重启，而是前端wgt应用重启。js引擎会重新初始化，onLaunch会重新触发。但开发者需注意原生插件中重复初始化问题，插件作者应该做好防护。
+
 <!-- UTSAPIJSON.getApp.example -->
 
 ### 全局方法调用@appmethods

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

@@ -17,8 +17,6 @@
 
 - [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调整
@@ -26,7 +24,7 @@
 | 相关 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> - 成功保存后删除临时文件 |
+| `saveFile` / `saveFileSync` | **参数 `filePath`**  <br> - 传入 `null`：默认保存到 `uni.env.USER_DATA_PATH` 目录  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到filePath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br> <br> **返回路径 `savedFilePath`** <br> - 返回绝对路径   | **参数 `filePath`** <br> - 传入 `null` ：默认保存到 `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=`null`, 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> |

package/data/uni-app-x-docs/api/install-wgt.md

@@ -0,0 +1,74 @@
+<!-- UTSAPIJSON.installWgt.name -->
+
+<!-- UTSAPIJSON.installWgt.description -->
+
+wgt，是 uni-app x 的前端资源包。包括uvue、脚本、静态资源。不包括原生插件。
+
+通过在线下载和安装wgt，可以实现相同appid应用的资源替换。
+
+uni-app 的 wgt 是zip格式。uni-app x 的 wgt 是压缩率更高的zstd格式。可以大幅降低热更新带来的cdn成本。
+
+在HBuilder 5.31+ 中对 uni-app x 项目点发行，可看到生成wgt的菜单。由于条件编译的存在，uni-app x 不同平台的 wgt 包是不同的。
+
+推荐使用 [uni升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html) 进行 wgt 发布与更新，它拥有众多优势：
+- 成熟、现成的云端一体升级系统，免去数十工作日的成本
+- 丰富的更新策略：整包更新、热更新，强制更新、静默更新、灰度更新...
+- 更安全：通过sha256验签，防止网络劫持造成的安全隐患
+- 更高性能：客户端的下载、验签、安装全部在独立子线程，不影响前台应用
+- cdn成本更低
+
+<!-- UTSAPIJSON.installWgt.compatibility -->
+
+<!-- UTSAPIJSON.installWgt.param -->
+
+<!-- UTSAPIJSON.installWgt.fileFormats -->
+
+<!-- UTSAPIJSON.installWgt.returnValue -->
+
+<!-- UTSAPIJSON.installWgt.example -->
+
+<!-- UTSAPIJSON.installWgt.tutorial -->
+
+<!-- UTSAPIJSON.installWgt.example -->
+
+### 热更新与应用商店
+
+应用商店可以接受热更新用于修复紧急bug、运营活动调整、部分功能升级。几乎所有大厂App也都有动态化方案。
+
+但应用商店也有底限：
+1. 热更新不能用于改变应用性质，不能用于动态添加违法违规内容，不能用于绕过Apple的iap分成等类似影响应用商店权益的行为。
+2. 确保提交给应用商店审核的包是最新包，不能在审核期间热更新。
+
+额外建议：当开发者发布了热更新后，也应该及时提交应用商店，避免应用刚下载就立即弹升级提示。可以使用[uni多商店上传](https://doc.dcloud.net.cn/uni-app-x/uni-publish/intro.html)，来批量提交应用商店。
+
+### 使用流程
+
+通过wgt包在线升级应用操作流程：
+- 更新版本号： manifest中修改应用版本名称（versionName），要求大于线上已发布的版本名称
+- 生成wgt升级包： 在 HBuilder 中点击菜单 “发行” -> “App-制作wgt包” 导出wgt包  
+- 检测版本更新： 客户端通过 [uni.getAppBaseInfo.appWgtVersion](./get-app-base-info.md) 获取应用资源版本号，与服务器最新版本对比
+- 下载wgt包： 检测到新版本后，通过 [uni.downloadFile](./download-file.md) 从服务器下载wgt包
+- 安装与重启： 调用 `uni.installWgt` 安装wgt包，在安装成功的回调中调用 [getApp().restart](./get-app.md#restart) 重启应用使更新生效
+
+**推荐方案：** 建议直接使用 [升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html) 进行 wgt 发布与更新，可大幅降低开发和测试成本。
+
+### wgt资源与原生底座的匹配
+
+wgt热更新，只能更新前端资源，不能热更新原生底座的原生模块，不能热更新manifest相关内容。需注意前端代码与原生底座的匹配性。
+
+举例，初始的原生包中，未包含map地图模块。如果基于该原生包安装新wgt包，新wgt包中的代码引用了map组件，那么该这部分代码在运行时会报错。
+
+打包时，HBuilder控制台会列出当前打包了哪些模块，默认是根据当前代码使用的模块来摇树决定的。如果要额外添加某些模块，需要在manifest中手动配置，配置后需重新打包才能生效。[详见](../collocation/manifest-modules.md#manual)
+
+开发者可以提前预置一些暂时未使用的模块。也可以在遇到需要更新原生模块的时候，请求用户升级完整包（可以在热更新的时候，也可以在报缺少模块错误的时候）。
+
+### tips  
+
+- **真机运行环境：** 调用 `uni.installWgt` 成功后会直接替换当前运行资源。为了避免出现资源不同步，必须在安装成功的回调中调用 `getApp().restart()` 重启应用或手动关闭重新打开应用。
+- **正式包环境：** 调用 `uni.installWgt` 成功后不会直接替换当前应用资源，新资源仅在重启应用或主动调用 `getApp().restart()` 后生效，不会影响当前正在运行的版本。
+- **测试建议：** wgt包升级测试务必在打包后的正式包环境中进行，不建议仅凭真机运行环境测试。
+
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -48,4 +48,4 @@ uni.showModal({
 	}
 })
 ```
-* `uni.showModal` 是跨平台模态弹框 API。如需在 App iOS 26+ 的蒸汽模式中使用液态玻璃效果，可使用 [uni-glass-modal](https://ext.dcloud.net.cn/plugin?name=uni-glass-modal) 插件（HBuilderX 5.25+）；iOS 26 以下将降级为系统毛玻璃效果。
+* `uni.showModal` 是跨平台模态弹框 API，在App和web平台样式一致。如需在 App iOS 26+ 的蒸汽模式中使用液态玻璃效果，可使用 [uni-glass-modal](https://ext.dcloud.net.cn/plugin?name=uni-glass-modal) 插件（HBuilderX 5.25+）；iOS 26 以下将降级为系统毛玻璃效果。