tmui-cli 5.3.1 → 5.3.2

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

@@ -83,9 +83,10 @@
 * [暗黑模式](api/theme-change.md)
 * [宽屏适配](adapt.md)
 * [国际化](i18n.md)
-* [源码和示例](sample.md)
+* [案例和开源示例](sample.md)
 * [兼容性表格导读](tutorial/compatibility.md)
 * 选型参考
+	* [AI时代还需要跨平台框架吗？](./select/crossplatform-on-ai.md)
 	* [一文讲透原生渲染和自渲染](./select/native-render-and-self-render.md)
 	* [uni-app x和uni-app的对比](./uniappvsuniappx.md)
 * [uni-app 升级 uni-app x](uniapptox.md)

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

@@ -5,6 +5,7 @@
   * [动画帧](animation-frame.md)
   * [Path2D](path2d.md)
   * [Image](image.md)
+  * [UniResizeObserver](uniresizeobserver.md)
 * 基础
   * [环境变量](env.md)
   * [事件总线](event-bus.md)
@@ -101,6 +102,7 @@
   * [获取文件管理器](get-file-system-manager.md)
   * [打开文档](open-document.md)
   * [选择文件](choose-file.md)
+  * [转换为绝对路径](convert2-abs-full-path.md)
 * 数据存储
   * [key-value本地数据存储](storage.md)
 * 画布
@@ -121,6 +123,7 @@
   * [开屏广告manifest配置](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-ad)
   * [激励视频广告](create-rewarded-video-ad.md)
   * [插屏广告](create-interstitial-ad.md)
+  * [短剧](create-drama-ad.md)
 * 支付
   * [支付（requestPayment）](request-payment.md)
   * [虚拟支付（requestVirtualPayment）](virtual-payment.md)

package/data/uni-app-x-docs/api/convert2-abs-full-path.md

@@ -0,0 +1,33 @@
+<!-- UTSAPIJSON.convert2AbsFullPath.name -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.description -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.compatibility -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.param -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.fileFormats -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.returnValue -->
+
+<!-- UTSAPIJSON.convert2AbsFullPath.example -->
+
+以下为转换结果示例，实际路径因平台、系统版本不同而有所差异
+
+```js
+uni.convert2AbsFullPath('/static/logo.png')
+```
+
+返回值为绝对路径，各平台结果如下：
+
+| 平台 | 返回值 |
+| --- | --- |
+| Android | `/data/data/<package-name>/apps/<appid>/www/static/logo.png` |
+| iOS | `/var/mobile/Containers/.../Documents/uni-app-x/apps/<appid>/www/static/logo.png` |
+| Harmony | `/data/storage/el1/bundle/.../resfile/uni-app-x/apps/<appid>/www/static/logo.png` |
+
+<!-- UTSAPIJSON.convert2AbsFullPath.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -2,38 +2,47 @@
 
 <!-- UTSAPIJSON.createDramaAd.description -->
 
-短剧广告：通过短剧内容生态（穿山甲内容联盟）变现的高价值广告形式。开发者将短剧内容（列表、播放页）嵌入自己的应用，用户免费观看指定集数后，需观看激励视频解锁后续剧集，从而实现广告变现。
+短剧广告：通过短剧内容生态 `穿山甲内容联盟(短剧)` 变现的高价值广告形式。将短剧内容（列表）嵌入自己的应用中，用户免费观看指定集数后，需观看激励视频解锁后续剧集，从而实现广告变现。
 
-uni-app x 内置短剧 uni-drama，提供两种接入方式：
+通过 uni.createDramaAd 可实现 API 模式接入方式： 调用查询接口获取短剧数据，自定义实现短剧列表界面，用户点击后通过 `open` 打开短剧播放界面。如需快速接入，请使用（[ad-drama](../component/ad-drama.md)）组件模式接入。
 
-| 接入方式 | 说明 | 适用场景 |
-| :- | :- | :- |
-| API 模式 | 通过 `uni.createDramaAd` 创建实例，自行搭建短剧列表页，调用查询接口获取短剧数据，再调用 `open` 打开原生播放页 | 需要自定义短剧列表页样式、深度定制业务 |
-| 组件模式 | 使用 `<ad-drama>` 组件（native-view）| 快速接入，直接使用渠道提供的短剧首页 |
-
-组件模式另见：[ad-drama 组件](../component/ad-drama.md)。
-示例Demo另见：[详见](https://gitcode.com/dcloud/uni-ad-drama)
+- 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**
-- 标准基座不支持测试短剧功能。
-- 使用短剧组件需要先开通穿山甲广告。开通问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
-- 标准基座不包含短剧运行时，需制作自定义基座后运行，否则报错 `-5020`。
+- HBuilder 5.32 版本 app-android 平台支持。
+- 使用短剧组件需要先开通穿山甲广告，相关问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
+- 标准基座不包含短剧功能，需勾选广告联盟中的“穿山甲内容联盟(短剧)”，打包自定义基座后运行，否则报错 `-5020` 错误。
 
 ### 配置文件
 
-在穿山甲后台 内容输出->接入管理 找到需要接入内容SDK的应用，点击"下载SDK参数配置"，然后将SDK配置文件（例如 sdk_setting_file.json）拷贝到项目的 assets 文件夹下。
+短剧功能使用的“穿山甲内容联盟(短剧)”要求配置 `SDK参数配置` 文件，在穿山甲后台 "内容输出" -> "接入管理" 找到需要接入内容SDK的应用，点击"下载SDK参数配置"：
 
 ![](https://lf3-plat.pglstatp-toutiao.com/obj/union-platform/a30bc3001dff716fcf6876da15151ecf.png)
 
-文件下载之后重命名为：`gm_SDK_Setting.json`，然后将文件放到项目根目录的`nativeResources->android->assets`目录下。
+配置文件下载之后重命名为 `gm_SDK_Setting.json`，然后将文件放到到 uni-app x 项目的 `nativeResources\android\assets` 文件夹中。
 
 ### 服务器回调
 
-用户观看激励视频解锁剧集后，为防止客户端伪造看完广告的凭据，解锁集数的发放由服务器回调完成，这是业内通行的安全方案。调用 `open` 时传入 `urlCallback`（userId/extra），激励发放时会透传到业务服务器参与校验。服务器回调机制详见 [激励视频广告服务器回调](https://uniapp.dcloud.net.cn/uni-ad/ad-rewarded-video.html#callback)。
+短剧的变现逻辑是：用户免费看完前面几集后，需要看一段激励视频才能解锁后续剧集。这里有一个关键的安全问题——"用户到底有没有真的看完广告"，这件事不能听客户端的。
+
+客户端播放结束时的结果（如 `isEnded`）只是本地状态，很容易被黑产通过反编译、抓包伪造请求来冒充。如果直接按客户端上报来解锁，攻击者可以一次广告都不看就骗取解锁，而广告平台那边并没有真正产生广告收入，最后是开发者既赔了内容又拿不到钱。
+
+所以，解锁集数的发放必须由服务器回调来完成：用户完整看完激励视频后，广告平台会通知 uni-ad，uni-ad 再通过 uniCloud 把"这次广告确实看完了"的可信消息发送到开发者自己的业务服务器，由业务服务器来发放解锁。这条链路黑产无法伪造，是业内通行的安全方案（支付回调同理），没有配置服务器回调的解锁是不安全的。
+
+接入步骤：
+
+1. 在 uni-ad 后台为短剧广告位开启激励视频服务器回调，并选择业务所在位置：业务在 uniCloud 则选云函数/云对象；业务在传统服务器则配置回调 URL。
+2. 调用 `open` 时传入 `urlCallback`，用于把业务身份带给服务器：
+   - `userId`：用户唯一标识，服务器据此知道该给谁解锁；
+   - `extra`：业务自定义参数，例如本次要解锁的剧集 ID、订单号等，回调时原样回传。
+3. 业务服务器收到回调后，按 `userId` / `extra` 校验并解锁对应集数。客户端不要自行解锁，只根据服务器结果刷新界面。
+
+服务器回调的详细机制、回调参数、签名校验和完整配置流程，详见 [激励视频广告服务器回调](https://uniapp.dcloud.net.cn/uni-ad/ad-rewarded-video.html#callback)。
 
 <!-- UTSAPIJSON.createDramaAd.compatibility -->
 

package/data/uni-app-x-docs/api/create-selector-query.md

@@ -54,7 +54,7 @@ createSelectorQuery是小程序的API，因小程序未开放DOM，且视图层
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
   const instance = getCurrentInstance()!.proxy!
   const nodeInfoList = ref<NodeInfo[]>([])
 
@@ -131,7 +131,7 @@ uni.createSelectorQuery().select('.rect1').selectAll('.rect2').boundingClientRec
     <button @click="query">query</button>
   </view>
 </template>
-<script setup lang="uts">
+<script setup lang="ts">
   const instance = getCurrentInstance()!.proxy!
 
   const query = () => {

package/data/uni-app-x-docs/api/create-worker.md

@@ -14,7 +14,7 @@ uni-app x的代码，默认都是在主线程执行的，主线程也称为UI线
 - 线程之间通信，可以post消息，也可以共享变量。web和小程序仅支持shareArrayBuffer数据类型的共享。App平台没有限制，引用类型都可以共享变量。但共享变量时，需要开发者注意线程安全问题，避免多线程同时写同一个变量，或一个线程读、同时另一个线程在写同一个变量，这可能引发崩溃。
 - 线程和Android的协程是不同的。Android上request api内部已经使用了协程。
 - CPU的核数有限，不要同时开太多线程。
-- worker是一个uts API，无法在js环境使用。iOS平台、Android的蒸汽模式， Worker 仅支持在[uts插件](../plugin/uts-plugin.md)中使用，不能直接在 `uvue` 页面中调用 `uni.createWorker`  
+- worker是一个uts API，无法在js环境使用。iOS平台、Android的蒸汽模式， Worker 仅支持在[uts插件](../plugin/uts-plugin.md)中使用，不能直接在 `uvue` 页面中调用 `uni.createWorker`
 
 常见场景：
 - 当你的界面掉帧时，应该检查是什么耗时任务导致不能及时渲染，是否可以剥离一些计算任务到子线程来做。
@@ -129,7 +129,7 @@ export class HelloWorkerTask extends WorkerTaskImpl {
    */
   override onMessage(message : any) {
     // 处理消息对象
-    const messageData = message as UTSJSONObject;
+    const messageData = message;
 
     // console.log('收到主线程数据:', messageData);
 
@@ -204,7 +204,7 @@ const worker = uni.createWorker('workers/HelloWorkerTask.uts');
 
 // 监听 Worker 消息
 worker.onMessage((message: any) => {
-  const messageData = message as UTSJSONObject;
+  const messageData = message;
 
   console.log('收到Worker子线程数据:', messageData);
 });
@@ -283,11 +283,10 @@ worker.terminate();
 ```
 
 ## Tips
-- `uni.createWorker` 仅支持在主线程中使用，在 Worker 子线程中使用会返回错误  
-- 各平台在 Worker 中使用全局变量或静态属性在内存管理中存在差异，Android/iOS平台可以共享内存，其它平台不能共享，为了避免这些差异带来的影响建议不要使用全局变量和静态属性  
-- Worker 子线程间暂不支持直接互相通讯，如要通讯可通过主线程中转发送消息来实现  
-- Android/iOS平台主线程与 Worker 线程传输的引用类型数据是直接共享使用（其它平台是默认为复制），需避免并发访问，暂未提供线程间安全访问机制，需通过业务逻辑控制避免并发访问这些共享的数据  
-- 鸿蒙平台主线程与 Worker 线程传输的数据默认为浅拷贝，如需传出共享对象，可在[uts插件](../plugin/uts-plugin.md)中混编开发定义[Sendable对象](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-sendable)，调用 `Worker.postMessage` 发送这些共享对象时设置 `harmonySendable` 参数为 true  
-- Worker 中仅支持调用界面无关的API（如 uni.request、uni.getLocation 等），这些 API 触发的回调运行在 Workder 线程中  
-- Web 平台不支持在 worker 中调用 uni 上的 API  
-
+- `uni.createWorker` 仅支持在主线程中使用，在 Worker 子线程中使用会返回错误
+- 各平台在 Worker 中使用全局变量或静态属性在内存管理中存在差异，Android/iOS平台可以共享内存，其它平台不能共享，为了避免这些差异带来的影响建议不要使用全局变量和静态属性
+- Worker 子线程间暂不支持直接互相通讯，如要通讯可通过主线程中转发送消息来实现
+- Android/iOS平台主线程与 Worker 线程传输的引用类型数据是直接共享使用（其它平台是默认为复制），需避免并发访问，暂未提供线程间安全访问机制，需通过业务逻辑控制避免并发访问这些共享的数据
+- 鸿蒙平台主线程与 Worker 线程传输的数据默认为浅拷贝，如需传出共享对象，可在[uts插件](../plugin/uts-plugin.md)中混编开发定义[Sendable对象](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-sendable)，调用 `Worker.postMessage` 发送这些共享对象时设置 `harmonySendable` 参数为 true
+- Worker 中仅支持调用界面无关的API（如 uni.request、uni.getLocation 等），这些 API 触发的回调运行在 Workder 线程中
+- Web 平台不支持在 worker 中调用 uni 上的 API

package/data/uni-app-x-docs/api/dialog-page.md

@@ -29,6 +29,10 @@ dialogPage和主page的区别：
 - 在web平台，dialogPage显示时，不影响URL的变化。
 - dialogPage默认没有窗体动画。如果是半屏内容，建议在页面内通过css或uts操作页面元素进行动画，灵活度更高。如果是全屏界面，可以使用窗体动画，但没有popin这种与上一个页面的联动动画。
 
+pages.json 配置注意事项：
+- dialogPage 没有导航栏，因此其 `style` 中的 `navigationBar` 相关配置无效。
+- dialogPage 的页面方向跟随所属的主页面（parentPage），因此其 `style.pageOrientation` 配置无效。
+
 dialogPage的绑定：
 - dialogPage需绑定在某个主页面上，即parentPage。parentPage页面关闭时，自动销毁相关dialogPage。
 - 在app的onLaunch调用openDialogPage，绑定到首页。

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

@@ -151,7 +151,7 @@ this.myView?.style?.setProperty('background-color', 'red');
 	<!-- #endif -->
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
 	const color = ref('red')
 	const myView = ref<UniElement | null>(null)
 

package/data/uni-app-x-docs/api/dom/cssstyledeclaration.md

@@ -53,9 +53,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，在class中设置background-color样式，App平台可通过 getPropertyValue 获取：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement" class="element">
@@ -63,12 +60,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取通过class设置的样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -103,9 +97,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，在class中设置的border-top-style样式覆盖了style中设置的border-top-style样式，App平台可通过 getPropertyValue 获取计算后生效的样式值：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement" class="element" style="border-top-style: solid;">
@@ -113,12 +104,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取通过class覆盖style的样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -166,9 +154,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，在style中设置简写样式border-color，App平台通过 getPropertyValue 获取拆解前样式 border-color 返回空字符串，获取拆解后样式 border-top-color 返回"#FFFF00"：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement" class="element" style="border-color: #FFFF00;">
@@ -176,12 +161,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取通过style/class设置的简写样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -224,7 +206,7 @@ App平台获取样式值与Web平台存在部分差异：
 - 通过 `setProperty` 设置的 CSS 简写样式，App平台通过 `getPropertyValue` 只能获取简写样式，获取拆解（Expansion）后的样式返回空字符串。
   如下示例，通过 setProperty 设置 border-style 简写样式为 "dotted"，App平台通过 getPropertyValue 获取 border-style 会返回设置的值"dotted"，获取 border-top-style 返回空字符串：
   ```vue
-  <!-- #endif -->
+  <template>
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement">
@@ -232,12 +214,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取通过setProperty设置的样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -283,9 +262,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，没有设置 flex-direction 样式，App平台在蒸汽模式（Vapor）下通过 getPropertyValue 获取 flex-direction 返回 "column"，非蒸汽模式下返回空字符串：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement">
@@ -293,12 +269,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取没有设置过的样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -331,9 +304,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，设置 flex 为 "1"，getPropertyValue 获取 flex 返回 "1 1 0%"：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement" style="flex: 1;">
@@ -341,12 +311,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取简写的样式</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -380,9 +347,6 @@ App平台获取样式值与Web平台存在部分差异：
   如下示例，设置 background-color 为 "blue"，App平台在蒸汽模式（Vapor）下通过getPropertyValue 获取 background-color 返回 "#0000FFFF"：
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement" style="background-color: blue;">
@@ -390,12 +354,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text>获取background-color设置为blue时返回的样式值</text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -430,9 +391,6 @@ App平台获取样式值与Web平台存在部分差异：
 - 通过 `setProperty` 设置布局相关的 CSS 样式，不能立即通过 `getPropertyValue` 同步获取设置的样式，此时返回的是设置前的样式，需要在 `nextTick` 异步回调中通过 `getPropertyValue` 才能获取到设置的值
   ```vue
   <template>
-  <!-- #ifdef APP -->
-  <scroll-view style="flex: 1;">
-  <!-- #endif -->
     <text class="inf">{{text}}</text>
     <button @click="onClick">获取样式值</button>
     <view ref="testElement">
@@ -440,12 +398,9 @@ App平台获取样式值与Web平台存在部分差异：
         <text></text>
       </view>
     </view>
-  <!-- #ifdef APP -->
-  </scroll-view>
-  <!-- #endif -->
   </template>
 
-  <script setup lang="uts">
+  <script setup lang="ts">
   const text = ref('')
   const testElement = ref<UniElement | null>(null)
 
@@ -505,7 +460,7 @@ App平台获取样式值与Web平台存在部分差异：
 		<text>123</text>
 	</view>
 </template>
-<script setup lang="uts">
+<script setup lang="ts">
 	const pop = ref<UniElement | null>(null)
 
 	const showPop = () => {

package/data/uni-app-x-docs/api/dom/unielement.md

@@ -495,7 +495,8 @@ if (view != null && view instanceof WKWebView) {
 <!-- CUSTOMTYPEJSON.UniElement.methods.animate.description -->
 
 ::: warning 注意
-- 鸿蒙平台暂不支持返回动画实例。
+- 鸿蒙平台VDOM模式不支持返回动画实例监听事件或操作动画状态，仅支持调用后按传入参数执行动画
+- 鸿蒙平台蒸汽模式拍平元素（设置flatten为true）暂不支持动画，调用后无效
 :::
 
 <!-- CUSTOMTYPEJSON.UniElement.methods.animate.compatibility -->

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

@@ -1,48 +1,5 @@
-## UniResizeObserver
+---
+layout: SimpleLayout
+---
 
-<!-- CUSTOMTYPEJSON.UniResizeObserver.description -->
-
-<!-- CUSTOMTYPEJSON.UniResizeObserver.compatibility -->
-
-<!-- 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 -->
+文档已迁移至 [全局/UniResizeObserver](../uniresizeobserver.md)

package/data/uni-app-x-docs/api/event-bus.md

@@ -60,7 +60,7 @@
 :::warning
 参数 `args` 为对象字面量时，4.25 前需要通过 `as` 明确类型，例如：
 ```js
-uni.$emit('fn', {"a": 1} as UTSJSONObject)
+uni.$emit('fn', {"a": 1})
 ```
 4.25+ 编译器会自动将对象字面量推断为 `UTSJSONObject` 类型，不再需要通过 `as` 明确类型。如果需要传递其他自定义类型的对象字面量，仍需要通过 `as` 明确类型。
 :::

package/data/uni-app-x-docs/api/get-recorder-manager.md

@@ -8,10 +8,6 @@
 
 web平台可通过插件拉齐，[详见](https://ext.dcloud.net.cn/search?q=getRecorderManager&orderBy=Relevance&cat1=4&cat2=41&uni-app-platforms=&uni-app-x-platforms=)
 
-<!-- UTSAPIJSON.getRecorderManager.param -->
-
-<!-- UTSAPIJSON.getRecorderManager.returnValue -->
-
 ::: tip 编码格式与采样率、码率的关系
 
 `Android、iOS、微信小程序`
@@ -31,13 +27,17 @@ web平台可通过插件拉齐，[详见](https://ext.dcloud.net.cn/search?q=get
 `HarmonyOS`
 
 - aac 编码格式支持码率范围[32000 - 500000]
-- mp 编码格式支持码率范围[8000, 16000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000]
+- mp3 编码格式支持码率范围[8000, 16000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000]
   - 采样率使用16K以下时，对应码率范围为[8000 - 64000]
   - 采样率使用16K~32K时对应的码率范围为[8000 - 160000]
   - 采样率使用32K以上时对应的码率范围为[32000 - 320000]
 - wav 编码格式时，补丁码率 8000，采样率 64000，通道数 1
 :::
 
+<!-- UTSAPIJSON.getRecorderManager.param -->
+
+<!-- UTSAPIJSON.getRecorderManager.returnValue -->
+
 <!-- UTSAPIJSON.getRecorderManager.example -->
 
 <!-- UTSAPIJSON.getRecorderManager.tutorial -->

package/data/uni-app-x-docs/api/install-wgt.md

@@ -2,11 +2,13 @@
 
 <!-- UTSAPIJSON.installWgt.description -->
 
-wgt，是 uni-app x 的前端资源包。包括uvue、脚本、静态资源。不包括原生插件。
+wgt，是 uni-app x 蒸汽模式的前端资源包。包括uvue、脚本、静态资源。不包括原生插件。
 
 通过在线下载和安装wgt，可以实现相同appid应用的资源替换。
 
-uni-app 的 wgt 是zip格式。uni-app x 的 wgt 是压缩率更高的zstd格式。可以大幅降低热更新带来的cdn成本。
+wgt热更新后，运行性能不变。也就是动态化方案的渲染性能超过了原生。[详见评测](../app-vapor.md)
+
+uni-app 的 wgt 是zip格式。uni-app x 的 wgt 是压缩率和解压速度更优秀的zstd格式。可以大幅降低热更新带来的cdn成本。
 
 在HBuilder 5.31+ 中对 uni-app x 项目点发行，可看到生成wgt的菜单。由于条件编译的存在，uni-app x 不同平台的 wgt 包是不同的。
 
@@ -27,11 +29,7 @@ uni-app 的 wgt 是zip格式。uni-app x 的 wgt 是压缩率更高的zstd格式
 
 <!-- UTSAPIJSON.installWgt.example -->
 
-<!-- UTSAPIJSON.installWgt.tutorial -->
-
-<!-- UTSAPIJSON.installWgt.example -->
-
-### 热更新与应用商店
+## 热更新与应用商店
 
 应用商店可以接受热更新用于修复紧急bug、运营活动调整、部分功能升级。几乎所有大厂App也都有动态化方案。
 
@@ -41,18 +39,18 @@ uni-app 的 wgt 是zip格式。uni-app x 的 wgt 是压缩率更高的zstd格式
 
 额外建议：当开发者发布了热更新后，也应该及时提交应用商店，避免应用刚下载就立即弹升级提示。可以使用[uni多商店上传](https://doc.dcloud.net.cn/uni-app-x/uni-publish/intro.html)，来批量提交应用商店。
 
-### 使用流程
+## 使用流程
 
 通过wgt包在线升级应用操作流程：
 - 更新版本号： manifest中修改应用版本名称（versionName），要求大于线上已发布的版本名称
-- 生成wgt升级包： 在 HBuilder 中点击菜单 “发行” -> “App-制作wgt包” 导出wgt包  
+- 生成wgt升级包： 在 HBuilder 中点击菜单 “发行” -> “App-制作wgt包” 导出wgt包
 - 检测版本更新： 客户端通过 [uni.getAppBaseInfo.appWgtVersion](./get-app-base-info.md) 获取应用资源版本号，与服务器最新版本对比
 - 下载wgt包： 检测到新版本后，通过 [uni.downloadFile](./download-file.md) 从服务器下载wgt包
 - 安装与重启： 调用 `uni.installWgt` 安装wgt包，在安装成功的回调中调用 [getApp().restart](./get-app.md#restart) 重启应用使更新生效
 
 **推荐方案：** 建议直接使用 [升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html) 进行 wgt 发布与更新，可大幅降低开发和测试成本。
 
-### wgt资源与原生底座的匹配
+## wgt资源与原生底座的匹配
 
 wgt热更新，只能更新前端资源，不能热更新原生底座的原生模块，不能热更新manifest相关内容。需注意前端代码与原生底座的匹配性。
 
@@ -62,12 +60,13 @@ wgt热更新，只能更新前端资源，不能热更新原生底座的原生
 
 开发者可以提前预置一些暂时未使用的模块。也可以在遇到需要更新原生模块的时候，请求用户升级完整包（可以在热更新的时候，也可以在报缺少模块错误的时候）。
 
-### tips  
+## tips
 
 - **真机运行环境：** 调用 `uni.installWgt` 成功后会直接替换当前运行资源。为了避免出现资源不同步，必须在安装成功的回调中调用 `getApp().restart()` 重启应用或手动关闭重新打开应用。
 - **正式包环境：** 调用 `uni.installWgt` 成功后不会直接替换当前应用资源，新资源仅在重启应用或主动调用 `getApp().restart()` 后生效，不会影响当前正在运行的版本。
 - **测试建议：** wgt包升级测试务必在打包后的正式包环境中进行，不建议仅凭真机运行环境测试。
 
+<!-- UTSAPIJSON.installWgt.tutorial -->
 
 <!-- UTSAPIJSON.general_type.name -->
 

package/data/uni-app-x-docs/api/screen-brightness.md

@@ -51,3 +51,9 @@
 <!-- UTSAPIJSON.general_type.name -->
 
 <!-- UTSAPIJSON.general_type.param -->
+
+## tips
+
+设置和获取亮度，是对页面生效。不是全局生效。
+
+在Android平台，本质是对activity生效。在老uni-app的Android平台，整个应用只有一个activity，而uni-app x中每个页面是一个activity的。

package/data/uni-app-x-docs/api/theme-change.md

@@ -245,7 +245,7 @@ onLaunch(() => {
 	</view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
 	import { state } from '@/store/index.uts'
 </script>