tmui-cli 2.0.6 → 5.3.2

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

@@ -1,93 +1,148 @@
 # 编译到小程序端
 
-> 新增于 HBuilderX 4.41+
+> HBuilder 4.41 + 支持编译到微信小程序
+> HBuilder 5.31 + 支持编译到支付宝小程序
 
-uni-app x 项目在编译到小程序平台时，将部分特性对齐了web与app端，因此和非uni-app x项目编译到小程序端略有差异。
+## 与 uni-app 相比，uni-app x 编译到小程序有如下不同
+
+### uni-app x 的优势
+1. uni-app x 支持跨平台 Element API 来统一替代 wxs/sjs
+
+   在小程序上开发高性能应用，离不开 wxs/sjs。但 wxs/sjs 难用且不跨平台。\
+   虽然小程序自身不支持 Element 操作，但 uni-app x 提供了全平台的 Element API，并且把这些 API 映射到了小程序的 wxs/sjs 上。\
+   这样即实现了跨平台一致性，又解决了小程序下 wxs/sjs 使用麻烦的问题。
+
+2. 支持样式隔离策略2.0
+
+	老 uni-app 的全局样式、页面样式、组件样式，在不同平台的复用和隔离策略不一样。导致多端拉齐有很多坑。\
+	uni-app x 统一了[样式隔离策略2.0](../css/common/style-isolation.md)。\
+	除了多平台拉齐，[样式隔离策略2.0](../css/common/style-isolation.md)的externalClass机制对组件尤其友好，组件作者不再需要为了让开发者自定义组件样式而封装大量属性了。组件使用者也不再需要为了定制样式而改组件源码或者deep干扰了。\
+	
+3. 减少更多平台差异
+
+	各家小程序，表面规范接近，细节实现差异很大。经常要踩坑，写条件编译。\
+	老 uni-app 的测试例数量不足，很多细节差异官方并没有抹平。\
+	uni-app x 拥有大量细节测试例，为了过测，抹平了很多细节差异。\
+	对于开发者而言，坑变少了，也少写很多条件编译。
+
+整体而言，uni-app x 编写跨端小程序，可以更简单、更一致的做出高性能、代码清晰的小程序。
+
+### 差异
+1. 布局默认使用 flex
+
+小程序的 webview 渲染支持 flex 布局，但默认是 block 布局。\
+uni-app x 中全平台默认使用 flex 布局。\
+如需跨端到App，只能使用 flex 布局。\
+如果不需要App，也可以取消默认的样式重置。[见下](#resetcss)
+
+还有一些开发注意事项，详见下文。
+
+### 问题
+
+uni-app x 目前仅支持微信小程序和支付宝小程序。其他主流小程序还在陆续适配。一些自身已经停维的小程序平台可能 uni-app x 不再会支持。
 
-与uni-app相比，uni-app x编译到微信小程序有2个显著差别：
-1. uni-app x 支持 Element API
-在微信小程序上开发高性能应用，离不开wxs。但wxs难用且不跨平台。\
-虽然微信小程序自身不支持Element操作，但uni-app x提供了跨平台的Element API，并且把这些API映射到了微信小程序的wxs上。\
-这样即实现了跨平台一致性，又解决了微信下wxs使用麻烦的问题。
-2. 布局全面使用flex
-小程序的webview渲染支持flex布局，但默认是block布局。\
-uni-app x中全平台统一使用flex布局。
 
 ## 基础库范围
-截止到HBuilderX 4.41发版时微信的主流基础库版本是3.7.1。
-uni-app x主要是在这个版本库上适配。
-已知过老的基础库版本上，scroll-view区域大小会不准确。请开发者检查并确保基础库版本大于3.7.1。
+
+截止到 HBuilder 4.41 发版时微信的主流基础库版本是 3.7.1。
+
+截止到 HBuilder 5.31 发版时支付宝小程序的主流基础库版本是 2.10.38。
+
+uni-app x 是在上述版本库上适配的。
 
 ## vue
 
-### 自定义组件启用virtualHost带来的影响@virtualHost
+### 自定义组件启用 virtualHost 带来的影响@virtualHost
 
-标准的小程序下的自定义组件会多套一层DOM，这影响性能且更会影响flex等样式传递。而uni-app x默认都是flex的。
+标准的小程序下的自定义组件会多套一层 DOM，这影响性能且更会影响 flex 等样式传递。而 uni-app x 默认都是 flex 的。
 
-所以为了拉齐样式表现，uni-app x 项目在编译到小程序时，默认启用了virtualHost，该配置是小程序平台提供的一种策略，可以取消多套的一层。\n
-同时默认启用了[mergeVirtualHostAttributes特性](https://uniapp.dcloud.net.cn/collocation/manifest.html#mp-weixin)，在取消多套的一层后，将原本父层的属性设置，合并到子层。
+所以为了拉齐样式表现，uni-app x 项目在编译到小程序时，默认启用了 virtualHost，该配置是小程序平台提供的一种策略，可以取消多套的一层。\n
+同时默认启用了[mergeVirtualHostAttributes 特性](https://uniapp.dcloud.net.cn/collocation/manifest.html#mp-weixin)，在取消多套的一层后，将原本父层的属性设置，合并到子层。
 
-`去掉一层`以及`合并父属性到子`，这2件事会对真实渲染的DOM产生影响。*尤其会影响在组件外获取组件的DOM*。
+`去掉一层`以及`合并父属性到子`，这 2 件事会对真实渲染的 DOM 产生影响。_尤其会影响在组件外获取组件的 DOM_。
 
 我们先看一个例子：
 
-有个组件c1，父级外层代码如下
+有个组件 c1，父级外层代码如下
+
 ```html
 <c1 id="c1parent" ref="c1ref" class="class1parent"></c1>
 ```
 
-c1组件的代码如下：
+c1 组件的代码如下：
+
 ```html
 <template>
-    <view class="classchild">
-    </view>
+  <view class="classchild"> </view>
 </template>
 ```
 
-然后看下mergeVirtualHostAttributes属性合并策略（HBuilderX 4.42+）：
-1. 仅将组件外层设置的 id、style、class 以及 v-show 指令生成的 hidden 属性，这4个属性合并到 vue 组件编译成的小程序组件根节点上，其他外层设置的属性都丢弃了。
+然后看下 mergeVirtualHostAttributes 属性合并策略（HBuilder 4.42+）：
+
+1. 仅将组件外层设置的 id、style、class 以及 v-show 指令生成的 hidden 属性，这 4 个属性合并到 vue 组件编译成的小程序组件根节点上，其他外层设置的属性都丢弃了。
 2. 仅对组件是单个根节点才会合并，组件内多个根节点的时候不会合并。父层全部丢弃。
 
-根据策略看，上述代码在运行时合并后，父层的id、class属性合并到组件根节点上，所以`class1parent` 和 `classchild` 同时生效。
+根据策略看，上述代码在运行时合并后，父层的 id、class 属性合并到组件根节点上，所以`class1parent` 和 `classchild` 同时生效。
+
+父层通过`uni.createSelectorQuery().in(this.$page).select('#c1parent')`拿不到 NodesRef。
+
+但 createSelectorQuery 是支持设定查找范围的，上面的代码是在页面里查找，如果在父层代码里通过 in 方法指定查找组件，例如：`uni.createSelectorQuery().in(this.$refs['c1ref'] as ComponentPublicInstance).select('#c1parent') `，可以拿到 c1 组件的 NodesRef
+
+父层通过`uni.getElementById("c1parent")`也可以拿到 UniElement。
+
+实际上，不管是通过`.class1parent` 还是 `.classchild`，都可以拿到。因为样式合并后，这 2 个 class 在运行时同时存在。
+
+vue 组件的方法调用不受影响，ref 取到组件后，可以直接调用组件的方法。
 
-父层通过`uni.createSelectorQuery().in(this.$page).select('#c1parent')`拿不到NodesRef。
+### v-bind="$attrs" 属性透传@v-bind-attrs
 
-但createSelectorQuery是支持设定查找范围的，上面的代码是在页面里查找，如果在父层代码里通过in方法指定查找组件，例如：`uni.createSelectorQuery().in(this.$refs['c1ref'] as ComponentPublicInstance).select('#c1parent') `，可以拿到c1组件的NodesRef
+在 `view` 等内置组件上，可以通过 `v-bind="$attrs"` 将 `$attrs` 中的属性和事件显式绑定到该内置组件。
 
-父层通过`uni.getElementById("c1parent")`也可以拿到UniElement。
+```vue
+<template>
+  <view v-bind="$attrs"></view>
+</template>
+```
+
+小程序目前仅支持向内置组件透传以下内容：
 
-实际上，不管是通过`.class1parent` 还是 `.classchild`，都可以拿到。因为样式合并后，这2个class在运行时同时存在。
+- `id`
+- `class`
+- `style`
+- `click` 事件
 
-vue组件的方法调用不受影响，ref取到组件后，可以直接调用组件的方法。
+其他属性和事件不会通过 `v-bind="$attrs"` 透传。上述转换仅作用于内置组件节点，将 `v-bind="$attrs"` 写在自定义组件节点上不会进行上述展开。
+
+当内置组件同时声明了 `class`、`style` 或 `@click` 时，透传内容会与本地声明合并，并按照模板中的声明顺序生效。
 
 ### refs@refs
 
-非 uni-app x 项目使用refs取内置组件引用时会获取到undefined，而 uni-app x 项目会获取到对应的UniElement。
+非 uni-app x 项目使用 refs 取内置组件引用时会获取到 undefined，而 uni-app x 项目会获取到对应的 UniElement。
 
 ## dom
 
 ### UniElement
 
-小程序端逻辑层与视图层分离，导致大多数同步的dom api都不可用。
+小程序端逻辑层与视图层分离，导致大多数同步的 dom api 都不可用。
 
-UniElement在小程序端仅支持如下属性/方法：
+UniElement 在小程序端仅支持如下属性/方法：
 
-- id 元素的id属性
+- id 元素的 id 属性
 - nodeName 元素的节点名
 - tagName 元素的标签名
-- style 元素的style对象，可以通过style对象调用style.setProperty方法
+- style 元素的 style 对象，可以通过 style 对象调用 style.setProperty 方法
 - getBoundingClientRectAsync 异步获取元素的布局位置信息
-- getAttribute 获取元素的属性值，目前仅支持id、style
+- getAttribute 获取元素的属性值，目前仅支持 id、style
 
 **注意**
 
-- 小程序端只有UniElement，不支持UniButtonElement、UniViewElement等类
-- 小程序端在各种事件在target、currentTarget指向未配置id的组件时，event.target、event.currentTarget会返回一个功能缺失的UniElement，仅能访问dataset、offsetTop、offsetLeft属性。
-- 小程序端在各种事件在target、currentTarget指向配置了id的组件时，event.target、event.currentTarget会返回一个功能和getElementById一致的UniElement，除了能访问getElementById返回的UniElement的各种属性方法之外，还能访问dataset、offsetTop、offsetLeft属性。
+- 小程序端只有 UniElement，不支持 UniButtonElement、UniViewElement 等类
+- 小程序端在各种事件在 target、currentTarget 指向未配置 id 的组件时，event.target、event.currentTarget 会返回一个功能缺失的 UniElement，仅能访问 dataset、offsetTop、offsetLeft 属性。
+- 小程序端在各种事件在 target、currentTarget 指向配置了 id 的组件时，event.target、event.currentTarget 会返回一个功能和 getElementById 一致的 UniElement，除了能访问 getElementById 返回的 UniElement 的各种属性方法之外，还能访问 dataset、offsetTop、offsetLeft 属性。
 
 ### 事件
 
-click、tap事件上补充了如下属性，使其表现更像PointerEvent：
+click、tap 事件上补充了如下属性，使其表现更像 PointerEvent：
 
 ```
 event.x
@@ -102,35 +157,38 @@ event.screenY
 
 ## css
 
-### 样式重置
+### 样式重置@resetcss
 
-App平台的ucss和webview的标准css略有差异。为保证多端统一，uni-app-x编译到小程序端时，会进行浏览器样式重置，内置组件根元素带有一些默认样式，详情参考：[uvue css使用](../css/README.md)。
+App 平台的 ucss 和 webview 的标准 css 略有差异。为保证多端统一，uni-app-x 编译到小程序端时，会进行浏览器样式重置，内置组件根元素带有一些默认样式，详情参考：[uvue css 使用](../css/README.md)。
 
-如果你不开发App，且不需要样式重置，想使用原始的小程序样式，那么可以在pages.json的globalStyle或对应的页面style内配置`enableUcssReset`为false来关闭ucss样式重置。参考：[page.json文档](../collocation/pagesjson.md)
+如果你不开发 App，且不需要样式重置，想使用原始的小程序样式，那么可以在 pages.json 的 globalStyle 或对应的页面 style 内配置 `enableUcssReset` 为 false 来关闭 ucss 样式重置。参考：[page.json 文档](../collocation/pagesjson.md)
 
-## skyline
+## 微信小程序 skyline
 
-对skyline的支持处于实验阶段。
+对 skyline 的支持处于实验阶段。
 
-目前编译器会根据页面是否为skyline来决定是否注入ucss样式覆盖，仅webview渲染的页面才会进行ucss样式覆盖。
+目前编译器会根据页面是否为 skyline 来决定是否注入 ucss 样式覆盖，仅 webview 渲染的页面才会进行 ucss 样式覆盖。
 
-worklet函数暂不支持写在uvue、uts文件内，推荐从js文件内引用。
+worklet 函数暂不支持写在 uvue、uts 文件内，推荐从 js 文件内引用。
 
 ## 其他差异
 
 ### 文件命名
+
 页面或组件目录下，不能使用与 `uvue` 同名的 `uts` 文件。\
-小程序端 `uvue` 文件会被编译为同名的 `js、json、wxml、wxss` 文件，如果存在同名 `uts` 文件，会导致冲突。
+小程序端 `uvue` 文件会被编译为同名的 `js、json、wxml/axml、wxss/acss` 文件，如果存在同名 `uts` 文件，会导致冲突。
 
 ### 实体字符
 
-uni-app x项目在编译到小程序端时，如果页面内静态的使用了实体字符`&gt;、&lt;、&thinsp;、&nbsp;、&ensp;、&emsp;`则会在最终输出的小程序页面文件中保留这些实体字符，例如`&nbsp;`在微信小程序的wxml文件中仍为`&nbsp;`不会被转为空格， 而非uni-app-x项目`&nbsp;`会转为空格。
+uni-app x 项目在编译到小程序端时，如果页面内静态的使用了实体字符`&gt;、&lt;、&thinsp;、&nbsp;、&ensp;、&emsp;`则会在最终输出的小程序页面文件中保留这些实体字符，例如`&nbsp;`在小程序的 wxml/axml 文件中仍为`&nbsp;`不会被转为空格， 而非 uni-app-x 项目`&nbsp;`会转为空格。
+
+### 微信小程序注意事项@mp-weixin
 
-### radio、checkbox组件使用justify-content等属性对齐插槽内容与选择框时与app、web表现不一致
+#### radio、checkbox 组件使用 justify-content 等属性对齐插槽内容与选择框时与 app、web 表现不一致
 
 > 此表现后续可能会调整，请勿依赖此特性进行布局
 
-由于小程序端radio、checkbox组件内部有一层额外节点，如下属性设置在根节点上不能按预期方式布局插槽内容与选择框
+由于小程序端 radio、checkbox 组件内部有一层额外节点，如下属性设置在根节点上不能按预期方式布局插槽内容与选择框
 
 ```
 flex-direction
@@ -143,13 +201,10 @@ align-items
 
 编译到支付宝小程序时需注意以下平台差异：
 
-- `scroll-view` 不支持通过 `slot="refresher"` 自定义下拉刷新内容，相关内容需通过条件编译排除支付宝小程序。
-- `radio`、`checkbox` 不支持将文本或 `text` 组件放在组件内部。选项文本应与 `radio`、`checkbox` 作为同级节点放置，通常可使用 `label` 包裹同级的选项组件和文本。
-- 同一页面存在多个 `page-container` 时，第二个及后续打开的 `page-container` 可能无法弹出，建议同一页面只保留一个 `page-container`。
-- `native-view` 暂不支持支付宝小程序，使用时需通过条件编译排除支付宝小程序。
-- `picker` 不支持 `mode` 属性，如需多平台兼容，需要为支付宝小程序单独处理选择能力。
-- `picker-view` 动态设置指示器样式时可能出现偏移，建议使用静态配置，避免运行时修改指示器样式。
+- 组件和 API 的支付宝平台限制请参阅对应组件和API文档
+- 支付宝小程序支持暗黑模式，需要通过 `themeLocation` 指定 `theme.json`，详见[暗黑主题适配教程](../api/theme-change.md)。
+- 支付宝小程序不支持完全自定义导航栏，`navigationStyle: "custom"` 不生效，详见[pages.json 页面配置](../collocation/pagesjson.md)。
 
 ## 开发和调试
 
-在HBuilderX底部状态栏选择语法平台，确保有微信小程序平台，否则代码提示不会有微信专有API。如果选择其他平台，但代码里在非MP-WEIXIN的条件编译里写了微信专有代码，ide会告警。
+在 HBuilder 底部状态栏选择语法平台，确保有指定的小程序平台，否则代码提示不会有该小程序专有 API。如果选择其他平台，但代码里在非当前小程序的条件编译里写了其他小程序平台专有代码，ide 会告警。

package/data/uni-app-x-docs/mp/native-component-and-wxs.md

@@ -138,7 +138,7 @@ export default {
 <!-- #ifdef MP-WEIXIN -->
 <script src="./utils.wxs" module="utils" lang="wxs"></script>
 <!-- #endif -->
-<script setup lang="uts">
+<script setup>
   const title = ref('标题')
 </script>
 

package/data/uni-app-x-docs/native/download/android.md

@@ -103,30 +103,24 @@
 
 ## alpha版
 
-### 5.26.2026091402-alpha
+### 5.32.2026101609-alpha
 
-**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101163-5.26.zip)**
+**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101337-5.32.zip)**
 
-**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15075-5.26.zip)**
+**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15157-5.32.zip)**
+
+* 更新uni-app离线打包支持，需使用HBuilderX（5.32.2026101609-alpha）版本生成本地打包App资源。
+* 新增 组件 ad-drama 短剧组件 [文档](https://doc.dcloud.net.cn/uni-app-x/api/create-drama-ad.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32816>
+* 修复 组件 camera 部分情况可能引起内存泄漏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=22660)
+* 蒸汽模式 新增 组件 uniCloud 支持组合式定义datacom [文档](https://doc.dcloud.net.cn/uni-app-x/api/unicloud/) <https://issues.dcloud.net.cn/pages/issues/detail?id=33522>
+* 蒸汽模式 新增 API uni.convert2AbsFullPath 将相对路径转换为平台的绝对路径地址 [文档](https://doc.dcloud.net.cn/uni-app-x/api/convert2-abs-full-path.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=33471>
+* 蒸汽模式 修复 组件 waterflow 超高flow-item部分情况不显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33511)
+* 蒸汽模式 修复 CSS animation 使用 calc() 设置的长度值无动画效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33455)
+* 蒸汽模式 修复 DOM API UniElement animate 方法在同一元素创建多个动画无法并行运行，创建新动画会中断正在执行的其他动画 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33577)
+* 蒸汽模式 修复 API uni.installWgt 安装合法 wgt 报 103610 错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33639)
+* 蒸汽模式 修复 API uni.getFileSystemManager fstat、stat回调内的Stat实例无法调用isFile、isDirectory方法 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33568)
 
-* 更新uni-app离线打包支持，需使用HBuilderX（5.26.2026091402-alpha）版本生成本地打包App资源。
-* 蒸汽模式 修复 组件 scroll-view 容器或内容变化引发的滚动不会触发scrollend事件 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32611)
-* 蒸汽模式 修复 组件 list-view list-item高度变成0时未重排后续item位置 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32592)
-* 蒸汽模式 修复 组件 list-view initial-scroll-bottom属性部分情况下未将初始位置滚动到底部 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32614)
-* 蒸汽模式 修复 组件 list-view 滚动期间及滚动结束瞬间概率出现闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32910)
-* 蒸汽模式 修复 组件 list-view 开启 scroll-anchoring 后追加消息可能出现白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32913)
-* 蒸汽模式 修复 组件 text 嵌套 text 上使用 v-if 或 v-for 时可能无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32539)
-* 蒸汽模式 修复 组件 rich-text 设置 translateY 后可能内容显示不完整 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32820)
-* 蒸汽模式 修复 5.25版本引发的 组件 rich-text 页面滚动到页面上边缘偶现闪白 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32911)
-* 蒸汽模式 修复 组件 image 没有设置 fade-show 加载网络图片首次显示会有渐变动画效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32762)
-* 蒸汽模式 修复 5.25版本引发的 组件 画布 2D 绘制指令全部执行成功但画布始终空白不上屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32730)
-* 蒸汽模式 修复 API uni.exit 执行 redirectTo 后可能无法正常退出显示白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32768)
-* 蒸汽模式 修复 5.25版本引发的 API uni.getUniVerifyManager 调用报 `parameters length error` 错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32757)
-### uts插件
-* 蒸汽模式 修复 字面量.toFloat方式声明的变量被编译为了Number类型 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32906)
-* 蒸汽模式 修复 5.25版本引发的 uts插件导出的常量不能被页面组件引用 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32903)
-* 蒸汽模式 修复 5.25版本引发的 暴露给页面组件调用的class上含可为空的function类型属性时编译报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32624)
 
 **[历史版本](https://pan.baidu.com/s/1OXvFjfGW6zDAyzTZGpY7hQ?pwd=aa2c)**
  
-**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091402-alpha.html)**
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.32.2026101609-alpha.html)**

package/data/uni-app-x-docs/native/download/ios.md

@@ -18,15 +18,15 @@
 
 ## alpha版
 
-### 5.26.2026091402-alpha
+### 5.32.2026101609-alpha
 
-[点击下载蒸汽模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS-Vapor/UniAppXSDK-iOS-Vapor@5.26.zip)
+[点击下载蒸汽模式SDK](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS-Vapor/UniAppXSDK-iOS-Vapor@5.32.zip)
 
-[点击下载 VDOM 模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS/UniAppX-iOS%405.26.zip)
+[点击下载 VDOM 模式SDK](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS/UniAppX-iOS%405.32.zip)
 
-+ [更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091402-alpha.html)
++ [更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.32.2026101609-alpha.html)
 
 
 **[历史版本](https://pan.baidu.com/s/130Rvlh2jdsp3aJ4YtigoJQ?pwd=xy7s)**
  
-**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.25.2026082902-alpha.html)**
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.31.2026093020-alpha.html)**

package/data/uni-app-x-docs/native/modules/android/others.md

@@ -1374,6 +1374,21 @@ dependencies {
 
 :::
 
+### uni-install-wgt
+
+<table>
+  <tr><th>属性</th><th>内容</th></tr>
+  <tr><td>本地依赖库</td><td>uni-install-wgt-release.aar</td></tr>
+  <tr><td>依赖的模块</td><td>uni-fileSystemManager<br/>uni-zstd-decompress</td></tr>
+</table>
+
+### uni-zstd-decompress
+
+<table>
+  <tr><th>属性</th><th>内容</th></tr>
+  <tr><td>本地依赖库</td><td>uni-zstd-decompress-release.aar</td></tr>
+</table>
+
 <!--
 ### uni-uasm
 

package/data/uni-app-x-docs/native/modules/harmony/facialVerify.md

@@ -15,9 +15,9 @@
 在uni_modules入口文件`index.generated.ets`内注册实人认证api。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { startFacialRecognitionVerify, getFacialRecognitionMetaInfo } from '@uni_modules/uni-facialverify'
 
 export function initUniModules() {
@@ -29,9 +29,9 @@ function initUniExtApi() {
   uni.getFacialRecognitionMetaInfo = getFacialRecognitionMetaInfo
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 import { startFacialRecognitionVerify, getFacialRecognitionMetaInfo } from '@uni_modules/uni-facialverify'
 
 export function initUniModules() {
@@ -43,5 +43,5 @@ function initUniExtApi() {
   uni.getFacialRecognitionMetaInfo = getFacialRecognitionMetaInfo
 }
 ```
-
+:::
 

package/data/uni-app-x-docs/native/modules/harmony/location.md

@@ -17,9 +17,9 @@
 在uni_modules入口文件`index.generated.ets`内注册系统定位api。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from '@dcloudio/uni-app-x-runtime'
+import { registerUniProvider, uni } from '@dcloudio/uni-app-x-vapor-runtime'
 import { UniLocationSystemProviderImpl } from '@uni_modules/uni-location-system'
 
 export function initUniModules() {
@@ -29,9 +29,9 @@ function initUniExtApi() {
   registerUniProvider('location', 'system', new UniLocationSystemProviderImpl())
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from '@dcloudio/uni-app-x-vapor-runtime'
+import { registerUniProvider, uni } from '@dcloudio/uni-app-x-runtime'
 import { UniLocationSystemProviderImpl } from '@uni_modules/uni-location-system'
 
 export function initUniModules() {
@@ -41,3 +41,4 @@ function initUniExtApi() {
   registerUniProvider('location', 'system', new UniLocationSystemProviderImpl())
 }
 ```
+:::

package/data/uni-app-x-docs/native/modules/harmony/map.md

@@ -28,9 +28,9 @@
 在uni_modules入口文件`index.generated.ets`内注册腾讯地图api。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { createMapContext } from '@uni_modules/uni-map-tencent'
 import { UniMapElement } from '@uni_modules/uni-map-tencent'
 import * as uniMapTencent from '@uni_modules/uni-map-tencent'
@@ -45,9 +45,9 @@ function initUniExtApi() {
   globalThis.UniMapElement = UniMapElement
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 import { createMapContext } from '@uni_modules/uni-map-tencent'
 import { UniMapElement } from '@uni_modules/uni-map-tencent'
 import * as uniMapTencent from '@uni_modules/uni-map-tencent'
@@ -61,4 +61,5 @@ function initUniExtApi() {
   uni.createMapContext = createMapContext
   globalThis.UniMapElement = UniMapElement
 }
-```
+```
+:::

package/data/uni-app-x-docs/native/modules/harmony/oauth.md

@@ -19,9 +19,9 @@ OAuth模块提供了第三方登录的能力。
 在uni_modules入口文件`index.generated.ets`内注册华为登录provider。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { UniOAuthHuaweiProviderImpl } from '@uni_modules/uni-oauth-huawei'
 
 export function initUniModules() {
@@ -32,9 +32,9 @@ function initUniExtApi() {
   registerUniProvider('oauth', 'huawei', new UniOAuthHuaweiProviderImpl())
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 import { UniOAuthHuaweiProviderImpl } from '@uni_modules/uni-oauth-huawei'
 
 export function initUniModules() {
@@ -44,4 +44,5 @@ export function initUniModules() {
 function initUniExtApi() {
   registerUniProvider('oauth', 'huawei', new UniOAuthHuaweiProviderImpl())
 }
-```
+```
+:::

package/data/uni-app-x-docs/native/modules/harmony/pay.md

@@ -17,9 +17,9 @@
 在uni_modules入口文件`index.generated.ets`内注册支付宝支付provider。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { UniPaymentAlipayProviderImpl } from '@uni_modules/uni-payment-alipay'
 
 export function initUniModules() {
@@ -30,9 +30,9 @@ function initUniExtApi() {
   registerUniProvider('payment', 'alipay', new UniPaymentAlipayProviderImpl())
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 import { UniPaymentAlipayProviderImpl } from '@uni_modules/uni-payment-alipay'
 
 export function initUniModules() {
@@ -62,9 +62,9 @@ function initUniExtApi() {
 在uni_modules入口文件`index.generated.ets`内注册微信支付provider。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { UniPaymentWxpayProviderImpl } from '@uni_modules/uni-payment-wxpay'
 export function initUniModules() {
   initUniExtApi();
@@ -73,9 +73,9 @@ function initUniExtApi() {
   registerUniProvider('payment', 'wxpay', new UniPaymentWxpayProviderImpl())
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 import { UniPaymentWxpayProviderImpl } from '@uni_modules/uni-payment-wxpay'
 export function initUniModules() {
   initUniExtApi();

package/data/uni-app-x-docs/native/modules/harmony/push.md

@@ -38,9 +38,9 @@
 在uni_modules入口文件`index.generated.ets`内注册uni-push api。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { uni } from "@dcloudio/uni-app-x-runtime";
+import { uni } from "@dcloudio/uni-app-x-vapor-runtime";
 import { getPushClientId,onPushMessage,offPushMessage,createPushMessage,setAppBadgeNumber } from '@uni_modules/uni-push'
 
 export function initUniModules() {
@@ -55,9 +55,9 @@ function initUniExtApi() {
   uni.setAppBadgeNumber = setAppBadgeNumber
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { uni } from "@dcloudio/uni-app-x-runtime";
 import { getPushClientId,onPushMessage,offPushMessage,createPushMessage,setAppBadgeNumber } from '@uni_modules/uni-push'
 
 export function initUniModules() {
@@ -71,4 +71,5 @@ function initUniExtApi() {
   uni.createPushMessage = createPushMessage
   uni.setAppBadgeNumber = setAppBadgeNumber
 }
-```
+```
+:::

package/data/uni-app-x-docs/native/modules/harmony/verify.md

@@ -13,9 +13,9 @@
 在uni_modules入口文件`index.generated.ets`内注册一键登录api。
 
 ::: preview
-> VDOM模式
+> 蒸汽模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
 
 import { getUniVerifyManager } from '@uni_modules/uni-verify'
 
@@ -28,9 +28,9 @@ function initUniExtApi() {
   uni.getUniVerifyManager = getUniVerifyManager
 }
 ```
-> 蒸汽模式
+> VDOM模式
 ```typescript
-import { registerUniProvider, uni } from "@dcloudio/uni-app-x-vapor-runtime";
+import { registerUniProvider, uni } from "@dcloudio/uni-app-x-runtime";
 
 import { getUniVerifyManager } from '@uni_modules/uni-verify'
 
@@ -42,4 +42,5 @@ export function initUniModules() {
 function initUniExtApi() {
   uni.getUniVerifyManager = getUniVerifyManager
 }
-```
+```
+:::

package/data/uni-app-x-docs/native/use/android.md

@@ -53,7 +53,7 @@ uni-dialogPage-release.aar，uni-event-release.aar，uni-crash-release.aar，uni
 uni-storage-release.aar，uni-exit-release.aar，uni-theme-release.aar，
 uni-getAppBaseInfo-release.aar，uni-getDeviceInfo-release.aar，uni-getSystemInfo-release.aar，uni-getAccessibilityInfo-release.aar，
 uni-getAppAuthorizeSetting-release.aar，uni-getSystemSetting-release.aar，
-uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-rpx2px-release.aar，uni-secure-network-release.aar共23个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图：
+uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-rpx2px-release.aar，uni-secure-network-release.aar，uni-uasm-release.aar，uni-convert2AbsFullPath-release.aar(HBuilder 5.31+)共25个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图：
 
 ![](https://web-ext-storage.dcloud.net.cn/native/doc/android/main_libs_vapor_v2.png)
 
@@ -62,7 +62,7 @@ uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-rpx2px-re
 将uts-runtime-release.aar，android-gif-drawable-1.2.28.aar，app-common-release.aar，app-runtime-release.aar，breakpad-build-release.aar，dcloud-layout-release.aar，
 framework-release.aar，uni-exit-release.aar，uni-getAccessibilityInfo-release.aar，uni-getAppAuthorizeSetting-release.aar，uni-getAppBaseInfo-release.aar，
 uni-getSystemSetting-release.aar，uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-storage-release.aar，uni-getDeviceInfo-release.aar，
-uni-getSystemInfo-release.aar，uni-rpx2px-release.aar，uni-theme-release.aar共19个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图。
+uni-getSystemInfo-release.aar，uni-rpx2px-release.aar，uni-theme-release.aar，uni-convert2AbsFullPath-release.aar共20个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图。
 
 ![](https://web-ext-storage.dcloud.net.cn/native/doc/android/main_libs_2.jpg)
 
@@ -517,6 +517,8 @@ uts插件资源位于`unpackage/resource/app-android/uni_modules`下。如果uni
 - uni-event
 - uni-getElementById
 - uni-pullDownRefresh
+- uni-uasm
+- uni-convert2AbsFullPath
 
 ::: details VDOM模式
 
@@ -533,6 +535,7 @@ uts插件资源位于`unpackage/resource/app-android/uni_modules`下。如果uni
 - uni-storage
 - uni-rpx2px
 - uni-theme
+- uni-convert2AbsFullPath
 
 :::