tmui-cli 2.0.5 → 5.3.1

package/data/uniappx/tabbar.md

@@ -0,0 +1,65 @@
+title: tmui 3.2.0 组件库
+
+#### 导航组件
+
+# 底部导航 TmTabbar
+
+可定义凸起按钮。通过全局状态设置选中项，放于任何页面可自动选中。
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/tabbar.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| color | string | '#b9b9b9' | 未选中时的颜色 | 
+| selectedColor | string | '' | 选中时的颜色，空值取全局主题 | 
+| bgColor | string | 'white' | 背景,如果你为空，会读取全局的亮色tabbar背景 | 
+| darkBgColor | string | '' | 暗黑时的背景，如果为空，取全局的底部导航背景色。 | 
+| showTopBorder | boolean | true | 显示顶部边线，暗黑时取全局的borderDarkColor | 
+| borderColor | string | '#f0f0f0' | 边线颜色 | 
+| fontSize | string | '11px' | 文字大小 | 
+| iconSize | string | '28px' | 图标大小 | 
+| autoTabbarHeight | number | 0 | 导航的整体高度，请使用v-model:autoTabbarHeight="x"来获取当前的高度。外部要去变更值。这个只是对外输出，给您外部放在底部占位用，省得你们要一屏时计算高。外部最好computed使用，因为是异步的 | 
+| outIndex | number | 2 | 需要向外凸起的项目索引。-1表示不凸起 | 
+| outBgColor | string | 'primary' | 凸起的背景色 | 
+| outIconColor | string | 'white' | 凸起的图标颜色 | 
+| position | string | 'fixed' | 是否悬浮在底部,不可动态修改fixed悬浮，relative静态布局。 | 
+| linearGradient | Array | ()=\>[]asstring[] | 渐变背景，如果提供，上面的背景和暗黑背景将失效。仅支持:tobottom,toright,toleft,totop例：['toright','#ff667f','#ff5416'] | 
+| list | Array | ()=\>[]asTM.TABBAR_ITEM_INFO[] | 如果你提供了本地的list数据，那么全局的list将不会被采用，你需要自己管理激活引，跨页面时需要你自己设置当前页面的索引，因为变量索引是无法跨页面的。 | 
+| activeIndex | number | -1 | 当前激活的索引,双向绑定用vmodel:activeIndex | 
+| zIndex | number | 20 | 层级 | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| change | 名称：index,当前选中的索引, | - | 切换项目时触发。 | 
+| update:autoTabbarHeight | 名称：height,当前组件高度, | - | 同步组件高给外部使用，请使用v-model:autoTabbarHeight
+组件高度 = 安全栏高度 + 导航栏高度,外部最好computed使用，因为是异步的 | 
+| update:activeIndex | 名称：activeIndex,当前组件高度, | - | 同步当前索引 | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| out | 名称：binding,active 类型：- 
+名称：binding,size 类型：- 
+ | - | 
+| item | 名称：binding,activeindex 类型：- 
+名称：binding,children 类型：- 
+名称：binding,isactive 类型：- 
+名称：binding,selfindex 类型：- 
+ | - | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/tabs.md

@@ -0,0 +1,66 @@
+title: tmui 3.2.0 组件库
+
+#### 导航组件
+
+# 标签导航 TmTabs
+
+tabs标签导航组件,样式非常丰富可以完成你想要的自定义样式.
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/tabs.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| round | string\|number | 0 | 圆角 | 
+| width | string\|number | 'auto' | 宽 | 
+| height | string\|number | '88' | 高是必填，不可为auto。 | 
+| mode | string | 'start' | 排版模式around:居中并且均分[数据多时会造成无法滚动]between:均分在整个宽上(如想相项目宽一样,你可以设置属性width比如你有3个可以设置为33%)[数据多时会造成无法滚动]start:左对齐[数据多时可滚动]end:右对齐[数据多时可滚动]center:中间对齐[数据多时会造成无法滚动] | 
+| color | string | 'white' | 背景 | 
+| darkColor | string | '' | 暗黑时的背景,如果不填写读取sheetDark | 
+| activeTitleColor | string | '' | 文本激活时的颜色，空值默认取全局主题色 | 
+| titleColor | string | '#888888' | 文本默认颜色 | 
+| darkTitleColor | string | '#cacaca' | 文本默认的暗黑颜色，如果不填写取白色。 | 
+| lineColor | string | '' | 底部线条激活时的颜色，空值默认取全局主题色 | 
+| lineHeight | string | '3px' | - | 
+| lineFull | boolean | false | 底部的线条是与项目等宽还是固定默认的小宽度。 | 
+| showLine | boolean | true | 是否显示底部的线条 | 
+| modelValue | string\|number | 0 | id值，如果数据没有提供id属性，这里的id就是索引等同v-model | 
+| fontSize | string\|number | '30' | 标题字号 | 
+| activeFontSize | string\|number | '32' | 激活时的标题字号 | 
+| itemWidth | string\|number | 'auto' | 项目宽度，默认是auto，即自动根据标题内容自动撑开宽度。如果你想均分（适合不超过一行），比如你有5个标签，那么你就可以设置为"20%" | 
+| titlePadding | string\|number | '12px' | 标题的padding是左右的间隙。 | 
+| moveCount | number | 2 | 已废弃：激活项会按可视区域自动居中（两端滚动量不足时不强制居中）。保留该属性仅为兼容旧用法，不再参与滚动计算。 | 
+| gap | string\|number | 20 | 项目之间的间隙.如果你设定了itemwidth一般会有富余宽,两边自然有间隙,此时你应该设置为0以免造成不居中的假象. | 
+| list | Array\<Record\<string, any\> \| string\> | ()=\>[] | 数据数组,可以混合类型可以是单类型数据格式比较灵活.如果数据是对象且出现了dot:true该项数组右上角出现角标红点如果dot:非boolean比如:dot:32会出现数字角标或者文本角标.如果为false或者空值为隐藏如果出现了disabled:可以true禁止项目 | 
+| rangKey | string | 'title' | 当你的list为对象时可用如果数据是string会直接取数据本身 | 
+| rangId | string | 'id' | id标识,用来vmodel双向绑定选中的值,如果你的list中不存在或者没有id标识那么取数组循环的索引值 | 
+| rangDot | string | 'dot' | 读取角标的标识字段,默认是dot | 
+| dotBgColor | string | '' | 角标的背景,默认是等同激活的标题颜色如果填写使用本值,文字颜色始终是白的. | 
+| customItemStyle | string | '' | 默认的自定项目的style样式,可以用来完全覆盖默认的样式. | 
+| activeItemStyle | string | '' | 默认的激活自定项目的style样式,可以用来完全覆盖默认的样式. | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| change | - | - | 变化时触发 | 
+| update:modelValue | - | - | 同步vmodel | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| toggleActivate | - | - | - |

package/data/uniappx/tag.md

@@ -0,0 +1,60 @@
+title: tmui 3.2.0 组件库
+
+#### 常用组件
+
+# 标签 TmTag
+
+标签组件,用来展示一些标签信息.
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/tag.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| size | string | "n" | 尺寸大小,可选值：s/m/n/g/xs | 
+| skin | string | "normal" | 样式可选值：thin/outlined/text/normal/dashed | 
+| borderColor | string\|Array\<string\> | "" | 遵循规则：string或者[x]：全部边线[x,x]左右边线，上下边线[x,x,x]左，上，右[x,x,x,x]左，上，右,下 | 
+| darkBorderColor | string\|Array\<string\> | "transparent" | - | 
+| borderWidth | string\|number\|Array\<string \| number\> | 1 | 规则同borderColor | 
+| borderStyle | string\|Array\<string\> | "solid" | 规则同borderColor | 
+| round | string\|number\|Array\<string \| number\> | '10' | 圆角半径左上，右上，右下，左下 | 
+| width | string\|number | "" | - | 
+| height | string\|number | "" | - | 
+| openType | string | "" | - | 
+| disabled | boolean | false | - | 
+| icon | string | "" | - | 
+| iconSize | string | "" | - | 
+| fontSize | string | "" | - | 
+| color | string | "" | 自定义主题颜色 | 
+| bgColor | string | "" | 自定义背景 | 
+| darkBgColor | string | "" | - | 
+| fontColor | string | "" | - | 
+| darkFontColorColor | string | "" | - | 
+| linear | string[] | ()=\>[] | 渐变，前面的color,bgColor,darkBgColor失效 | 
+| shadow | string\|number\|Array\<string\> | '' | 数字或者字符串时自动计算投影,它会投影大小数组时(必须为4),第一个x,第二为y,第三个为大小,第四个为投影颜色空字符串时,取全局配置,如果不想投影设置为none即可. | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| click | - | - | 点击事件 | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| icon | - | icon图标 | 
+| default | - | 默认插槽 | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/text.md

@@ -0,0 +1,51 @@
+title: tmui 3.2.0 组件库
+
+#### 常用组件
+
+# 文本 TmText
+
+允许正则高亮或者,词高亮.
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/text.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| _style | Record\<string, any\>\|string | '' | 文本自定样式 | 
+| label | string\|number | '' | 文本内容这个prop用于接收显示在组件中的文本或数字 | 
+| heightLight | Array\<string\> | ():string[]=\>[]asstring[] | 需要特别高亮的词 | 
+| heightLightReg | Array\<string\> | ()=\>[] | 高亮正则用于定义文本中哪些部分应该被高亮显示的正则表达式数组 | 
+| heightLightStyle | string | "" | 高亮文本的自定义样式 | 
+| lines | number\|string | 0 | 行数控制文本显示时应该占用的行数（如果组件支持此功能） | 
+| selectable | boolean | false | 是否可选指示文本是否可以被用户选择（如通过长按选择） | 
+| color | string | "#333" | 文本颜色定义文本的主要颜色 | 
+| darkColor | string | "" | 暗色模式颜色在暗色模式下文本的颜色（如果组件支持暗色模式） | 
+| heightLightColor | string | "primary" | 高亮颜色文本中应该被高亮显示的部分的颜色 | 
+| lineHeight | string\|number | "1.5" | 行高文本的行高设置 | 
+| fontSize | string\|number | "" | 字体大小文本的字体大小设置 | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| click | 名称：word,点击的文本内容, | - | 文本点击 | 
+| itemClick | 名称：word,点击的文本内容, | - | 正则的文本被点击 | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | - | 默认文本插槽，如果使用插槽，那么相关特性功能将会失效。 | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/tutorial/android-16kb.md

@@ -5,7 +5,8 @@ Google Play 的政策要求：
 自 2025 年 11 月 1 日起，提交到 Google Play 且以 Android15（API 级别 35）及更高版本的设备为目标平台的所有新应用和现有应用更新都必须支持 16KB 的页面大小。  
 [详情](https://android-developers.googleblog.com/2025/05/prepare-play-apps-for-devices-with-16kb-page-size.html)。
 
-> HBuilderX4.81+，DCloud的自有so库已适配支持 16KB 内存页面大小
+> HBuilder 4.81+，DCloud的自研so库已适配支持 16KB 内存页面大小
+> HBuilder 5.31+，DCloud内置组件和API依赖的三方SDK统一升级，仅剩余直播和部分广告渠道的so库还未适配 16KB 。在必要时可去除相关模块。
 
 但是，某些三方sdk的so库未适配16K，见下。
 
@@ -25,44 +26,54 @@ Android17+，默认会开启16KB兼容性检测，如果应用中包含未适配
 建议应用用于提交 Google Play 时不要使用此功能。  
 
 涉及的so库文件列表：
-- libpldroid_mmprocessing.so
-- libpldroid_streaming_aac_encoder.so
-- libpldroid_streaming_amix.so
-- libpldroid_streaming_core.so
-- libpldroid_streaming_h264_encoder.so
-- libpldroid_streaming_puic.so
-- libpldroid_streaming_srt.so
+- `libpldroid_mmprocessing.so`
+- `libpldroid_streaming_aac_encoder.so`
+- `libpldroid_streaming_amix.so`
+- `libpldroid_streaming_core.so`
+- `libpldroid_streaming_h264_encoder.so`
+- `libpldroid_streaming_puic.so`
+- `libpldroid_streaming_srt.so`
 
 ### [live-player 组件](../component/live-player.md)
 `uni-live-player`模块是由 DCloud 的合作伙伴七牛提供并实现 live-player 组件相关功能，此模块依赖七牛的多媒体SDK，但该 SDK 目前未适配支持 16KB 内存页面大小。  
 建议应用用于提交 Google Play 时不要使用此功能。  
 
 涉及的so库文件列表：
-- libavcodec.so
-- libavformat.so
-- libavutil.so
-- libcrypto.1.1.so
-- libcurl.so
-- libqplayer2-core.so
-- libsoundtouch.so
-- libsrt.so
-- libssl.1.1.so
-- libswresample.so
-- libyuv.so
-- libpldroid_streaming_srt.so 
+- `libavcodec.so`
+- `libavformat.so`
+- `libavutil.so`
+- `libcrypto.1.1.so`
+- `libcurl.so`
+- `libqplayer2-core.so`
+- `libsoundtouch.so`
+- `libsrt.so`
+- `libssl.1.1.so`
+- `libswresample.so`
+- `libyuv.so`
+- `libpldroid_streaming_srt.so`
 
 ### [uni-ad](https://uniapp.dcloud.net.cn/uni-ad/)
-`uni-ad`使用国内广告渠道SDK 仅支持国内环境，建议应用用于提交 Google Play 时不要使用国内渠道 SDK。  
+`uni-ad`国内广告渠道SDK 仅支持国内环境，建议应用用于提交 Google Play 时不要使用国内广告渠道 SDK。  
 
-涉及的so库文件列表：
-- libplt-base.so
-- libsgcore.so
-- libti-monitor.so
+以下为未适配支持 16KB 内存页面大小的广告渠道，及其so库文件列表：
+- 穿山甲GroMore
+  + `libttmplayer_lite.so`
+  + `libavmdl_lite.so`
+- 快手广告联盟  
+  + `libsgcore.so`
+- 旺脉
+  + `libwmAliAgainstId.so`
 
 > HBuilder4.83及以上版本 国外广告 `applovin`、`pangle(海外穿山甲)` 广告渠道 SDK 已适配支持 16KB 内存页面大小。  
 
 ### [uni-push](../api/uni-push.md)
-`uni-push`使用了个推的sdk，在国内环境下，该sdk又依赖`卓信ID SDK`，但`卓信ID SDK` 目前未适配支持 16KB 内存页面大小。  
+`uni-push`是由 DCloud 与合作伙伴个推共同推出的统一推送服务。
+
+**HBuilder X 5.31 及以上版本**  
+已更新`uni-push`使用的个推 SDK 为 `3.3.15` 版，适配支持 16KB 内存页面大小。
+
+**HBuilder X 5.31 以下版本**  
+`uni-push`使用的个推 SDK 依赖`卓信ID SDK`，但该 SDK 目前未适配支持 16KB 内存页面大小。  
 为满足 Google Play 的要求，应用在提交至 Google Play 时需避免使用`卓信ID SDK`。按以下方式配置，使用`uni-push`时将不会包含`卓信ID SDK`：  
 1. 项目manifest.json可视化界面，在 “安卓App配置” 下的 “uni-push（消息推送）” 中只勾选 “Google FCM推送SDK”  
   ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/uni-push/android-16k-unipush-fcm.png)  
@@ -73,14 +84,25 @@ Android17+，默认会开启16KB兼容性检测，如果应用中包含未适配
 - libzxprotect.so
 
 ### [uni实人认证](../api/facial-recognition-meta-info.md)  
-`uni实人认证`功能仅支持国内环境，建议应用用于提交 Google Play 时不要使用此功能。
+`uni实人认证`是 DCloud 与合作伙伴共同推出的金融级实人认证服务，通过对比人脸、活体检测、姓名和身份证号码，来确认用户身份的有效性。
+
+**HBuilder X 5.31 及以上版本**  
+已更新`uni实人认证`使用的阿里云金融级实人认证 SDK 为 `2.3.16.1` 版，适配支持 16KB 内存页面大小。
+
+**HBuilder X 5.31 以下版本**  
+`uni实人认证`功能仅支持国内环境，建议应用提交 Google Play 时不要勾选此模块，或更新到最新版本HBuilder X解决。
 
 涉及的so库文件列表：
 - libaliyunaf.so  
 - libfacedevice.so  
 
 ### [腾讯地图](../component/map.md)  
-腾讯地图使用的 SDK 版本为 `5.8.3`，暂未更新到最新版本，需等待官方升级腾讯地图SDK版本适配。
+
+**HBuilder X 5.31 及以上版本**  
+已更新`腾讯地图`模块使用的腾讯地图 SDK 为 `6.13.0` 版，适配支持 16KB 内存页面大小。  
+
+**HBuilder X 5.31 以下版本**  
+`腾讯地图`使用的 SDK 版本为 `5.8.3`，未适配支持 16KB 内存页面大小，请更新到最新版本HBuilder X解决。
 
 使用腾讯地图SDK的API：
 - [uni.createMapContext](../api/create-map-context.md)

package/data/uniappx/tutorial/compatibility.md

@@ -11,7 +11,7 @@ uni-app x 在不同平台（Android、iOS、鸿蒙、微信小程序、web）、
 
 - `√`：表示支持。尤其指从开始就支持，而不是从特定版本后才支持
 - `x`：表示不支持
-- `版本号`：从该 HBuilderX 版本号起支持
+- `版本号`：从该 HBuilder 版本号起支持。因老版红色图标的HBuilder已于2019年下线，本文档网站中的HBuilder，泛指HBuilderX和HBuilderV。并且 HBuilderX 和 HBuilderV 的版本号是一致的，IDE与uni引擎的版本号保持一致。
 - `OS系统版本号`：从该OS系统版本起支持 
 - `空白`：未标注。可能支持也可能不支持，或不需要单独说明
 
@@ -24,6 +24,7 @@ uni-app x 在不同平台（Android、iOS、鸿蒙、微信小程序、web）、
 ### 平台
 - Web
 - 微信小程序
+- 支付宝小程序
 - Android
 - iOS
 - HarmonyOS

package/data/uniappx/tutorial/debug/devtools.md

@@ -76,7 +76,7 @@ Network 展示的是调用公开 uni API 时可见的参数和结果，不是平
 请求和响应正文仅在 Runtime 可以读取且未超过缓存限制时显示。二进制请求体、流式内容、超限内容或已经被释放的内容可能无法查看，但请求 URL、状态和基础耗时仍会保留。
 
 ::: warning 当前限制
-Network 暂不支持 UTS 插件内部或平台原生代码绕过公开 uni API 发起的请求，也不会补录 DevTools 建立连接前已经完成的请求。
+Network 不支持 UTS 插件内部或平台原生代码绕过公开 uni API 发起的请求，也不会补录 DevTools 建立连接前已经完成的请求。
 
 ## 查看和修改 Storage
 
@@ -106,7 +106,7 @@ Storage 暂不支持新建数据或修改 Key。UTS 插件内调用存储 API
 
 ## 常见问题
 
-### DevTools 一直显示等待应用连接
+### DevTools 一直显示等待应用连接@faq-connecting
 
 请依次确认：
 

package/data/uniappx/tutorial/ls-plugin.md

@@ -89,7 +89,7 @@ uni-app x 项目有很多平台，每个平台都有大量的语法和API。尤
 在非条件编译代码区域里，代码提示、语法校验则会以选择的平台为准（默认选择：APP-ANDROID）。
 
 #### 代码提示
-* 目前暂不支持`条件编译`的相关代码提示。
+* 目前不支持`条件编译`的相关代码提示。
 * 可以提示uni相关的API和组件，并有详细的参数提示。
 <br/> ![completion](https://web-ext-storage.dcloud.net.cn/doc/tutorial/lsp-plugin/completion.png)
 

package/data/uniappx/tutorial/store.md

@@ -7,11 +7,11 @@
 uni-app x下可选方案有：
 
 1. 在独立的uts文件中定义一个全局的reactive变量，各处引用它。
-2. 引入pinia。蒸汽模式下可直接使用pinia官方库。Android vdom模式下需使用三方插件 [Pinia by uts](https://ext.dcloud.net.cn/plugin?name=x-pinia-s)
+2. 引入pinia。
 
 从 HBuilderX 5.25 起，uni-app x 项目的 `pinia` 升级到了 `3.0.4` 版本。如希望使用其他版本，可在项目根目录自行安装指定版本。
 
-APP 蒸汽模式、鸿蒙和 iOS VDOM 模式、Web平台、小程序平台可以直接使用 `pinia` 官方库。
+仅 Android vdom模式下需使用三方插件 [Pinia by uts](https://ext.dcloud.net.cn/plugin?name=x-pinia-s)，其他场景可直接使用原版 pinia。
 
 ## Pinia
 

package/data/uniappx/uniapptox.md

@@ -37,6 +37,7 @@ uni-app迁移到uni-app x，是一个大型工程。
 * vue2的状态管理vuex，在vue3下已经改成了pinia
 * vue蒸汽模式，不再支持mixin
 * 组合式里没有this了，需要改成 [`getCurrentInstance()!.proxy!`](./vue/composition-api.md#getcurrentinstance)
+* 检查通过`getCurrentPages()`获取`page.$vm`并访问其他页面数据或方法的代码。组合式页面默认不对外暴露内部成员，建议改用pinia、[事件通信](./api/event-bus.md)等方式重构，不要简单替换为`page.vm`。
 
 做完后先在uni-app下检查是否正常。
 
@@ -70,9 +71,15 @@ uni-app x在编译时，会在控制台提示不支持的css，可以让uni-agen
 
 如涉及暗黑模式适配，需参考uni-app x的[暗黑适配文档](./api/theme-change.md)，有些部分与uni-app相同，但也有一些改动。
 
+### 7. 适配UniApp对象重构
+
+HBuilderX 4.31+ 重构了应用对象，迁移时需要检查`getApp()`的相关代码：
+
+* `getApp()`改为返回[UniApp对象](./api/get-app.md)，Vue实例通过`vm`属性提供。调用`App.uvue`中定义的全局方法时，需要把`getApp().methodName()`改为`getApp().vm?.methodName()`；`globalData`仍通过`getApp().globalData`访问。`UniApp`可在uts插件和uvue页面中使用，但`vm`和`globalData`仅支持在uvue页面中使用。
+
 如果要改造为App，继续往下。
 
-### 7. 改造plus
+### 8. 改造plus
 
 uni-app x不支持plus。
 
@@ -81,14 +88,14 @@ uni-app x不支持plus。
 
 另外如果项目使用了subNVue，需要改成[dialogPage](./api/dialog-page.md)
 	
-### 8. 改造组件库
+### 9. 改造组件库
 
 * 如果使用了uni ui，那么迁移指南在这篇文档的底部：[uni-ui x](./component/uni-ui-x/README.md)
 * 如果使用其他组件库，需要咨询组件作者是否有 uni-app x 版本。如果没有的话，推荐用[uni-ui x](./component/uni-ui-x/README.md)重构。
 
 uni-app x 相比 uni-app 多了不少内置组件，比如`list-view`复用长列表、`waterflow`瀑布流、`page-container`弹框、`sticky`吸顶、`match-media`宽屏适配、loading加载中、native-view对接原生view。对于内置组件已经满足需求的情况就没必要使用三方组件了。
 
-### 9. 改造wxs和renderjs为Element API
+### 10. 改造wxs和renderjs为Element API
 
 uni-app x的app平台不再支持wxs和renderjs。uni-app x的逻辑层和渲染层虽然还是2层，但并没有明显的通信成本。
 
@@ -96,7 +103,7 @@ uni-app x 提供了全端统一的UNIElement API，它在编译到微信小程
 
 包括moveable组件的使用，也推荐改成UNIElement的操作。
 	
-### 10. mock掉App原生插件（非uts原生插件）的输入输出，在iOS和鸿蒙上验证
+### 11. mock掉App原生插件（非uts原生插件）的输入输出，在iOS和鸿蒙上验证
 
 如果你使用了老的App原生插件，先让uni-agent把App原生插件的输入输出mock掉，后续步骤再处理原生插件，先对前几步的工作进行验证。
 
@@ -105,7 +112,7 @@ uni-app x 提供了全端统一的UNIElement API，它在编译到微信小程
 
 这一步要再处理一件事，检查组件库是否适配了[样式隔离策略2.0](./css/common/style-isolation.md)。uni-app x 的蒸汽模式，仅支持[样式隔离策略2.0](./css/common/style-isolation.md)。
 
-### 11. 替换App原生插件和uts兼容模式组件
+### 12. 替换App原生插件和uts兼容模式组件
 	
 如果你之前使用了uts API插件，那么可以在uni-app x下直接复用。
 
@@ -123,7 +130,7 @@ uni-agent让普通前端开发者具备了写原生插件的能力，官方的
 
 完成后继续在iOS和鸿蒙上验证。
 
-### 12. 使用HBuilderX 5.23以上适配Android
+### 13. 使用HBuilderX 5.23以上适配Android
 
 直接打开 `uni-app x` 的蒸汽模式，该模式兼容js/ts写法。且性能比`uni-app x` Android版VDOM模式、比Android原生开发的性能都会好非常多。[详见](./app-vapor.md)