tmui-cli 2.0.5 → 5.3.1

package/data/uni-app-x-docs/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，见下。
 
@@ -26,13 +27,13 @@ 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)
@@ -40,34 +41,44 @@ Android17+，默认会开启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)  
@@ -79,7 +90,13 @@ Android17+，默认会开启16KB兼容性检测，如果应用中包含未适配
 
 
 ### [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  
@@ -87,7 +104,12 @@ Android17+，默认会开启16KB兼容性检测，如果应用中包含未适配
 
 
 ### [腾讯地图](../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/uni-app-x-docs/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/uni-app-x-docs/tutorial/debug/devtools.md

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

package/data/uni-app-x-docs/tutorial/ls-plugin.md

@@ -91,7 +91,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/uni-app-x-docs/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
 
@@ -97,7 +97,7 @@ export const useCounterStore = defineStore('counter', () => {
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup>
 import { storeToRefs } from 'pinia'
 import { useCounterStore } from '@/store/counter.uts'
 

package/data/uni-app-x-docs/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)
 
@@ -142,4 +149,4 @@ AI很擅长从0到60，这一步很快。但再往上，要不投入更多优秀
 
 自动化测试，在AI时代这几乎是必备技能。[详见](https://doc.dcloud.net.cn/uni-app-x/worktile/auto/quick-start.html)
 
-`uni-app` 和 `uni-app x`的自动化测试例是兼容的，建议先在 `uni-app` 下补齐自动化测试例，跑通。然后改造 `uni-app x` 时，继续自动跑这些自动化测试例，会极大提升效率。
+`uni-app` 和 `uni-app x`的自动化测试例是兼容的，建议先在 `uni-app` 下补齐自动化测试例，跑通。然后改造 `uni-app x` 时，继续自动跑这些自动化测试例，会极大提升效率。

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

@@ -0,0 +1,286 @@
+# uni-app x 比 uni-app 优势汇总
+
+众所周知，uni-app x 的蒸汽模式在渲染性能上表现极其优异，甚至[超越了传统原生开发](./app-vapor.md#_4050)，相比 uni-app 自然有着更大的优势。
+
+也有部分开发者对性能不敏感，觉得 uni-app 也够用。想了解升级uni-app x 蒸汽模式还有哪些好处。
+
+uni-app由于预加载webview，所以在常规业务中新页面加载速度也能满足大多数场景。
+
+但App启动速度无法靠预载解决。升级 uni-app x 后体感会非常明显的感受到App的启动速度快很多。
+
+hello uni-app x 有400多个页面、众多SDK、100多M的体积，但没有splash，它就像系统应用一样在无splash的情况下迅速渲染首屏。
+
+另外uni-app中实现高性能UI交互需要使用App专属的renderjs，uni-app x 不再需要，直接操作DOM元素，全平台均可高性能操作UI。
+
+除了极致的性能之外，uni-app x 还有哪些长处？下文对两者的差异进行全面汇总。
+
+在语法层面，uni-app x 蒸汽模式与 uni-app 高度相似：支持相同的 Vue 语法、相同的 JS/TS、相同的组件和 API 命名，仅 CSS 为 Web 的子集。
+
+uni-app 毕竟是2018年设计的系统，而 uni-app x 吸取了前者的很多经验教训，拥有更优秀、更现代的设计。
+
+优秀的架构不像显性功能那样容易被直观感知，但当你遇到各种复杂问题时，它会展现出更优雅解决方案、合理的解耦、更小的副作用。
+
+## UI系统
+### UI的全自定义能力
+
+uni-app 的 UI 不具备全面定制能力，许多UI定制需求开发者难以实现。
+
+1. 小程序的组件规范缺少足够的自定义性
+
+例如swiper的指示器，小程序的规范中仅能通过3个属性来定义：是否显示、指示点的颜色、以及高亮指示点的颜色。
+但在实际业务中，指示器的形态丰富多样，有时需要横线，有时需要显示数字。
+
+uni-app 中，开发者只能隐藏默认指示器并自行绘制（即 uni ui 中的 uni-swiper-dot 组件）。
+
+uni-app x 中，swiper组件提供了`indicator-class`、`indicator-active-class`和指示器插槽，可以完全自定义所有指示器ui。
+
+类似的情况还有很多，slider、switch等很多组件，小程序规范只能提供有限属性定义样式，但 uni-app x 中提供了各种externalClass，支持所有样式的自定义。
+
+此外，小程序规范中，暗黑时很多组件样式是写死的。但在uni-app x下，都可以完全自定义。
+
+2. 原生UI无法自定义
+
+uni-app中，出于性能考虑，很多UI界面是各平台原生语言实现的，比如showModal、showActionSheet、showLoading、扫码、一键登录、previewImage、chooseLocation、openLocation、video组件的操作视图...
+
+这些原生UI无法方便的自定义，只能提供有限的属性，例如一键登陆提供了一批json定义方式。
+这些UI界面的国际化、暗黑适配也不统一。
+由于不同平台代码不同，这些UI的细节也不同。
+
+在uni-app x中，没有一个界面是原生编程语言实现的，所有UI界面都是uvue。
+（除了已经不推荐使用的chooseImage的内置相册选择界面。不推荐是因为系统权限收紧，推荐改用OS提供的相册选择以实现免权限）
+
+统一的uvue界面实现带来很多优势：
+- 渲染的比原生还快
+- 支持传入Class或自行修改开源代码来完全的自定义样式
+- 统一适配国际化和暗黑模式
+- 保持各平台UI一致性、减少了质量和兼容性问题
+
+### 样式隔离系统
+
+uni-app并没有统一的样式隔离系统。
+
+全局样式、页面样式、组件样式，这3者如何管理复用和隔离，是没有统一方案的。uni-app的web版使用v-deep，app和小程序则依赖权重选择器。
+
+由于缺乏统一规范，组件的样式自定义往往是依靠组件作者封装属性，但又无法完全覆盖所有样式的自定义需求。于是大多数组件使用者的做法是直接修改组件源码。
+
+同时全局和页面的样式，以前也经常误影响组件内表现，导致组件作者在收到组件使用者的Bug反馈时常常莫名其妙。
+
+uni-app x 蒸汽模式支持的"样式隔离系统2.0"，从根本上彻底的解决了样式管理问题。[详见](https://doc.dcloud.net.cn/uni-app-x/css/common/style-isolation.html)
+
+基于"样式隔离系统2.0"的组件，包括扩展的uni-ui x，从此都干净清爽，所有组件样式都可以自定义、任何自定义样式都不需要改组件源码。
+并且组件是否允许被外部影响也提供了明确的配置项。
+
+"样式隔离系统2.0"，是跨端生态里非常重要的基建，它深刻影响整个组件生态，是孕育优秀组件库的坚实地基。
+
+### 内置更多UI组件
+
+针对那些常用且对性能要求极高（或如液态玻璃般必须原生实现）的场景，uni-app x 蒸汽模式提供了业内顶级性能的组件实现：
+
+uni-app x 蒸汽模式提供了业内顶级性能的组件实现。
+
+- 液态玻璃组件 [glass-effect-view](./component/glass-effect-view.md)
+- [list-view](./component/list-view.md)：比原生recyclerView性能更高的长列表组件。[benchmark](./app-vapor.md#list)
+- [waterflow](./component/waterflow.md)
+- 嵌套滚动组件 [nested-scroll-header](./component/nested-scroll-header.md)、[nested-scroll-body](./component/nested-scroll-body.md)
+- 吸顶组件 [sticky-header](./component/sticky-header.md)、[sticky-section](./component/sticky-section.md)
+- [page-container](https://doc.dcloud.net.cn/uni-app-x/component/page-container.html)
+- [rich-text](./component/rich-text.md)：原生模式的rich-text，提供了业内顶尖的富文本渲染性能。[benchmark](./app-vapor.md#rich-text)
+- [camera](./component/camera.md)
+- [animation-view](./component/animation-view.md) : uni-app的lottie组件仅支持nvue的Android和iOS。uni-app x全平台都支持。
+- [native-view](./component/native-view.md)：集成原生视图到uvue界面的重要纽带
+
+### 用全平台统一的Element API替代wxs/sjs/renderjs
+
+uni-app 中，高性能UI操作离不开 wxs/sjs/renderjs。\
+但这些代码不跨端，难用，AI也不熟悉。\
+uni-app x 支持跨平台 Element API来统一替代 wxs/sjs/renderjs。\
+统一对Element的style设置css属性，全平台都支持，在小程序上会编译为wxs/sjs的高性能代码。
+
+### 布尔属性规范化
+
+小程序的规范中，很多布尔属性的默认值为true，这产生很多歧义，不写这个属性、简写属性名但不赋值、值为空字符串...各种情况下到底是什么含义很混乱。\
+W3C有专门的布尔属性规范，[详见](https://developer.mozilla.org/zh-CN/docs/Glossary/Boolean/HTML)。\
+uni-app x 蒸汽模式的组件规范，统一规范化了这个行为。所有布尔属性默认值都是false，各种边界均符合W3C布尔属性规范定义。
+
+### uni-ui x的高性能和完全自定义
+
+uni-app对应的uni ui，存在封装和抽象不合理的问题，组件属性封了太多，影响了性能、拉长了文档，也仍然无法满足开发者的所有自定义需求。
+
+uni-ui x 的逻辑抽象和设计代表了业内最先进的水平。它借鉴了Headless UI的充分自定义性，同时兼顾了易用性与高性能。
+
+这种高性能不仅源于 uni-app x 蒸汽模式的底层支持，也得益于组件自身的代码优化，多重因素共同打造了一流的高性能组件库。[详见](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/)
+
+
+## App权限和隐私管理
+
+uni-app 诞生于隐私和权限管控并不严格的时代。很多相关功能没有内置，需要依赖插件实现。
+
+uni-app x 内置了众多权限相关的API：[uni.getAppAuthorizeSetting](./api/get-app-authorize-setting.md)、[uni.openAppAuthorizeSetting](./api/open-app-authorize-setting.md)、[uni.getSystemSetting](./api/get-system-setting.md)、[uni.createRequestPermissionListener](./api/create-request-permission-listener.md)、[uni.requestSystemPermission](./api/request-system-permission.md) 
+
+uni-app的隐私政策弹窗，是原生提供的一个无法完全自定义的弹窗。\
+而在 uni-app x 中，不再依赖这种受限的原生弹框，开发者完全可以在前端使用 uvue 自主绘制任意隐私政策弹窗界面。
+
+同时uni-app x新增了多项隐私政策的相关API、组件和配置：uni.getPrivacySetting、uni.resetPrivacyAuthorization、uni.onPrivacyAuthorizationChange、uni.offPrivacyAuthorizationChange，同时button组件中提供了属性open-type="agreePrivacyAuthorization"，manifest.json中app节点下提供了initPrivacyAuthorization。[详见](./api/privacy.md)
+
+uni-app x 的内置组件和API，都遵循统一的隐私管理规范，避免隐私政策同意前发生违规的数据访问。
+
+uni-app中集成的一些三方SDK版本较老，这些SDK的新版已符合监管规范。仅在uni-app x中使用的是新版SDK。
+
+应用商店的隐私管理经常升级，uni-app的做法是发现开发者报哪个SDK有问题，才升级哪个。而uni-app x从源头就没有这类问题。
+
+uni-app 中还留有 plus.device.imei 等新版Android无法再使用的API，呼叫电话、读写通讯录等API使用的也是现在已经难以获得权限的老方式。在uni-app x 中，读写联系人、呼叫电话、选择相册，这些API的实现内部都使用了新的权限管理策略，不再要求高敏感权限。
+
+## 内置API的新增和优化
+
+uni-app x 内置很多新API，例如[worker](./api/create-worker.md)、[getFileSystemManager](./api/get-file-system-manager.md)、[日历](./api/calendar.md)、[陀螺仪](./api/gyroscope.md)。
+
+尤其是worker多线程，是提高性能的利器。
+
+uni-app 中使用AI流式返回，需要通过renderjs，在webview操作。
+uni-app x 的request API内置支持AI流式返回。
+
+## 原生扩展多端一致性
+
+uni-app 的组件和API，涉及原生扩展时，各平台一致性较弱。
+- 比如uni.showModal在不同平台样式差异很大
+- 比如uni.previewImage和image组件支持的图片格式不一致。（uni-app x中previewImage就是使用的image组件，保持了一致性）
+
+uni-app x 中通过interface.uts多平台统一约束了原生扩展API的实现，通过UI层的自举实现跨平台UI界面。
+
+## 错误码规范
+
+uni-app 的API实现较早，当时还没有uniError规范。导致不同平台错误码可能不同或错误码过于笼统不利于排错。
+
+uni-app x 的API错误码，严格遵循[uni error规范](https://doc.dcloud.net.cn/uni-app-x/err-spec.html)
+
+每个API都有统一的interface和errCode的类型定义，让错误排查更清晰、可追踪。也更方便开发者自行拦截错误并向用户展示定制化的错误提示。
+
+## 路由系统
+
+uni-app x 的每个页面都提供了 [UniPage对象](https://doc.dcloud.net.cn/uni-app-x/api/unipage.html)，可以通过编程的方式来操作页面样式，而不是只能使用固化在 pages.json 里的静态属性。
+
+uni-app x 的路由系统，新增了跨端统一的 [路由事件](https://doc.dcloud.net.cn/uni-app-x/api/app-route.html)
+
+在弹窗实现方面，uni-app 时代方案杂乱：有人用uni-popup等z-index方案、有人用subnvue、有人利用了webview页面背景可透明的特性。
+
+uni-app x 提供了[page-container](https://doc.dcloud.net.cn/uni-app-x/component/page-container.html)和[dialogPage](https://doc.dcloud.net.cn/uni-app-x/api/dialog-page.html)，分别用于处理页内弹层和独立页弹框。
+
+page-container是小程序中唯一可以监听back后关闭弹窗的组件，但uni-app的app平台并未提供，且uni-popup组件也无法在小程序上通过back关闭。
+uni-app x 中全端补齐 page-container组件，成为全端通用的页内弹层方案。
+
+dialogPage是设计更完善的独立页弹窗。事实上 uni-app x 很多内置API，如showModal、showActionSheet、showLoading 都是基于 dialogPage 实现的。
+
+## 文件系统
+
+uni-app 的沙盒文件管理缺乏统一规范，很多内置组件、API、三方SDK在使用沙盒文件，用户代码也在使用沙盒文件，容易冲突。
+
+uni-app x 提供了完善的[沙盒文件管理规范](./api/file-system-spec.md)。
+
+uni-app x 也提供了完善的文件管理API，[uni.getFileSystemManager](./api/get-file-system-manager.md)，开发者可以完全的控制沙盒文件、控制缓存管理。
+
+## 屏幕适配
+
+uni-app的预置css变量实现数量少，且无法参与calc运算。
+
+uni-app x 的预置css变量，比uni-app多了安全区相关的css变量，[详见](./css/common/function.md#preset-var)。且所有预置css变量均可参与calc方法的运算。
+
+针对摄像头挖空区、Android底部的全面屏手势、三键导航，uni-app x都新增了获取状态和设置参数的能力。
+包括：
+- [uni.getWindowInfo](./api/get-window-info.md)、
+- [pages.json](./collocation/pagesjson.md#pagesoptionspage-style)中配置hideBottomNavigationIndicator、androidThreeButtonNavigationTranslucent、androidThreeButtonNavigationBackgroundColor、androidThreeButtonNavigationStyle，
+- UniPage对象上的[getPageStyle/setPageStyle方法](./api/unipage.md#unipage-methods)。
+
+uni-app x 的内置UI，包括导航栏、tabbar、video全屏、各种弹窗，均适配了各种屏幕，包括正常屏、折叠屏、小窗模式。
+而 uni-app 未进行更多屏幕的适配和测试。
+
+## 原生插件系统
+
+uni-app 和 uni-app x 都支持uts插件。尤其是API插件，可以同时在 uni-app 和 uni-app x 中使用。
+
+不过uni-app的uts插件，在js和原生通信时采用的是序列化方案，跨语言通信性能欠佳。
+
+uni-app x 基于codegen技术，免除序列化，通信性能更优秀。
+
+在原生组件集成方面，uni-app 和 uni-app x 差异很大。
+
+uni-app 只能在nvue页面里显示原生视图。\
+uni-app x 的界面本就是原生渲染，可以在任意位置显示原生视图。
+
+uni-app 的原生视图插件集成概念不够直观，封装概念较多。\
+uni-app x 内置native-view组件，可以绑定任意原生view，理解和使用更方便。
+
+uni-app x 不支持已经被淘汰数年的App原生插件机制。插件市场在2024年已经不再受理新增的App原生插件了。
+
+uts插件本身的interface.uts和errcode.uts机制，让不同平台原生能力封装为统一的前端API，变的更加规范和便捷。\
+uni-app x 数百个内置组件和API都是基于uts插件实现的，这套原生扩展机制成熟、高效且高性能。
+
+uni-app x 新增了[uasm插件](https://doc.dcloud.net.cn/uni-app-x/plugin/uasm-plugin.html)（uni assembly），可以把高性能二进制库方便引入到前端开发中。\
+并且App平台支持[Node-API](https://doc.dcloud.net.cn/uni-app-x/plugin/uasm-node-api.html)，可以把很多Node生态库引入到App中。
+
+## 热更新
+
+uni-app 和 uni-app x 蒸汽模式均支持wgt热更新。
+
+uni-app 的 wgt 格式是 zip。uni-app x 的 wgt 格式是 zstd。zstd 压缩率更高、解压更快、更先进的压缩格式。可以帮助开发者节省更多cdn流量，减少升级等待。
+
+uni-app x 的热更新，内置sha256验签功能，防止网络劫持，更安全。
+
+uni-app x 的热更新，从联网、下载、验签、安装升级包，全平台都是在子线程统一进行，不影响用户前台操作体验。
+
+总结下，uni-app x 的热更新，更快、更省钱、更安全。
+
+## 离线SDK
+
+uni-app 的离线sdk，仅限于离线打包。对于一个已经存在的原生应用，无法方便嵌入，需改用uni小程序SDK。
+
+uni-app x 的离线sdk，支持离线打包，也支持一个已经存在的原生应用方便的嵌入，实现渐进式使用 uni-app x。[详情](./native/README.md)
+
+## 质量
+
+uni-app 没有自动化测试系统。对于组件和API的质量监控不足。
+
+但 uni-app 无需关心底层渲染引擎的质量，这部分由webview来保障。uni-app x 需要额外关注渲染引擎质量。
+
+uni-app x 有数万个自动化测试例。涉及断言、截图、崩溃、性能、Error各种场景，在Android、iOS、鸿蒙、浏览器、小程序的不同版本全部过测才能发版。
+
+除了内部测试例，开发者报的每个bug，uni-app x 内部在修复时都要补测试例，否则无法发版。数年来积累了大量测试例。
+
+# uni-app x相比uni-app的不足
+
+虽然 uni-app x 比 uni-app 多了很多能力和规范。但当前的状态，也并非拉齐了 uni-app 的所有功能。
+
+1. uni-app x 的css是web的子集。
+
+这个子集足以绘制出任何界面。
+
+对于古法编程的人来说，这个子集限制了写法的灵活性。
+对于AI来说，这个子集其实是优势。AI更适合约束。如果提供太多选择器写法，复杂的权重计算会把AI搞晕，很容易犯错。
+
+2. 小程序支持不全
+
+uni-app 支持所有小程序。
+
+uni-app x 目前仅支持微信小程序和支付宝小程序。接下来会适配抖音小程序。很多小程序平台自身已经停更，uni-app x会根据小程序发展情况决定是否放弃某些小程序的适配。
+
+3. 云打包方面
+
+uni-app x 还不支持安心打包和js加密。js加密，开发者可以使用[uni加固](https://doc.dcloud.net.cn/uni-app-x/tutorial/app-security.html)或其他加固方案解决。
+
+4. API方面
+
+- 暂未内置蓝牙（已在开发中）。目前需要在插件市场寻找蓝牙相关插件。
+- 登录支付海外sdk未集成。目前需要在插件市场寻找相关插件。
+- canvas的API，没有web的丰富。不影响图表等常见功能。[详见](./api/canvasrenderingcontext2d.md)
+- webview的内置API，没有uni-app的plus.webview丰富。[详见](./api/create-webview-context.md)
+
+5. uniCloud schema2code
+
+由于一些datacom组件还未适配，schema2code及相关周边还不能在 uni-app x 下运行。
+
+开发者可以在需求墙投票，影响这些TODO的优先级。[需求墙](https://vote.dcloud.net.cn/#/?name=uni-app%20x)
+
+# 结语
+
+综合优势和不足，可以看出，uni-app x 虽然比 uni-app 少了一些能力，但多了更多能力。所以并非 uni-app x 不如 uni-app 完善，而是相反，uni-app x 更完善、更现代。
+
+随着时间的推移，uni-app x 会更加完善。从2027年起，uni-app 的app平台将不再升级。

package/data/uni-app-x-docs/upload-photo.md

@@ -0,0 +1,86 @@
+---
+title: tmui 3.2.0 组件库
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+#### 表单组件
+
+# 图片上传 TmUploadPhoto
+
+样式丰富塑造性好
+
+## :hot_pepper: 示例
+
+<webview url="https://tmui.design/h5by32/#/pages/index/upload-photo"></webview>
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/upload-photo.vue{vue}
+
+:::
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| maxCount | number | 9 | 最大的可上传数量 | 
+| round | string\|number | 10 | 图片项目圆角。 | 
+| url | string | 'https://mockapi.eolink.com/LRViGGZ8e6c1e8b4a636cd82bca1eb15d2635ed8c74e774/admin/upload_pic/' | 上传地址 | 
+| name | string | 'file' | 上传到服务器的名称字段 | 
+| header | Record\<string, any\> \| null | null | 上传到服务器的头文件 | 
+| formData | Record\<string, any\> \| null | null | 额外的表单数据。 | 
+| imgHeight | string | '110' | 图片高,此处不可使用%单位 | 
+| column | number | 5 | 一行显示几列 | 
+| okFileIsDelete | boolean | true | 上传成功的文件是否允许删除 | 
+| uploadingFileIsDelete | boolean | true | 上传中的文件是否允许删除 | 
+| maxFileSize | number | 1024*1024*30 | 图片上传的限制大小，默认是30mb(可以开启压缩，最后可能比较小) | 
+| statusCode | number | 200 | 开发者服务器响应码,默认是200表示上传成功. | 
+| modelValue | Array\<Record\<string, any\> \| string\> | ()=\>[] | 等同v-model | 
+| rangUrl | string | 'url' | 用于回显时,如果你提供的数组数据是对象,需要指定图片的地址.同时该对象数据会被保留到response字段中 | 
+| beforeDel | func\|boolean | true | 图片被删除时触发如果返回Promise\<false\>删除失败否则成功类型null|(index:number,item:XUPLOADFILE_FILE_INFO)=\>Promise\<boolean\> | 
+| beforeComplete | func\|boolean | true | 你需要原路返回参数提供的itemitem可以自行修改响应内容，响应类型这样可以自己根据服务的内容判断是成功还是失败或者没有权限。修改其中的status来达到成功还是失败TMUPLOAD_PHOTO_STATUS | 
+| autoStart | boolean | true | 是否自动上传 | 
+| sourceType | Array\<'album' \| 'camera'\> | ()=\>['album','camera'] | 图片来源同官方的sourceType：'album','camera' | 
+| compress | boolean | true | 是否压缩 | 
+| compressedHeight | string | 'auto' | 压缩后的缩放高，0表示不压缩高 | 
+| compressedWidth | string | 'auto' | 压缩后的缩放高，0表示不压缩宽 | 
+| quality | number | 80 | 压缩质量 | 
+| addPos | string | 'after' | 添加图片的位置'before'出现在前面'after'出现在后面 | 
+| mode | string | 'scaleToFill' | 图片展示的缩放模式同官方. | 
+| sortable | boolean | true | 是否允许长按拖拽排序 | 
+
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| complete | 名称：-,列表数据, | - | 每次全部上传完时触发 | 
+| change | 名称：-,列表数据, | - | 变化时触发 | 
+| delete | 名称：-,列表数据, | - | 图片被删除时触发 | 
+| update:modelValue | - | - | 同步文件列表。 | 
+
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | - | - | 
+
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| startUpload | - | - | - | 
+| choose | - | - | - | 
+
+