tmui-cli 2.0.6 → 5.3.2

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

@@ -0,0 +1,42 @@
+<!-- UTSAPIJSON.loadUasm.name -->
+
+<!-- UTSAPIJSON.loadUasm.description -->
+
+<!-- UTSAPIJSON.loadUasm.compatibility -->
+
+<!-- UTSAPIJSON.loadUasm.param -->
+
+<!-- UTSAPIJSON.loadUasm.fileFormats -->
+
+<!-- UTSAPIJSON.loadUasm.returnValue -->
+
+<!-- UTSAPIJSON.loadUasm.example -->
+
+<!-- UTSAPIJSON.loadUasm.tutorial -->
+
+<!-- UTSAPIJSON.loadUasm.example -->
+
+
+<!-- UTSAPIJSON.loadUasmSync.name -->
+
+<!-- UTSAPIJSON.loadUasmSync.description -->
+
+<!-- UTSAPIJSON.loadUasmSync.compatibility -->
+
+<!-- UTSAPIJSON.loadUasmSync.param -->
+
+<!-- UTSAPIJSON.loadUasmSync.fileFormats -->
+
+<!-- UTSAPIJSON.loadUasmSync.returnValue -->
+
+<!-- UTSAPIJSON.loadUasmSync.example -->
+
+<!-- UTSAPIJSON.loadUasmSync.tutorial -->
+
+<!-- UTSAPIJSON.loadUasmSync.example -->
+
+<!-- UTSAPIJSON.uasm.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -35,7 +35,7 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于
 
 <!-- UTSAPIJSON.onPushMessage.description -->
 
-> HBuilderX5.25及以上版本 Android平台 新增 options 参数（requestPermission属性）配置配置是否主动申请通知权限
+> Android平台 HBuilderX 5.25及以上版本、鸿蒙平台自 HBuilderX 5.31及以上版本，新增 options 参数（requestPermission 属性），配置是否主动申请通知权限。
 
 <!-- UTSAPIJSON.onPushMessage.compatibility -->
 
@@ -156,32 +156,6 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于
 
 在[nativeResources/android](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#%E5%BA%94%E7%94%A8%E8%B5%84%E6%BA%90)目录可以配置图片和声音的二进制文件资源。
 
-### 关闭自动申请通知权限
-
-为避免应用启动时自动申请通知权限，开发者可以在 `AndroidManifest.xml` 中关闭 Push 模块的自动申请功能(HBuilderX5.23支持)。[配置AndroidManifest.xml](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#%E5%BA%94%E7%94%A8%E6%B8%85%E5%8D%95%E6%96%87%E4%BB%B6-androidmanifest-xml)
-
-在 `<application>` 节点内添加：
-
-```xml
-<application>
-    <meta-data
-        android:name="dcloud_push_auto_request_permission"
-        android:value="false" />
-</application>
-```
-
-配置后：
-
-- 框架不再主动申请 `POST_NOTIFICATIONS` 权限。
-- 通知权限的申请时机和业务逻辑由开发者自行管理。
-- Push SDK 初始化、获取 `clientId` 等功能不受影响。
-- 未获得通知权限时，系统通知可能无法展示。
-
-未配置该项或配置为 `true` 时，框架保持原有行为，自动申请通知权限。
-
-> Android 13（API 33）及以上系统需要申请通知权限。开发者接管权限申请后，应避免在用户拒绝授权时，每次启动应用都重复申请。
-
-
 ### 通知栏显示图标自定义
 关于图标的配置，需要创建[nativeResources](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#%E5%BA%94%E7%94%A8%E8%B5%84%E6%BA%90)目录，
 放置对应分辨率的图片资源即可（打包后生效），目录配置如下

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

@@ -23,3 +23,44 @@ uniCloud是基于serverless的云开发服务，它大幅降低开发者的开
 <!-- UTSUNICLOUDAPIJSON.uniCloud_props.returnValue -->
 
 <!-- UTSUNICLOUDAPIJSON.uniCloud_props.tutorial -->
+
+### datacom 组件示例
+
+Vue 蒸汽模式不支持 `mixin` 语法，可使用属性展开和方法替代，详见 [datacom 组件规范](https://uniapp.dcloud.net.cn/component/datacom.html)。
+
+```html
+<template>
+  <view>
+    <view v-if="datacom.loading">Loading...</view>
+    <view v-else-if="datacom.errorMessage">
+      请求错误：{{datacom.errorMessage}}
+    </view>
+    <view v-else>
+      <!-- 需要自行处理数据及相关UI展现 -->
+      {{datacom.resData}}
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+  const props = defineProps({
+    ...uniCloud.datacomProps, // HBuilderX 5.32
+    multiple: {
+      type: Boolean,
+      default: false
+    }
+  })
+
+  // HBuilderX 5.32
+  const datacom = uniCloud.useDatacom(props)
+
+  // 调用 useDatacom 中的方法加载数据
+  datacom.easyGet()
+
+  defineExpose({
+    loadData: datacom.easyGet,
+    refresh: datacom.refresh,
+    clear: datacom.reset
+  })
+</script>
+```

package/data/uni-app-x-docs/api/unicloud/function.md

@@ -46,7 +46,7 @@ type CallFunctionResult = {
 uniCloud.callFunction<CallFunctionResult>(
   {
     name: 'fn',
-    data: { a: 1 } as UTSJSONObject,
+    data: { a: 1 },
   } as UniCloudCallFunctionOptions
 ).then(function (res) {
   const result = res.result // result的类型为CallFunctionResult

package/data/uni-app-x-docs/api/unicloud/object.md

@@ -40,7 +40,7 @@ export { // 上面的写法可以自己调整，仅需保证export内包含所
 
 用法：`obj.add<泛型类型>()`
 
-在不传泛型时云对象方法返回的类型为`Promise<UTSJSONObject>`，传入泛型后callFunction返回的类型为`Promise<泛型类型>`
+在不传泛型时云对象方法返回的类型为`Promise<any>`，传入泛型后callFunction返回的类型为`Promise<泛型类型>`
 
 **代码示例**
 

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

@@ -0,0 +1,50 @@
+## UniResizeObserver
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.compatibility -->
+
+小程序自身未提供ResizeObserver。社区有三方库可模拟实现，虽性能不及原生ResizeObserver，但在需要时也可以使用。参考[lime-resize](https://ext.dcloud.net.cn/plugin?id=14117)
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.extends -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.param -->
+
+### UniResizeObserver 的方法 @uniresizeobserver-methods
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.example -->

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

@@ -318,7 +318,7 @@ uni-app x 蒸汽模式 提供了应该是业内最好的rich-text组件。
 
 - uni-app x 的App平台到底是自渲染还是原生渲染？
 
-答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。
+答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。自渲染在冷启动和原生混合渲染时劣势明显，参考[《一文讲透原生渲染和自渲染》](./select/native-render-and-self-render.md)
 
 - 为什么都是原生渲染，uni-app x的蒸汽模式比原生渲染更快？
 
@@ -406,12 +406,6 @@ DCloud推出uts语言，是为了解决性能问题，主要是跨语言通信
 同时VDOM模式的uts编写的页面，仍可以通过uts2js运行在蒸汽模式上，不会因此造成向下兼容问题。\
 uni-app x 蒸汽模式也保留了uts插件中操作UI的能力。
 
-至于js和uts本身的执行速度，其实各有千秋。uts的优势主要是跨语言通信折损上。\
-从HBuilderX 5.25+，推出了全新优化的uts插件通道。它也是目前跨语言通信优化的天花板。\
-flutter的dart、react native的js，都有原生插件通道，flutter走的是序列化，react native在turboModules中避免了序列化，但要求使用者构建c++编译环境。\
-而 uni-app x 蒸汽模式的uts插件通道，拥有更好的性能，利用codegen + uts语言特性，即避免了序列化、又无需使用者构建c++环境。并且 uni-app x 拥有比jsi性能更优秀的js桥。\
-另外 uni-app x 中 arraybuffer 是跨语言共享内存的，此数据类型的传递无需跨语言通信。
-
 - uni-app x 虽然渲染快，但逻辑代码使用了js。一个原生应用的代码改成js后，逻辑部分是不是会变慢？
 
 其实js和java/kotlin谁快谁慢，很难定论，只能说各有千秋。比如json处理、字符串正则匹配，在js中这些API其实c语言实现的，而java/kotlin坚持自举，这些基础库是java语言自身写的，反而没有js快。\
@@ -421,6 +415,28 @@ js和c，这对组合，在Android和鸿蒙上都具备动态更新的能力，
 如果担心js的线程问题，uni-app x 提供了 [uts worker](./api/create-worker.md)。\
 整体来讲，把原生应用迁移为 uni-app x，你的用户的感受肯定是更流畅。
 
+- uni-app x 逻辑层改成js后，调用原生的跨语言通信成本是否上升了？
+
+跨语言通信成本，曾经是很多跨平台框架的痛点。尤其是Android平台，js 和 kotlin 中间还隔着一个c。但时代已不同。
+
+跨语言通信最高频的是UI。\
+原生UI在kotlin层，驱动逻辑在js层，创建一个组件来回通信，页面上组件多起来就会变卡。react native 一直都有这问题。\
+但 uni-app x 蒸汽模式，template和style的代码是直接编译字节码/机器码的，不是编译成js，根本不需要js和kotlin来回通信。这套机制不但超越了 react native 的跨语言通信，连原生开发的同语言UI操作都无法与 uni-app x蒸汽模式 匹敌。\
+同时在Element API等必须在js里操作原生UI的场景，也定制了高效的通信方案，单次跨语言通信的成本仅在0.001毫秒左右。
+
+除了UI，另一个跨语言通信场景是原生插件。\
+过去老的uni-app，以及react native、flutter，在js和原生通信时搭建通用通信桥，都使用了序列化方案。\
+react native已经改用了turboModules架构，通过codegen方式避免序列化。\
+uni-app x 蒸汽在Android平台也是codegen的（HBuilderX 5.25+），没有序列化，而且也不需要像react native的turboModules那样要求开发者编译c++代码。\
+目前仅flutter的原生插件仍然在序列化，原生通信性能较低。
+
+另外 uni-app x 中 arraybuffer 是跨语言共享内存的，此数据类型的传递无需跨语言通信。\
+比如高频调用蓝牙数据，从原生传递到js，使用的是共享内存的arraybuffer，原生通过系统蓝牙API获取到arraybuffer，js层可直接读取arraybuffer，不存在跨语言通信折损。\
+至于持续定位，其实不高频，采集频率是秒级的，uni-app x的跨语言通信成本是微秒级的，折算成秒，是0.000001秒左右。\
+
+所以虽然uni-app x 蒸汽模式改用了js引擎，但开发者无需像过去那样忧虑跨语言通信问题。
+
+
 本章节主要是围绕性能的FAQ。整个 uni-app x 的FAQ，另见[概述](./readme.md#FAQ)
 
 注意：部分开发者在AI上询问 uni-app x 蒸汽模式为什么这么快，除了上面公开的这几点，AI输出的其他观点都是瞎猜。uni-app x 的技术路线是首创的，不存在于AI熟悉的现有技术栈中。
@@ -485,10 +501,6 @@ ninja: error: failed recompaction: Permission denied。
     * list-view下仅第一个在list-item上的v-for且有:key属性，才支持复用。如果一个list-view下多组list-item各自有v-for，第2个起的v-for并不复用
     * list-item和list-view需要编写在同一个uvue文件内，否则list-item不会被复用。即，不要把list-item包装到另一个组件。
     * 符合条件能复用的list-item会当做真正的list-item，其他不符合复用条件的list-item都会被编译为view。
-    * list-view不支持横向滚动
-    * list-item宽度固定为100%，获取position时固定为absolute。
-    * list-item不支持直接以文字节点作为子节点，必须使用text包裹文字内容。
-    * list-item不支持设置margin
 - 变更：swiper组件的变化
     * 可以通过indicator-class、indicator-active-class自定义默认指示器的样式
     * 可通过 `<template v-slot:indicator>` ，传入自定义的指示器
@@ -507,7 +519,6 @@ ninja: error: failed recompaction: Permission denied。
   * 拍平的元素无法支持事件（如click、touch）
   * 拍平的元素不支持截图API：takeSnapshot
   * 拍平时如下css不支持：
-    + 不支持 [visibility](css/visibility.md)
     + 不支持 [z-index](css/z-index.md)
     + 不支持 [background-image](css/background-image.md)、[background-clip](css/background-clip.md)
     + 不支持 [pointer-events](css/pointer-events.md)
@@ -516,6 +527,10 @@ ninja: error: failed recompaction: Permission denied。
     + [transition](css/transform.md) 动画不支持渲染相关（如background-color）的样式
   * image组件拍平后无法播放动画，gif、webp动画仅显示第一帧
   * view组件拍平后css属性transform、overflow、display、opacity存在缺陷，如果view存在子元素，这些样式不会对非拍平的子元素产生效果
+  * css属性[visibility](css/visibility.md)存在差异
+    + app-android平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的子元素默认仍然会显示，子元素的显示状态由其自身的visibility决定
+    + app-ios平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的非拍平子元素默认仍然会显示，非拍平子元素的显示状态由其自身的visibility决定，而拍平子元素会跟随此view不可见
+    + app-harmony平台visibility暂不支持拍平
 
   注意：当自定义组件的单根节点是（view、text、image）时，该自定义组件会自动支持flatten属性，并将其传递给它的单根节点，如果在不符合要求的自定义组件上使用flatten属性，则会被自动忽略。
 
@@ -542,8 +557,13 @@ ninja: error: failed recompaction: Permission denied。
 
 其他还有一些差异，见文档的兼容性说明。
 
+
 ## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
 
+在uni-agent中有内置的skill，可以方便的升级vdom到蒸汽。
+
+如果你需要手动处理，可以参考以下步骤：
+
 1. 在vdom模式下，要求uni-agent把复杂的组合选择器，改成 简单的class选择器或分组选择器，确认是否正常
 2. 在vdom模式下，打开manifest.json中的样式隔离策略2.0，把[文档](css/common/style-isolation.md)贴给ai，要求ai改造，确认是否正常。如涉及三方组件，核对三方组件的新版是否支持样式隔离策略2.0，尽量选择支持该策略的组件。官方的 [uni ui x](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/) 是支持的。
 3. 由于改用js驱动，Android的uvue页面中，不能直接调用原生API，相关调用需挪到uts插件中，包括utsAndroid，在uvue页面下将不可用。让uni-agent协助完成改造。
@@ -560,40 +580,13 @@ ninja: error: failed recompaction: Permission denied。
 
 uni-app x 是逻辑层和视图层分离，逻辑层即script内，是uts/js。视图层是`template`和`style`区域。
 
-App平台的蒸汽模式下，视图层有较大的变化。
-
-VDOM模式的视图层是编译为uts/js代码，然后驱动原生渲染。
-
-而蒸汽模式的视图层，把`template`和`style`直接编译为底层c代码对应的机器码/字节码。
-
-根据编译目标不同，App平台的视图层产物分为字节码和机器码两种模式。
-
-### 机器码
-
-机器码模式，是把`template`和`style`编译为优化度非常高的C代码，再经平台编译器编译为机器码运行。
-
-优点：
-- 渲染性能高一点点。
-
-缺点：
-- 编译速度比字节码模式慢非常多，因为需要编译C代码。大型工程的c++编译是非常非常慢的。
-- 开发阶段的差量编译体验差。
-- iOS只能在mac电脑上开发。
-
-### 字节码
-
-为了平衡机器码的性能和开发易用性。从5.11起新增了字节码编译模式。字节码也是二进制格式。
-
-优点：
-- 编译速度更快。
-- 开发阶段支持差量更新。
-- 发行后支持 wgt 热更新。（暂未上线）
+蒸汽模式的视图层，把`template`和`style`直接编译为底层的机器码或字节码。
 
-缺点：
-- 渲染性能低于机器码3%左右。由于蒸汽模式比原生快了数倍，所以字节码虽比机器码慢了一点点，但仍快过原生数倍。
+- 机器码：是把`template`和`style`编译为优化度非常高的C代码，再经平台编译器编译为机器码运行。性能略高但编译非常慢。
+- 字节码：需HBuilder 5.11+。把机器码改成字节码，编译速度更快。性能比机器码低3%左右。发行后可支持 wgt 热更新（需HBuilder 5.31+）。
 
 正常情况下，使用字节码即可。
 
 因为最初在5.0版上线鸿蒙蒸汽模式时只有机器码，所以目前在鸿蒙上是提供了字节码或机器码2个选项。
 
-而在后续上线iOS和Android蒸汽模式时，只提供了字节码选项。实测机器码会造成云打包非常非常慢，暂不计划开放。
+而在后续上线iOS和Android蒸汽模式时，只提供了字节码选项。

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

@@ -1,6 +1,6 @@
 # App.uvue
 
-`App.uvue`是uni-app-x的主组件。
+`App.uvue`是 uni-app x 的主组件。
 
 所有页面都是在`App.uvue`下进行切换的，是应用入口文件。但`App.uvue`本身不是页面，这里不能编写视图元素，也就是没有`<template>`。
 
@@ -218,7 +218,7 @@ globalData依赖于vue和js环境，在页面里都使用，但在uts插件中
 ### 组合式 API 示例：
 
 ```ts
-<script setup lang="uts">
+<script setup lang="ts">
   defineOptions({
     globalData: {
       str: 'global data str',
@@ -233,7 +233,7 @@ globalData依赖于vue和js环境，在页面里都使用，但在uts插件中
 页面或组件中通过 `getApp().globalData` 访问。
 
 ```ts
-<script setup lang="uts">
+<script setup lang="ts">
   const globalDataStr = ref('')
   const globalDataNum = ref(0)
   const globalDataBool = ref(false)

package/data/uni-app-x-docs/collocation/manifest-android.md

@@ -780,6 +780,58 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。
   ```
 
 
+### JS引擎
+蒸汽模式下 Android 平台业务逻辑代码运行在Google V8 JS 引擎中。  
+Google V8 引擎通过 Android NDK 编译为 .so 动态链接库，且需要针对多种 CPU 架构（如 armeabi-v7a、arm64-v8a 等）分别打包。为严格控制 APK 的安装包体积，构建时默认禁用了 ICU 模块（编译参数 v8_enable_i18n_support = false）。  
+
+在uni-app x项目中使用包含 ICU 功能的 V8 引擎，需在manifest.json中配置：  
+
+- HBuilderX 5.33 及以上版本  
+  需通过 manifest.json 的`源码视图`在 "app-android" -> "distribute" -> "modules" 下添加 "v8-icu" 节点，如下示例：  
+  ```json
+  {
+    "app-android": {
+      "distribute": {
+        "modules": {
+          "v8-icu": {}
+        }
+      }
+    }
+  }
+  ```
+
+启用该裁剪后，所有与国际化（i18n）、本地化格式化以及复杂 Unicode 字符处理相关的 API 与特性将被限制或禁用，具体影响如下：  
++ [Intl](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl) 全局对象不可用  
+  Intl 全局对象及相关 API 将完全不可用，影响的具体 API 包括：  
+  - Intl.DateTimeFormat：日期和时间的本地化格式化  
+  - Intl.NumberFormat：数字、货币、百分比的本地化格式化  
+  - Intl.Collator：基于特定语言环境的字符串排序与比较  
+  - Intl.PluralRules：复数形式的匹配与选择规则  
+  - Intl.RelativeTimeFormat：相对时间格式化（如“3 天前”）  
+  - Intl.Segmenter：文本分词、断句与断字  
+  - Intl.ListFormat：连贯列表文本格式化（如“A、B 和 C”）  
+  - Intl.DisplayNames：标准代码/标识符（如国家/地区代码、语言代码）的显示名称转换  
++ 标准 String & Date 原型链方法本地化能力退化  
+  - 字符串转换退化：  
+    String.prototype.toLocaleLowerCase()：退化为普通的 toLowerCase()  
+    String.prototype.toLocaleUpperCase()：退化为普通的 toUpperCase()  
+    String.prototype.localeCompare()：无法按指定 locale 的字典顺序排序，直接退化为基于 Unicode 码点（Code Point）的逐字符比较  
+  - 日期与数字格式化退化：  
+    以下方法无法根据传入的 locale 参数（如 'zh-CN', 'en-US', 'de-DE'）生成本地化字符串，而是统一退化为固定的 ISO 或默认英文格式输出。  
+    Date.prototype.toLocaleString()  
+    Date.prototype.toLocaleDateString()  
+    Date.prototype.toLocaleTimeString()  
+    Number.prototype.toLocaleString()  
++ 复杂文本分词、大小写折叠与 Unicode 边界识别受限  
+  - Unicode 规范化受限：String.prototype.normalize() 方法在处理带重音符号或组合字符（Combining Characters）的字符串时，可能报错或无法准确转换。
+  - 边界文本识别削弱：缺少 Unicode 字符数据库（UCD）支持，在处理非 ASCII 字符、复杂语系（如泰语、阿拉伯语、印地语）及复合 Emoji 时可能产生异常：  
+    * 字符长度统计偏离：基于 UTF-16 单元格的 .length 属性在测量复合字符（如组合 Emoji 👨‍👩‍👧‍👦）时，无法反映真实的用户视觉字符（Grapheme Cluster）数量。  
+    * 字符截断破坏字形：使用 substring()、slice() 等方法切片时，极易在组合字符中间发生错位截断，导致显示乱码或产生非法占位符。  
++ 正则表达式 Unicode 属性转义匹配受限  
+  在正则表达式开启 u 或 v 标志（Unicode Mode）时，依赖 Unicode 属性匹配（Unicode Property Escapes）的功能会受到影响：  
+  例如 \p{UnicodeProperty} 或 \p{Script=Han}（用于匹配汉字、特定语种字符集或 Emoji 属性分类）等语法，因缺乏 ICU 提供的 UCD 数据库支持，会导致引擎抛出 SyntaxError 或无法正确识别非 ASCII 字符的属性。  
+
+
 
 ## 权限配置 @permissions  
 

package/data/uni-app-x-docs/collocation/manifest-modules.md

@@ -4,7 +4,7 @@
 
 > HBuilderX 4.63之前的版本鸿蒙平台不支持根据使用情况自动添加模块，HBuilderX 4.63及之后的版本鸿蒙平台支持根据使用情况自动添加模块。鸿蒙平台独立于基础库之外的模块列表和安卓iOS不一致，详情参考：[鸿蒙平台模块配置](./manifest-harmony.md#modules)
 
-uni-app x的Android基础库体积是7M，打包后的apk体积是基础库的体积加上开发者的代码及代码引用的模块的体积。有些模块涉及so库，覆盖的cpu指令越多，包体积越大。
+uni-app x 打包后的体积是基础库的体积加上开发者的代码及代码引用的模块的体积。有些模块涉及so库，覆盖的cpu指令越多，包体积越大。
 
 在uni-app js引擎版中，内置模块如video，是开发者在manifest.json中手动勾选配置的。
 
@@ -169,9 +169,13 @@ HBuilderX3.93版本起，编译器支持扫描代码，摇树treeShaking，自
 再次强调，以上模块不属于ext组件或api，是内置模块。但如果你的代码中没有使用这些组件和api，打正式包或自定义基座时会被摇掉。
 
 
-### 手动配置使用的模块  
+### 手动配置使用的模块@manual
 
-uts插件中暂不支持摇树，如果uts插件中使用了以上模块，需在使用此uts插件的 uni-app x 项目 manifest.json 文件中手动添加：  
+有些场景无法通过摇树来决定打包哪些模块，比如：
+- 为了将来热更新考虑，提前打包一些模块到安装包中
+- uts插件中通过uni.xx的api调用了内置模块，这部分也暂不支持摇树识别
+
+此时需在项目 manifest.json 文件中手动添加模块：
 
 - HBuilderX 4.71 及以上版本  
   + Android平台  
@@ -274,6 +278,7 @@ HBuilderX4.31 支持打包界面直接勾选广告渠道，参考[App打包配
 | :-		| :-					|:-	|:-		|:-		|
 | gdt		| 腾讯优量汇广告联盟		|x	|3.99	|4.22	|
 | gm		| 穿山甲GroMore			|x	|3.99	|4.22	|
+| gm-content| 穿山甲内容联盟（短剧/信息流）|x	|5.31	|x		|
 | ks		| 快手广告联盟			|x	|3.99	|4.22	|
 | bd		| 百度百青藤广告联盟		|x	|3.99	|4.22	|
 | sigmob	| Sigmob广告联盟			|x	|3.99	|4.22	|
@@ -304,6 +309,25 @@ HBuilderX4.31 支持打包界面直接勾选广告渠道，参考[App打包配
 app平台默认`启动界面`为白色（暗黑模式下为黑色），为了避免等待加载开屏广告时白屏，建议开通开屏广告后在manifest中配置`启动界面`，详情参考[splash启动界面](./manifest-splashscreen.md)
 :::
 
+#### 短剧广告
+
+配置 `gm-content` 模块后，可使用短剧广告。短剧广告来自 uni-ad 内容聚合模块（短剧/信息流场景，对应穿山甲内容生态），用户免费观看指定集数后，观看激励视频解锁后续剧集。
+
+使用短剧广告需完成以下配置：
+
+1. 在 [uni-ad 后台](https://uniad.dcloud.net.cn/) 开通短剧广告位，获取广告位标识 `adpid`；
+2. 在穿山甲后台 `内容输出 -> 接入管理` 下载应用的 SDK 参数配置文件，重命名为 `gm_SDK_Setting.json`，放到项目根目录的 `nativeResources/android/assets/` 目录下；
+3. 制作自定义基座（标准基座不包含短剧运行时，会报错 `-5020`）。
+
+代码使用方式：
+
+- API 模式（自行搭建短剧列表页，调用 `open` 打开原生播放页）：[uni.createDramaAd](../api/create-drama-ad.md)
+- 组件模式（内嵌短剧首页 Fragment）：[ad-drama 组件](../component/ad-drama.md)
+
+::: warning 注意事项
+短剧广告仅支持 Android 平台。
+:::
+
 #### 广告缓存
 
 广告SDK在运行时可能会下载apk安装文件，占用手机的存储空间。下表列举了广告SDK的apk下载路径。开发者可以按需删除指定apk文件。

package/data/uni-app-x-docs/collocation/pagesjson.md

@@ -94,6 +94,8 @@ globalStyle节点里是所有页面都生效的全局样式配置。它的配置
 
 <!-- PAGESJSON.globalStyle_mp-alipay.table -->
 
+支付宝小程序默认开启页面回弹，可能影响触摸事件；可以将 `allowsBounceVertical` 配置为 `NO` 关闭页面回弹。
+
 
 #### mp-weixin 配置项列表 @globalstyle-mp-weixin
 
@@ -180,6 +182,7 @@ pages节点里注册页面，数据格式是数组，数组每个项都是一个
 	* 小程序平台，pages.json中各个颜色的设置仅支持普通的16进制数值。App和Web支持设为transparent，即透明。
 	* 如需动态设置状态栏颜色，使用api [uni.setNavigationBarColor](../api/set-navigation-bar-color.md)
 	* 当navigationStyle设为custom时，原生导航栏不显示。此时需要注意系统状态栏背景色恒为透明。
+	* 支付宝小程序不支持完全自定义导航栏，配置 `navigationStyle: "custom"` 不生效。
 	* 注意不同手机的状态栏高度并不相同，如需获取本机的状态栏高度，使用api [uni.getWindowInfo](../api/get-window-info.md) 或 css变量 [--status-bar-height](../css/common/variable.md)
 	* 配置hideStatusBar可以隐藏状态栏
 	* 同时隐藏状态栏hideStatusBar和底部指示器hideBottomNavigationIndicator，可以实现页面全屏

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

@@ -94,7 +94,7 @@ uni-app发明了完善的条件编译，帮助开发者处理平台差异。即
 	<image :src="imga"/> <!-- 变量的静态资源，不会被编译器打包，文件丢失。不推荐 -->
 	<image src="/static/3.png"/> <!-- static目录会整体被copy到编译产物。推荐 -->
 </template>
-<script setup lang="uts">
+<script setup>
 	import logo from './logo.png';
 
 	const imga = './2.png'

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

@@ -1,6 +1,15 @@
 # 组件概述
 
-## 组件定义
+web的概念叫标签，比如div、input。
+这些标签都很重，div即用于布局、也用于文字显示、也用于滚动容器；input除了输入框，还承载了几乎所有表单组件的功能。
+
+uni-app x，和小程序采用了相同的组件规范。不叫标签，就叫组件。
+
+这套组件规范的语义更明确：view是布局组件、text是文字组件、scroll-view是滚动组件、input是输入框组件、checkbox/radio/slider/switch/也各自是独立组件。
+
+清晰的语义，也不容易让AI搞错。
+
+## 什么叫组件
 
 - 组件是视图层的基本组成单元。
 - 组件是一个单独且可复用的UI及配套功能模块的封装。
@@ -130,7 +139,7 @@ uni-app x文档规范中有一批标准组件，同时也支持扩展自定义
 即开发者自己按照vue组件规范编写的uvue文件。这种组件一般由前端工程师编写。详见[uvue组件模型介绍](../vue/component.md)
 - 2.2 原生uts组件
 这是一种App平台专用的扩展机制。
-由Android或iOS的原生开发者，按照uts插件的组件规范编写，把原生的view嵌入到uvue页面上，它在编写时贴近但不完全是vue组件开发规范。\
+由Android、iOS、鸿蒙的原生开发者，按照uts插件的组件规范编写，把原生的view嵌入到uvue页面上，它在编写时贴近但不完全是vue组件开发规范。\
 不过对于组件的使用者来讲，用法就是标准的uvue组件了。详见[uts组件开发指南](../plugin/uts-component.md)\
 uts原生组件，下载组件到项目后（或自己按规范编写），在页面template里直接引用即可。无需导入注册组件。
 
@@ -159,7 +168,6 @@ easycom组件是uni-app(x)提供的一种易用方式，它通过一个路径规
 
 组件开发完毕后可发布到插件市场，插件作者指南：[详见](https://doc.dcloud.net.cn/uni-app-x/plugin/publish.html)
 
-<!-- TODO下面这段应该挪走 -->
 ## 调用组件方法@methods
 
 需要把组件分为 内置组件、easycom组件、非easycom组件，这3种组件有不同的方法调用方式。[详情](../vue/component.md#page-call-component-method)

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

@@ -62,6 +62,7 @@
     * [canvas | 画布](canvas.md)
   * 广告
     * [ad | 信息流广告](ad.md)
+    * [ad-drama | 短剧](ad-drama.md)
   * 网页
     * [web-view](web-view.md)
   * 页面属性配置节点
@@ -70,11 +71,14 @@
     * [page-meta](page-meta.md)
   * unicloud
     * [unicloud-db](unicloud-db.md)
-* [uni-ui x 扩展组件](./uni-ui-x/README.md)
+* uni-ui x 扩展组件
+  * [概述](./uni-ui-x/README.md)
   * [uni-badge-view | 数字角标](./uni-ui-x/uni-badge-view.md)
   * [uni-collapse | 折叠面板容器](./uni-ui-x/uni-collapse.md)
+  * [uni-combox | 组合框](./uni-ui-x/uni-combox.md)
   * [uni-drag-cell | 可拖拽排序](./uni-ui-x/uni-drag-cell.md)
   * [uni-fab-button | 悬浮按钮](./uni-ui-x/uni-fab-button.md)
+	* [uni-icons | 字体图标](./uni-ui-x/uni-icons.md)
   * [uni-index-bar | 索引条](./uni-ui-x/uni-index-bar.md)
   * [uni-link | 链接](./uni-ui-x/uni-link.md)
   * [uni-number-box | 数字输入框](./uni-ui-x/uni-number-box.md)

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

@@ -0,0 +1,48 @@
+<!-- ## ad-drama -->
+
+<!-- UTSCOMJSON.ad-drama.name -->
+
+<!-- UTSCOMJSON.ad-drama.description -->
+
+短剧广告：通过短剧内容生态 `穿山甲内容联盟(短剧)` 变现的高价值广告形式。将短剧内容（列表）嵌入自己的应用中，用户免费观看指定集数后，需观看激励视频解锁后续剧集，从而实现广告变现。
+
+ad-drama 组件是短剧广告的组件模式接入方式：组件挂载即自动加载短剧列表，适合快速接入短剧。如需自定义显示短剧列表界面，请使用 API 模式（[uni.createDramaAd](../api/create-drama-ad.md)）接入。
+
+- uni-ad的业务介绍：[详见](https://uniapp.dcloud.net.cn/uni-ad/)
+- 示例Demo：[详见](https://gitcode.com/dcloud/uni-ad-drama)
+
+**开通配置广告**
+
+[开通广告步骤详情](https://uniapp.dcloud.net.cn/uni-ad/ad-open.html)
+
+**Tips**
+- HBuilder 5.32 版本 app-android 平台支持。
+- 使用短剧组件需要先开通穿山甲广告，相关问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
+- 标准基座不包含短剧功能，需勾选广告联盟中的“穿山甲内容联盟(短剧)”，打包自定义基座后运行，否则报错 `-5020` 错误。
+
+### 配置文件
+
+短剧功能使用的“穿山甲内容联盟(短剧)”要求配置 `SDK参数配置` 文件，在穿山甲后台 "内容输出" -> "接入管理" 找到需要接入内容SDK的应用，点击"下载SDK参数配置"：
+
+![](https://lf3-plat.pglstatp-toutiao.com/obj/union-platform/a30bc3001dff716fcf6876da15151ecf.png)
+
+配置文件下载之后重命名为 `gm_SDK_Setting.json`，然后将文件放到到 uni-app x 项目的 `nativeResources\android\assets` 文件夹中。
+
+<!-- UTSCOMJSON.ad-drama.readme -->
+
+<!-- UTSCOMJSON.ad-drama.compatibility -->
+
+<!-- UTSCOMJSON.ad-drama.attribute -->
+
+<!-- UTSCOMJSON.ad-drama.fileFormates -->
+
+<!-- UTSCOMJSON.ad-drama.event -->
+
+<!-- UTSCOMJSON.ad-drama.component_type -->
+
+<!-- UTSCOMJSON.ad-drama.children -->
+
+
+<!-- UTSCOMJSON.ad-drama.example -->
+
+<!-- UTSCOMJSON.ad-drama.reference -->

package/data/uni-app-x-docs/component/button.md

@@ -79,7 +79,7 @@ button 组件没有 url 属性，点击后需要跳转页面时，可在 @click
 	</view>
 </template>
 
-<script setup lang="uts">
+<script setup>
 	function gotoAbout() {
 		uni.navigateTo({
 			url: '/pages/about/about'

package/data/uni-app-x-docs/component/camera.md

@@ -20,6 +20,8 @@ camera组件的操作api为[uni.createCameraContext()](../api/create-camera-cont
 
 给camera组件设一个id属性，将id的值传入uni.createCameraContext()，即可得到camera组件的上下文对象，进一步可使用`.takePhoto()`、`.startRecord()`等方法。
 
+支付宝小程序需要在 camera 组件初始化完成、触发 `onReady` 回调后再调用 `uni.createCameraContext`，并且必须传入 camera 组件的 `id`。
+
 <!-- UTSCOMJSON.camera.example -->
 
 ### 依赖库版本

package/data/uni-app-x-docs/component/canvas.md

@@ -38,6 +38,8 @@ uni-app x 中废弃了老版方案，使用了 W3C 规范和微信小程序的
 
 注意：新版规范需要开发者根据自己的场景手动处理高清屏问题。
 
+支付宝小程序通过 `createImage` 获取图片对象时，`src` 不能设置为本地图片；必须在 `canvas` 组件的 `onReady` 回调中获取 canvas 实例和上下文。
+
 canvas相关的API较多，参考如下：
 
 - [W3C 规范](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/canvas)