tmui-cli 2.0.6 → 5.3.2

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/compliance.md

@@ -527,7 +527,7 @@ App一键登录为了支持“中国电信”运行商，要用到“电信（
 在应用的 [onLaunch](../collocation/app.md#onlaunch) 生命周期中调用 [uni.getPrivacySetting](../api/privacy.md#getprivacysetting) 判断用户是否已经同意隐私政策，如果没有同意则通过 [uni.openDialogPage](../api/dialog-page.md#opendialogpage) 弹出“个人信息保护指引”（或“用户协议和隐私政策概要”）提示框，否则跳过。
 
 示例代码如下：
-```uts
+```vue
 
 ```
 

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

@@ -8,7 +8,7 @@ uni-app x DevTools 是 HBuilderX 内置的 uni-app x 蒸汽模式运行时检查
 
 目前提供以下功能：
 
-1. 在 Elements 中查看页面、Element 和自定义组件组成的节点树，以及属性、组件 props、计算样式和盒模型。
+1. 在 Elements 中查看页面、Element 和自定义组件组成的节点树，以及属性、组件 props、计算样式和盒模型；也可以将所选节点添加到 uni-agent 聊天。
 2. 在 Network 中查看通过 `uni.request`、`uni.uploadFile` 和 `uni.downloadFile` 发起的请求。
 3. 在 Storage 中查看和维护应用通过 uni Storage API 保存的数据。
 
@@ -42,14 +42,24 @@ HBuilderX 会打开独立的 DevTools 窗口。应用尚未连接时，窗口会
 
 ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-component-props.png)
 
-右键点击节点可以使用以下操作：
+### 节点右键菜单@elements-context-menu
 
-- **展开所有子节点**：递归展开该节点下的所有内容。
-- **收起子级**：收起该节点下已经展开的内容。
-- **在 HBuilderX 中打开**：打开页面或自定义组件对应的源码文件。该菜单只在能定位源码的页面和自定义组件节点上显示。
+右键点击节点可以使用以下操作：
 
 ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-elements-context-menu.png)
 
+1. **将所选节点添加到 uni-agent 聊天**：打开 uni-agent，将当前页面和节点路径添加到输入框；支持截图时还会添加所选节点的截图。
+
+   > HBuilderX 5.31+、uni-agent v1.8.8.261012094+ 支持。
+
+   DevTools 不会自动发送消息。请在 [uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/) 输入框中补充需要排查的问题，再手动发送。uni-agent 可以根据节点引用继续读取相关属性、组件 props、计算样式和盒模型，用于排查布局、样式或数据问题。
+
+   ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-uni-agent.png)
+
+2. **在 HBuilder 中打开**：打开页面或自定义组件对应的源码文件。该菜单只在能定位源码的页面和自定义组件节点上显示。
+3. **展开所有子节点**：递归展开该节点下的所有内容。
+4. **收起所有子节点**：收起该节点下已经展开的内容。
+
 ::: warning 当前限制
 Elements 当前使用页面快照，页面内新增、删除或修改节点后不会自动同步。请点击窗口左上角的刷新按钮查看最新内容。切换页面不需要手动刷新。
 
@@ -76,7 +86,7 @@ Network 展示的是调用公开 uni API 时可见的参数和结果，不是平
 请求和响应正文仅在 Runtime 可以读取且未超过缓存限制时显示。二进制请求体、流式内容、超限内容或已经被释放的内容可能无法查看，但请求 URL、状态和基础耗时仍会保留。
 
 ::: warning 当前限制
-Network 暂不支持 UTS 插件内部或平台原生代码绕过公开 uni API 发起的请求，也不会补录 DevTools 建立连接前已经完成的请求。
+Network 不支持 UTS 插件内部或平台原生代码绕过公开 uni API 发起的请求，也不会补录 DevTools 建立连接前已经完成的请求。
 
 ## 查看和修改 Storage
 
@@ -106,7 +116,7 @@ Storage 暂不支持新建数据或修改 Key。UTS 插件内调用存储 API
 
 ## 常见问题
 
-### DevTools 一直显示等待应用连接
+### DevTools 一直显示等待应用连接@faq-connecting
 
 请依次确认：
 
@@ -129,6 +139,6 @@ Network 只记录 DevTools 建立连接后，通过 `uni.request`、`uni.uploadF
 
 公开 uni Storage API 产生的变化会自动同步。UTS 插件绕过公开 API 包装器写入数据时，请切换到 Storage 标签并点击左上角的刷新按钮。
 
-### 节点右键菜单中没有“在 HBuilderX 中打开”
+### 节点右键菜单中没有“在 HBuilder 中打开”
 
 该菜单只对能够定位源码的页面和自定义组件显示，Element 不显示此菜单。

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,14 +37,34 @@ 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下检查是否正常。
 
 ### 5. 构造uni-app x项目
 
-新建`uni-app x`项目，勾选`manifest.json`中的蒸汽模式。把老项目的页面、组件、uni_modules、静态资源复制过来。所有`vue`或`nvue`页面组件文件，批量重命名为`uvue`。`main.js`改名为`main.uts`（蒸汽模式下，`main.uts`里也支持`js/ts`写法）。可以保留之前的appid和包名。
+新建`uni-app x`项目，选择蒸汽模式。
+可以保留之前的appid和包名，在manifest.json源码视图里改成之前的appid。
 
-之前如果有`nativeplugins`目录，就不用带来过了，uni-app x只支持uni_modules下的uts插件。原本的插件需要换新，或者临时mock掉。如果插件市场没有同款uts插件替代，可以让uni-agent重新封装一个uts原生插件，不懂原生也可以指挥ai完成（别选智商低的模型）。对于app.vue，不建议整体文件改名替换uni-app x的app.uvue。而是挑选部分代码复制过来。因为uni-app x 的app.uvue有2个变化：
+manifest的结构，在uni-app x中与uni-app略有不同。需要把原来manifest的信息按新的规范填一遍。关于三方sdk的key信息，只要包名和签名不变，key可以复用。[详见](./collocation/manifest.md)
+
+如果使用云端证书打包，只要appid、账户不变，证书可以复用。
+
+把老项目的页面、组件、uni_modules、静态资源复制到新项目中。
+之前如果有`nativeplugins`目录，就不用带来过了，uni-app x只支持uni_modules下的uts插件。
+原本的插件需要换新，或者临时mock掉。
+如果插件市场没有同款uts插件替代，可以让uni-agent重新封装一个uts原生插件，不懂原生也可以指挥ai完成（别选智商低的模型）。
+
+所有`vue`或`nvue`页面组件文件，批量重命名为`uvue`。
+
+在HBuilder 5.31以前，推荐把独立的js/ts文件的后缀名改成uts（蒸汽模式页面引用的uts文件也是弱类型，可以写js/ts语法）。
+5.31起不需要改文件后缀了。
+
+老项目的pages.json可以直接挪过来使用。结构没有差别，只是uni-app x的pages.json中不再支持plus，多支持了一些新的页面style和tabbar的属性。[详见](./collocation/pagesjson.md)
+
+老项目的`main.js`和`app.vue`，挑选内容复制到新项目中对应的新文件中。
+
+uni-app x 的app.uvue对比老 uni-app 有2个变化：
 	
 #### 5.1 应用退出方式
 
@@ -59,7 +79,9 @@ uni-app迁移到uni-app x，是一个大型工程。
 如果你之前有web版和微信小程序，那么改造后首先运行到 `uni-app x` 的web和微信小程序上，看看是否正常。
 
 同时注意uni-app x的 [web开发注意](./web/README.md) 和 [小程序开发注意](./mp/README.md)
-	
+
+uni-app x 的 app.uvue 文档[详见](./collocation/app.md)
+
 ### 6. 再次适配css
 
 之前在uni-app中适配过一次css，但[css样式重置](./css/README.md#css-reset)、[样式隔离策略2.0](./css/common/style-isolation.md)，这2个在uni-app下没有，还得在uni-app x环境中再次适配。
@@ -70,9 +92,16 @@ uni-app x在编译时，会在控制台提示不支持的css，可以让uni-agen
 
 如涉及暗黑模式适配，需参考uni-app x的[暗黑适配文档](./api/theme-change.md)，有些部分与uni-app相同，但也有一些改动。
 
+### 7. 适配UniApp对象重构
+
+uni-app x 的 `getApp()` 改为返回[UniApp对象](./api/get-app.md)。
+Vue实例需通过`vm`属性提供。
+调用`App.uvue`中定义的全局方法时，需要把`getApp().methodName()`改为`getApp().vm?.methodName()`（ts需要?，js去掉?）。
+`globalData`仍通过`getApp().globalData`访问。
+
 如果要改造为App，继续往下。
 
-### 7. 改造plus
+### 8. 改造plus
 
 uni-app x不支持plus。
 
@@ -80,32 +109,33 @@ uni-app x不支持plus。
 * 如果在pages.json里使用了plus，推荐改用 uni-ui x 的 [uni-nav-bar 自定义导航栏组件](./component/uni-ui-x/uni-nav-bar.md) 和 [uni-tab-bar自定义tabbar组件](./component/uni-ui-x/uni-tab.md) 来替代。
 
 另外如果项目使用了subNVue，需要改成[dialogPage](./api/dialog-page.md)
+
+页面中如果有 app-plus 的条件编译，建议改为 app 。uni-app x 中也支持独立的 app-android、app-ios、app-harmony 的条件编译。
 	
-### 8. 改造组件库
+### 9. 升级或改造前端库
 
-* 如果使用了uni ui，那么迁移指南在这篇文档的底部：[uni-ui x](./component/uni-ui-x/README.md)
+* 如果使用了uni ui，那么迁移指南在这篇文档的底部：[uni-ui x](./component/uni-ui-x/README.md#uniuiupgrade)
 * 如果使用其他组件库，需要咨询组件作者是否有 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。对于内置组件已经满足需求的情况就没必要使用三方组件了。
+uni-app x 相比 uni-app 多了不少内置组件，比如`list-view`复用长列表、`waterflow`瀑布流、`page-container`弹框、`sticky`吸顶、`match-media`宽屏适配、loading加载、native-view对接原生view。对于内置组件已经满足需求的情况就没必要使用三方组件了。
 
-### 9. 改造wxs和renderjs为Element API
+* 升级uni_modules，比如官方的uni-id-pages、uni-starter、uni-pay、升级中心等库，需要升级到支持蒸汽模式的最新版本。
 
-uni-app x的app平台不再支持wxs和renderjs。uni-app x的逻辑层和渲染层虽然还是2层，但并没有明显的通信成本。
+### 10. 改造wxs和renderjs为Element API
 
-uni-app x 提供了全端统一的UNIElement API，它在编译到微信小程序时会自动编译成wxs。写法跨端且高性能。[详见](./api/dom/README.md)
+uni-app x的app平台不再支持wxs和renderjs。
+
+uni-app x 提供了全端统一的UNIElement API，它在编译到微信/支付宝小程序时会自动编译成wxs/ajs。写法跨端且高性能。[详见](./api/dom/README.md)
 
 包括moveable组件的使用，也推荐改成UNIElement的操作。
 	
-### 10. mock掉App原生插件（非uts原生插件）的输入输出，在iOS和鸿蒙上验证
+### 11. mock掉App原生插件（非uts原生插件）的输入输出
 
 如果你使用了老的App原生插件，先让uni-agent把App原生插件的输入输出mock掉，后续步骤再处理原生插件，先对前几步的工作进行验证。
 
-- iOS和鸿蒙，使用的是js驱动，arkts是js的强化版，可以运行标准的js。
-- Android的vdom模式是uts驱动，需要强类型。对于uni-app开发者而言，推荐改用没有强类型约束的蒸汽模式，并且性能比vdom更高。
-
 这一步要再处理一件事，检查组件库是否适配了[样式隔离策略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,11 +153,18 @@ uni-agent让普通前端开发者具备了写原生插件的能力，官方的
 
 完成后继续在iOS和鸿蒙上验证。
 
-### 12. 使用HBuilderX 5.23以上适配Android
+注意部分uts插件使用了uni-app的特性，导致没有适配uni-app x，这种情况需要插件作者升级适配。
 
-直接打开 `uni-app x` 的蒸汽模式，该模式兼容js/ts写法。且性能比`uni-app x` Android版VDOM模式、比Android原生开发的性能都会好非常多。[详见](./app-vapor.md)
+uni-app 的 Android平台整个应用只有一个activity，每个page是view。而uni-app x 的 Android 平台，每个页面都是一个activity。有的uts插件可能未区别这种差异。
 
-js驱动将避免开发者改造uts代码，并且兼容广泛的npm js生态。
+### 13. 处理uts/js/ts的差异
+
+在 HBuilder 5.31以前，蒸汽模式下uts/js/ts都是按uts2js编译。此时script中的lang不能设置，需要置空。同时外部文件后缀需要为uts。
+但此时的uts，不编译为强类型的kt、swift，可以在里面写普通的js/ts代码。
+
+从 5.31+ ，蒸汽模式下支持独立设置uts/js/ts。[详见](./vue/README.md#lang)。
+
+推荐uni-app的老应用升级时选择5.31+。
 	
 ### 小结
 
@@ -136,6 +173,7 @@ js驱动将避免开发者改造uts代码，并且兼容广泛的npm js生态。
 这十几步的每一步都应该新起一个会话。有必要传给下一个会话的内容，让AI总结到md里，让下一个会话在有必要时读取这个md。
 
 **一个AI使用经验：**
+
 AI很擅长从0到60，这一步很快。但再往上，要不投入更多优秀人力review、要不投入更多和更高智商的AI算力做交叉验证和自动化测试。
 
 高智商的AI算力虽然贵，但在代码翻译这件事上，其实性价比是远超过投入优秀的人时的。