tmui-cli 2.0.4 → 2.0.5

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

@@ -73,8 +73,6 @@ vue的script分组合式和选项式。选项式属于比较老的技术，在
 
 可以看出整体和html还是很接近的。但响应式变量和绑定机制，可以免去写大量的dom操作代码，让开发更高效轻松。
 
-基于选项式的示例，下面章节会提供。
-
 ## template
 
 template中文名为`模板`，它类似html的标签。但有2个区别：
@@ -124,23 +122,58 @@ template中文名为`模板`，它类似html的标签。但有2个区别：
 ## script
 
 script中编写逻辑代码。
+uvue文件中只能有一个script标签。
+
+script标签有2个属性，lang和setup。
+
+```vue
+<script setup lang="ts">
+```
+
+### lang
+
+#### VDOM模式
+VDOM模式lang的值域只有uts。Android平台按uts2kt执行，此时要求强类型。其他平台按uts2js执行，不要求强类型。
+
+#### 蒸汽模式
+蒸汽模式，lang最终运行在js环境中，不再要求强类型。
+
+##### HBuilderX 5.31以前统一uts2js
+不能手动指定lang，script均按uts2js执行，强行设置lang为ts/js反而会触发bug。
 
-uvue中只能有一个script标签。
+页面外链的脚本文件，不管是`*.js`、`*.ts`、`*.uts`，统一执行uts2js。并且推荐使用uts文件，更稳定。
 
-script标签的属性如下：
-- lang
-目前不推荐设置此项。
+按uts2js执行时，uts里也可以使用ts/js的写法。此时写类型不严谨的js时，可能触发类型校验告警，但忽略即可。
 
-在VDOM模式，lang只能使用uts，Android平台按uts2kt执行。其他平台按uts2js执行。
+##### 5.31+，js/ts/uts变成3种独立策略@utstsjs
+	
+页面script的lang可以设置uts、ts和js。
 
-在蒸汽模式，在HBuilderX 5.27以前，仅支持uts，按uts2js执行，强行设置ts/js会触发bug。从5.27+，lang可以设置ts和js。
+页面外链的脚本文件，也可以独立使用 `*.js`、`*.ts`、`*.uts`。不再统一执行uts2js。
 
-设置js、ts、uts，会影响编译速度，编译速度逐渐变慢。ts需要执行ts2js编译，uts还需要再追加uts2js编译。
+如果页面script未设置，则根据全局配置 manifest.json 中 蒸汽模式下 script lang 的默认值来执行。如果未改动manifest默认值，则默认为`ts`。
 
-uts2js，为了拉齐uts编译的强类型整体表现，支持UTSJSONObject、把部分js内置API返回值从undefined改为null、type没有擦除而是编译成了class。不使用uts时，将无法再使用UTSJSONObject，type会被擦除，所有API表现均与标准js一致。
+注意：默认值是 `ts`。不是uni-app默认的`js`，也不是uni-app x VDOM模式默认的`uts`。
+默认值之所以调整，一是为了方便AI，二是为了提升编译速度。
 
-- setup
-setup属性声明代表script里的代码为组合式写法，如果没有setup属性则为选项式写法。
+此时uts、ts、js三者将有不同的编译逻辑，见下。
+
+蒸汽模式下，使用uts、ts，实际也需要经过uts2js、ts2js的编译流程。uts、ts和js的区别：
+- js：没有额外的编译流程。编译速度快。
+- ts：需执行ts2js的编译器，类型仅对开发阶段生效，实际运行时会擦除类型。编译速度中。
+- uts：需执行uts2js编译器。编译速度慢。为了拉齐uts编译原生强类型的跨端表现，运行时与标准js有略微差异：
+	+ 支持UTSJSONObject
+	+ type没有擦除而是编译成了class
+	+ 把部分js内置API返回值从undefined改为null
+
+	不使用uts时，将无法再使用UTSJSONObject，UTSJSONObject变成了普通的object，type会被擦除，运行时内置API被改成`null`的会还原为`undefined`。
+	
+	如果你之前使用过UTSJSONObject的专有方法，比如getString、getNumber、getArray等方法，在5.31+运行，由于默认按ts编译，会造成控制台报警找不到相关类型和方法，此时有如下处理方案：
+	1. 把相关页面的script的lang，显式指定为uts。
+	2. 把UTSJSONObject的写法，改成普通object写法。
+
+### setup
+setup属性声明代表script里的代码为组合式写法，如果没有setup属性则为选项式写法。蒸汽模式只支持setup。
 
 **注意：** 所有 `vue` 公开的 `API` 都是不需要 `import` 的, `uni-app x` 会自动引入。
 
@@ -151,9 +184,11 @@ import { ref } from 'vue';
 
 ### 组合式和选项式的区别
 
-vue最初只有选项式API，从vue3起，新增了组合式API。uni-app x仅支持vue3。
+vue自身最初只有选项式API，从vue3起，新增了组合式API。再推出蒸汽模式后仅支持组合式API。
 
-所谓选项式，就是把script的内容在export default {} 中约定不同的对象，在其中通过多个选项的对象来定义data、method和生命周期。
+uni-app x 仅支持vue3，uni-app x 蒸汽模式也仅支持组合式API。
+
+所谓选项式，就是把script的内容在 `export default {}` 中约定不同的对象，在其中通过多个选项的对象来定义data、method和生命周期。
 
 框定好这些后，开发者就在这个框框里分别写自己的业务逻辑。
 
@@ -161,7 +196,7 @@ vue最初只有选项式API，从vue3起，新增了组合式API。uni-app x仅
 
 vue3新增的组合式API，是纯编程的，解决了选项式不够灵活的问题。同时维持了易学的特点。让vue变的即容易、又灵活。
 
-在vue3中，组合式和选项式是可以混合使用的。
+在 uni-app x VDOM模式中，组合式和选项式是可以混合使用的。
 1. 可以A页面使用组合式，B页面使用选项式，互相跳转。
 2. 可以页面使用组合式，其中的某些组件使用选项式。反之亦然。
 3. 一个页面或组件内，可以混合使用组合式和选项式
@@ -170,17 +205,17 @@ vue3新增的组合式API，是纯编程的，解决了选项式不够灵活的
 
 但注意不支持一个页面/组件有2个script，分别写选项式和组合式。
 
+在 uni-app x 蒸汽模式中，仅支持组合式，不支持选项式混合使用。
+
 开发者可以根据自己的喜好选择2种写法，但还有几个差别需要注意：
 1. vue推出了蒸汽模式，该模式抛弃了VNode，让页面加载速度更快。但该模式仅支持组合式。为了更高的性能，推荐使用组合式。
 1. 组合式API的组件，可以监听引用其页面的页面级生命周期。而选项式是不能的。有相关需求的组件，需使用组合式API，或在选项式中使用setup函数。[详见](./component.md#component-page-lifecycle)
 2. 选项式的type类型定义在`export default {}`外，这些都是应用级全局的，略微影响性能。[见下](#export-default-out)
-3. uts插件的兼容模式组件，其中的根index.vue，只支持选项式。兼容模式组件已经不再推荐使用，推荐使用标准模式组件。
-
+3. uts插件的兼容模式组件，其中的根index.vue，只支持选项式。兼容模式组件已经不再推荐使用，蒸汽模式也不支持，推荐使用uts标准模式组件。
 
 一般推荐的建议是：
-1. 如果有历史的选项式代码需要复用，这些选项式代码仍然可以使用。
-2. 如果新写页面和组件，建议直接使用组合式。
-3. 虽然选项式可以用，但强烈推荐通过[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)来转换选项式代码为组合式，可以使用如下提示词：[见下](#ai)
+1. 如果新写页面和组件，建议直接使用组合式。
+2. 历史选项式页面和组件，强烈推荐通过[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)来转换选项式代码为组合式，其已经内置了转换相关的skill。如果使用其他AI，可以参考如下的提示词 [见下](#ai)
 
 ### 组合式API
 组合式 API，也称 Composition API，或 setup函数。
@@ -301,7 +336,7 @@ vue3新增的组合式API，是纯编程的，解决了选项式不够灵活的
 
 ### JSX/TSX
 
-uni-app x 目前不支持使用 JSX/TSX 编写页面和组件，请使用 Vue 的 `template` 模板语法。
+uni-app x 除web平台外，其他平台不支持使用 JSX/TSX 编写页面和组件，请使用 Vue 的 `template` 模板语法。
 
 在 App 端蒸汽模式下，视图层代码，即 Vue 文件中 `template` 和 `style` 内的代码，会在编译期进行静态分析，并直接编译为高度优化的机器码或字节码，它的运行速度远快于arkts、kotlin及k/n。
 
@@ -309,7 +344,7 @@ JSX/TSX 是编写在 JavaScript/TypeScript 中的表达式语法，目前不支
 
 ## style（CSS功能） @css
 
-style的写法与web的css基本相同。但在App端，由于并非webview渲染，支持的css有限。[详见](../css/README.md)
+style的写法与web的css基本相同。但在App端，由于并非webview渲染，支持的css是子集。[详见](../css/README.md)
 
 本章节重点讲解uvue下样式的使用注意事项。
 
@@ -336,8 +371,8 @@ style通过lang属性，可以支持less、scss、stylus等css预处理语言。
 
 ### Class 与 Style 绑定 @class-style
 
-- `uni-app x` 支持绑定  `UTSJSONObject` 和 `Map` 类型数据。
-- 在App-Android平台上 `Map` 的性能高于 `UTSJSONObject` 数据类型。从 `uni-app x 4.01` 起，Web平台也支持了 `Map` 类型绑定。
+- `uni-app x` 在VDOM模式下支持绑定  `UTSJSONObject` 和 `Map` 类型数据。蒸汽模式不支持 `Map` 类型数据。
+- VDOM模式下，在App-Android平台上 `Map` 的性能高于 `UTSJSONObject` 数据类型。从 `uni-app x 4.01` 起，Web平台在uts2js时也支持了 `Map` 类型绑定。
 
 如下示例中，给 view 组件的 style 和 class 分别绑定了两个响应式变量，就可以通过在逻辑代码里修改变量而实现动态修改样式。
 ```vue
@@ -456,6 +491,8 @@ useCssModule('classes')
 
 单文件组件的 `<style>` 标签支持使用 `v-bind` CSS 函数将 CSS 的值链接到动态的组件状态：
 
+选项式写法：
+
 ```vue
 <template>
   <text class="text">hello</text>
@@ -478,7 +515,7 @@ export default {
 </style>
 ```
 
-这个语法同样也适用于 `<script setup>`，且支持 UTS 表达式 (需要用引号包裹起来)：
+组合式写法： `<script setup>`，且支持 UTS 表达式 (需要用引号包裹起来)：
 
 ```vue
 <script setup>
@@ -501,8 +538,8 @@ const theme = {
 
 ## 利用AI将选项式转换为组合式@ai
 
-推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，可以直接转换选项式代码为组合式代码，并自动监控控制台报错然后自动修复。
-官方的很多页面如hello uni-app x，都是这样转的。
+推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，可以直接转换选项式代码为组合式代码，并自动监控控制台报错然后自动修复。\
+官方的很多页面如 hello uni-app x，都是这样转的。
 
 如果您使用其他AI，可以使用下面的提示词：
 
@@ -523,8 +560,6 @@ const theme = {
 11. 在页面生命周期中，`onPullDownRefresh` 应作为页面生命周期函数处理，而不是写成普通方法。
 12. 检查控制台的编译报错，如果有报错自行修复，并再次检查编译报错，直到无报错编译通过。
 
-
-
 ## 利用 AI 适配蒸汽模式@ai-vapor
 
 下面提示词用于把已有 uni-app x 页面适配到蒸汽模式。

package/data/uni-app-x-docs/vue/built-in.md

@@ -33,7 +33,7 @@
 更新元素的内容，并且不会被解析。
 
 ::: warning 注意
-在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式, 并且要遵循标签嵌套规则，例如， `swiper` 标签内只允许嵌套 `swiper-item` 标签。\
+在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
 同时，受限于 `rich-text` 组件不支持 `class` 样式，`v-html` 指令中同样不支持 `class` 样式。\
 绑定 `v-html` 的标签内的内容会被忽略，`v-html` 指令的内容会编译为 `rich-text` 组件渲染为该标签的子节点。
 :::

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

@@ -348,7 +348,7 @@ Uni`组件名(驼峰)`Element
 
 **bug&tips**
 
-- 目前uts组件，即封装原生ui给uni-app或uni-app x的页面中使用，类型与内置组件的 Uni`组件名(驼峰)`Element 方式相同。目前没有代码提示。
+- 目前uts插件 - uni-app兼容模式组件，即封装原生ui给uni-app或uni-app x VDOM模式的页面中使用，类型与内置组件的 Uni`组件名(驼峰)`Element 方式相同。目前没有代码提示。
 
 ### 组件监听应用、页面生命周期 @component-page-lifecycle
 

package/data/uni-app-x-docs/vue/composition-api.md

@@ -108,7 +108,7 @@ watch(
   若要避免深层响应式转换，只想保留对这个对象顶层次访问的响应性，请使用 [shallowReactive()](#shallowreactive) 作替代。
 
 ::: warning 注意
-- `reactive` 在 app-android 平台目前不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
+- `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
 :::
 
 - 示例 [详情](<!-- VUEJSON.E_reactivity.core_reactive_reactive.gitUrl -->)
@@ -189,7 +189,7 @@ watch(
 <!-- VUEJSON.reactivity_utilities.example -->
 
 ::: warning 注意
-- `toRefs()` 仅支持 `Array` 和 `UTSJSONObject`, 不支持自定义类型。
+- App-Android VDOM 模式 `toRefs()` 仅支持 `Array` 和 `UTSJSONObject`, 不支持自定义类型。
 :::
 
 ### 示例代码 @example
@@ -512,21 +512,6 @@ onReady(() => {
 
 ## \<script setup> @script_setup
 
-### 基本语法 @basic-syntax
-
-- 仅支持 `export default {}` 方式定义组件。
-- `data` 仅支持函数返回对象字面量方式。
-  ```ts
-  <script lang="uts">
-    export default {
-      data() {
-        return {
-          // 必须写这里
-        }
-      }
-    }
-  </script>
-  ```
 <!-- VUEJSON.script.description -->
 
 <!-- VUEJSON.script.compatibility -->
@@ -669,8 +654,6 @@ defineExpose({
 
 在底层，这个宏声明了一个 model prop 和一个相应的值更新事件。如果第一个参数是一个字符串字面量，它将被用作 prop 名称；否则，prop 名称将默认为 `"modelValue"`。在这两种情况下，你都可以再传递一个额外的对象，它可以包含 prop 的选项和 model ref 的值转换选项。
 
-**注意：** android 端 `defineModel` 暂不支持创建 `Array` 类型 `prop`。
-
 #### 示例
 
 [详情](<!-- VUEJSON.E_directive.v-model_Foo-composition.gitUrl -->)
@@ -704,6 +687,10 @@ defineExpose({
 
 在 `<script setup>` 使用 `slots` 和 `attrs` 的情况应该是相对来说较为罕见的，因为可以在模板中直接通过 `$slots` 和 `$attrs` 来访问它们。在你的确需要使用它们的罕见场景中，可以分别用 `useSlots` 和 `useAttrs` 两个辅助函数：
 
+::: warning 注意
+- `useSlots` 在 App 蒸汽模式下仅能用于判断插槽是否存在，不能调用插槽函数获取 dom 节点数组。
+:::
+
 #### useSlots() 示例 @useslots-example
 
 [详情](<!-- VUEJSON.E_directive.v-slot_v-slot-composition.gitUrl -->)

package/data/uni-app-x-docs/vue/global-api.md

@@ -106,4 +106,4 @@ uni-app x 新增了 [onLastPageBackPress](../collocation/App.md#applifecycle)
 
 ### nextTick 使用注意事项 @nexttick
 
-目前 nextTick 可以保证当前数据已经同步到 DOM，但是由于排版和渲染是异步的的，所以 nextTick 不能保证 DOM 排版以及渲染完毕。如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。
+目前 nextTick 可以保证当前数据已经同步到 DOM，但是由于排版和渲染是异步的的，所以 nextTick 不能完全保证 DOM 排版以及渲染完毕（蒸汽模式在 5.21 版本之后可以保障渲染完毕）。如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。

package/data/uniappx/_sidebar.md

@@ -67,6 +67,8 @@
   * [概述](mp/README.md)
   * [AI 开发模式接入指南](mp/mp-weixin-ai-develop.md)
   * [独立分包](mp/independent-subpackage.md)
+  * [组件和 WXS](mp/native-component-and-wxs.md)
+  * [分包异步化](mp/miniprogram-subcontract-asynchrony.md)
   * [适配 glass-easel](mp/mp-weixin-glass-easel.md)
 * 运行和调试
   * [Android/iOS运行](tutorial/run-app.md)
@@ -90,7 +92,9 @@
   * [Android性能评测基准报告](benchmark/vapor-benchmark-android.md)
   * [iOS性能评测基准报告](benchmark/vapor-benchmark-ios.md)
   * [鸿蒙性能评测基准报告](benchmark/vapor-benchmark-harmony.md)
-* [uni-app 升级 uni-app x](./uniapptox.md)
+* 选型参考
+	* [一文讲透原生渲染和自渲染](./select/native-render-and-self-render.md)
+* [uni-app 升级 uni-app x](uniapptox.md)
 * 安全专题
   * [综述](tutorial/safe.md)
   * 客户端安全
@@ -127,6 +131,7 @@
       * [uni-push2.0、uni-id、uni统计的组合](https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/mate.html)
     * [安卓、鸿蒙厂商推送配置](uni-push/vendor_config.md)
     * [谷歌FCM配置](uni-push/google-fcm.md)
+  * [uni统计](https://uniapp.dcloud.net.cn/uni-stat-uniappx)
 * cursor/vscode插件
   * [语言服务插件](tutorial/ls-plugin.md)
   * [AI Rules/MCP](tutorial/rules_mcp.md)

package/data/uniappx/api/create-editor-context-async.md

@@ -10,9 +10,9 @@
 本API是 [editor组件](../component/editor.md) 的上下文对象。
 
 ### createEditorContextAsync 兼容性  
-| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
-| :- | :- | :- | :- | :- | :- | :- |
-| 5.08 | 5.08 | 5.08 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.08 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.08 |
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 5.08 | 5.08 | 5.08 | 5.08 | 5.08 |
 
 ### 参数 
 

package/data/uniappx/api/get-app-base-info.md

@@ -28,30 +28,28 @@
 | **GetAppBaseInfoResult** |
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| appId | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用标识，即DCloud AppID<br/> |
-| appName | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用名称<br/> |
-| appVersion | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | `manifest.json` 中的应用版本名称<br/> |
-| appVersionCode | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | `manifest.json` 中的应用版本号<br/> |
-| appLanguage | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的语言en、zh-Hans、zh-Hant、fr、es<br/> |
+| appId | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的标识，即DCloud AppID<br/> |
+| appName | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的名称<br/> |
+| appVersion | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 应用的版本名称，app平台为原生应用安装包的版本名称<br/> |
+| appVersionCode | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的版本号，app平台为原生应用安装包的版本名称<br/> |
+| appLanguage | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的语言，如en、zh-Hans、zh-Hant、fr、es<br/> |
 | appTheme | string | 否 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 应用的主题<br/> |
 @@| 合法值 |
 @@| :- |
 @@| light |
 @@| dark |
 @@| auto |
-| channel | string | 否 | Web x / 微信小程序 x / Android 4.28 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 应用的分发渠道<br/> |
-| language | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用设置的语言<br/> |
-| appWgtVersion | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 应用资源（wgt）的版本名称<br/> |
+| appWgtVersion | string | 否 | Web x / 微信小程序 x / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 应用资源（wgt）的版本名称，app平台为当前应用资源`manifest.json`中的版本名称<br/> |
 | hostLanguage | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 小程序宿主语言<br/> |
 | hostVersion | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | App、小程序宿主版本。<br/> |
 | hostName | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 小程序宿主名称<br/> |
 | hostPackageName | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 小程序宿主包名<br/> |
 | hostSDKVersion | string | 否 | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | uni小程序SDK版本、小程序客户端基础库版本<br/> |
 | hostTheme | string | 否 | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 系统当前主题，取值为light或dark。微信小程序全局配置"darkmode":true时才能获取，否则为 null （不支持小游戏）<br/> |
-| isUniAppX | boolean | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 是否uni-app x<br/> |
-| uniCompilerVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uni 编译器版本<br/> |
+| isUniAppX | boolean | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 是否 uni-app x 项目<br/> |
+| uniCompilerVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uni 编译器版本名称<br/> |
 | uniCompilerVersionCode | number | 否 | Web 4.18 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uni 编译器版本号<br/> |
-| uniRuntimeVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | uni 运行时版本<br/> |
+| uniRuntimeVersion | string | 否 | Web 4.18 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.0 | uni 运行时版本名称<br/> |
 | uniRuntimeVersionCode | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni 运行时版本号<br/> |
 | uniPlatform | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni-app 运行平台<br/> |
 @@| 合法值 |
@@ -70,7 +68,8 @@
 @@| quickapp-webview |
 @@| quickapp-webview-union |
 @@| quickapp-webview-huawei |
-| packageName | string | 否 | Web x / 微信小程序 5.13 / Android 3.97 / iOS x / HarmonyOS 4.61（部分支持，见上） | 微信小程序: 小程序appId<br/>Android: 包名<br/>iOS: Bundle ID<br/>鸿蒙: bundleName<br/> |
+| channel | string | 否 | Web x / 微信小程序 x / Android 4.28 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 应用的分发渠道<br/> |
+| packageName | string | 否 | Web x / 微信小程序 5.13 / Android 3.97 / iOS 5.11 / HarmonyOS 4.61（部分支持，见上） | 微信小程序: 小程序appId<br/>Android: 包名<br/>iOS: Bundle ID<br/>鸿蒙: bundleName<br/> |
 | bundleName | string | 否 | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 鸿蒙的包名<br/> |
 | bundleId | string | 否 | Web x / 微信小程序 x / Android x / iOS 4.11 / HarmonyOS x（部分支持，见上） | iOS的Bundle ID<br/> |
 | signature | string | 否 | Web x / 微信小程序 x / Android 3.97 / iOS 4.11 / HarmonyOS x（部分支持，见上） | Android: 应用签名证书的SHA1值（全部为小写，中间不包含“:”）。<br/>iOS: 应用签名证书中绑定的Bundle ID（AppleID）的md5值（全部为小写）。<br/> |
@@ -88,9 +87,10 @@
 @@| :- |
 @@| dark |
 @@| light |
-| ~~version~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 引擎版本号。已废弃，仅为了向下兼容保留  **已废弃，仅为了向下兼容保留** |
-| ~~uniCompileVersion~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | uni 编译器版本  **已废弃，仅为了向下兼容保留** |
+| ~~uniCompileVersion~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | uni 编译器版本名称  **已废弃，仅为了向下兼容保留** |
 | ~~uniCompileVersionCode~~ | number | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | uni 编译器版本号  **已废弃，仅为了向下兼容保留** |
+| ~~language~~ | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 应用的语言  **已废弃，仅为了向下兼容保留** |
+| ~~version~~ | string | 否 | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 引擎版本号  **已废弃，仅为了向下兼容保留** |
 
 #### appTheme @apptheme
 获取应用的主题配置信息，仅app平台支持。

package/data/uniappx/api/get-file-system-manager.md

@@ -1447,7 +1447,7 @@ readCompressedFile
 ##### readCompressedFile 兼容性  
 | Web | 微信小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- |
-| x | 4.41 | 4.13 | 4.61 | 4.61 |
+| x | 4.41 | 4.13 | 4.61 | x |
 
 ##### 参数 
 
@@ -1510,7 +1510,7 @@ readCompressedFileSync
 ##### readCompressedFileSync 兼容性  
 | Web | 微信小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- |
-| x | 4.41 | 4.13 | 4.61 | 4.61 |
+| x | 4.41 | 4.13 | 4.61 | x |
 
 ##### 参数 
 

package/data/uniappx/api/get-location.md

@@ -133,23 +133,23 @@ web平台也分系统定位的SDK定位。系统定位只有wgs84坐标。三方
 小程序平台的定位，是小程序引擎自身集成的定位SDK。比如微信小程序使用的是腾讯定位、支付宝小程序使用的是高德定位。由小程序平台免费给开发者提供。
 
 #### Android平台
-参考 [Android平台配置“uni-location（定位）”](../collocation/manifest-android.md#modulesLocation)  
+参考 [Android平台配置“uni-location（定位）”](../collocation/manifest-android.md#moduleslocation)  
 
-使用腾讯定位时，需配置对应的Key，参考[Android平台配置腾讯定位](../collocation/manifest-android.md#locationTencent)
+使用腾讯定位时，需配置对应的Key，参考[Android平台配置腾讯定位](../collocation/manifest-android.md#locationtencent)
 
 #### iOS平台
-参考 [iOS平台配置“uni-location（定位）”](../collocation/manifest-ios.md#modulesLocation)。
+参考 [iOS平台配置“uni-location（定位）”](../collocation/manifest-ios.md#moduleslocation)。
 
 使用腾讯定位时，需配置对应的Key，参考[iOS平台配置腾讯定位](../collocation/manifest-ios.md#locationtencent)。
 
 使用高精度定位，需要配置 `NSLocationTemporaryUsageDescriptionDictionary`，参考[](../collocation/manifest-ios.md#hightprecision)。
 
-如果应用需要后台定位能力，需在 `manifest.json` 中的 [后台运行能力](../collocation/manifest-ios.md#backgroundModes) 配置 `location`。  
+如果应用需要后台定位能力，需在 `manifest.json` 中的 [后台运行能力](../collocation/manifest-ios.md#backgroundmodes) 配置 `location`。  
 
 #### 鸿蒙平台
-参考 [鸿蒙平台配置“uni-location（定位）”](../collocation/manifest-harmony#modulesLocation)。
+参考 [鸿蒙平台配置“uni-location（定位）”](../collocation/manifest-harmony#moduleslocation)。
 
-鸿蒙平台暂时仅支持系统定位，参考 [鸿蒙平台配置“系统定位”](../collocation/manifest-harmony.md#locationSystem)。
+鸿蒙平台暂时仅支持系统定位，参考 [鸿蒙平台配置“系统定位”](../collocation/manifest-harmony.md#locationsystem)。
 
 ### 权限@permission
 

package/data/uniappx/api/modal.md

@@ -229,4 +229,5 @@ uni.showModal({
 	success: function (showRet : ShowModalSuccess) {
 	}
 })
-```
+```
+* `uni.showModal` 是跨平台模态弹框 API。如需在 App iOS 26+ 的蒸汽模式中使用液态玻璃效果，可使用 [uni-glass-modal](https://ext.dcloud.net.cn/plugin?name=uni-glass-modal) 插件（HBuilderX 5.25+）；iOS 26 以下将降级为系统毛玻璃效果。

package/data/uniappx/api/on-tab-bar-mid-button-tap.md

@@ -11,12 +11,12 @@
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| options | () => void | 是 | 微信小程序 x / HarmonyOS x（部分支持，见上） |
+| options | () => void | 是 | 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
 
 ### onTabBarMidButtonTap 兼容性  
-| Web | 微信小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
-| :- | :- | :- | :- | :- | :- |
-| 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | √ | √ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.page.onTabBarMidButtonTap)

package/data/uniappx/api/request.md

@@ -507,6 +507,7 @@ complete: () => {
 
 如不释放，在调用Task对象的方法将导致控制台报错：
 `error: instance object does not exist: id:15`
+* Android release 包默认禁止 http 明文请求（Android 9+ targetSdkVersion≥28）。会导致联网失败。优先推荐使用 https 来解决。如果确定坚持不安全的http，那么方案如下：在项目根目录新建 AndroidManifest.xml，给 application 节点加 android:usesCleartextTraffic="true"，配置方式见 https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html
 
 ## 通用类型
 

package/data/uniappx/api/toast.md

@@ -25,8 +25,8 @@
 @@| :- |  :-: | :- |
 @@| "success" | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示成功图标 |
 @@| error | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示错误图标 |
-@@| fail | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 5.25（部分支持，见上） | 显示错误图标，此时title文本无长度显示，支付宝、抖音小程序生效 |
-@@| exception | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS 5.25（部分支持，见上） | 显示异常图标，此时title文本无长度显示，支付宝小程序生效 |
+@@| fail | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示错误图标，此时title文本无长度显示，支付宝、抖音小程序生效 |
+@@| exception | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示异常图标，此时title文本无长度显示，支付宝小程序生效 |
 @@| loading | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示加载图标 |
 @@| none | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 不显示图标 |
 | image | string.ImageURIString | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 自定义图标的本地路径（app-android/app-ios端暂不支持gif） |
@@ -165,8 +165,8 @@
     - 只有系统 toast ，和 App window 绑定
   	- 不支持 icon 图标，仅支持文字
   - 5.25 及以上：
-  	* position 设为 bottom 时，为系统 toast。position 不为 bottom 时仍与页面绑定
-  	* 当 position 设为除 bottom 之外的值时，支持 icon、mask、image 参数
+  	* position 设为 top、center、bottom 时，为系统 toast，和页面绑定
+  	* 当没有传递 position 参数时，支持 icon、mask、image 参数，和页面绑定
 - 当 Toast 和页面绑定时：
   + 当showToast执行时，会寻找当前页面栈顶的窗体（包括 dialogPage），找到后进行绑定，然后弹出 Toast。
 	+ 在支持 dialogPage 的平台（Web和App），[uni.showModal](./modal.md)、[uni.showActionSheet](./action-sheet.md) 也是 dialogPage 实现的，此时 toast 会绑定到这些 dialogPage 上

package/data/uniappx/api/window.md

@@ -5,6 +5,8 @@
 
 文档: [http://uniapp.dcloud.io/api/ui/window?id=onwindowresize](http://uniapp.dcloud.io/api/ui/window?id=onwindowresize)
 
+App平台暂未提供全局的uni监听API，而是需要在页面生命周期onResize 中监听页面尺寸变化。[另见](../page.md#onresize)
+
 ### onWindowResize 兼容性  
 | Web | 微信小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- |

package/data/uniappx/collocation/app.md

@@ -68,11 +68,11 @@
 - App平台可通过以下方法配置使用 scheme（deeplink） 启动应用，打包后生效
   + Android平台在 `manifest.json` 的可视化界面配置 scheme，参考[Android平台配置URL Schemes](../collocation/manifest-android.md#urlschemes)
   + iOS平台在 `manifest.json` 的可视化界面配置 scheme，参考[Android平台配置URL Schemes](../collocation/manifest-ios.md#urlschemes)
-  + 鸿蒙平台需在原生工程的 json5 中配置
+  + 鸿蒙平台在HBuilderX 5.26+ 支持在manifest中配置。低版本需在原生工程的 json5 中配置
 - App平台可通过以下方法配置使用 applink（通用链接） 启动应用，打包后生效
   + Android平台暂未支持 applink（通用链接）
   + iOS平台需先在 `manifest.json` 的可视化界面配置[关联域（Associated Domains）](../collocation/manifest-ios.md#associateddomains)，再在服务器配置`apple-app-site-association`，完整教程参考[iOS通用链接配置教程](https://uniapp.dcloud.net.cn/tutorial/app-ios-capabilities.html#%E9%80%9A%E7%94%A8%E9%93%BE%E6%8E%A5-universal-link)
-  + 鸿蒙平台需在原生工程的 json5 中配置
+  + 鸿蒙平台在HBuilderX 5.26+ 支持在manifest中配置。低版本需在原生工程的 json5 中配置
 - 如开发App页面直达功能，需先配置 scheme（deeplink） 或 applink（通用链接） 启动应用，在应用的 `onShow` 生命周期获取启动并解析appScheme或appLink参数，然后自行写 [uni.navigatorTo](../api/navigator.md#navigateto) 等路由API跳转页面。 `onShow` 生命周期的好处是不管首页启动还是后台激活到前台都触发，当然如果是初次启动，仍然会先打开App的首页再执行开发者编写的路由代码。
 - Web的页面直达无需使用scheme或通用链接，所有页面地址都可以直接在地址栏访问。
 
@@ -123,7 +123,7 @@
 
 无法监听异步逻辑（例如：`setTimeout`）中的错误和应用初始化之前、 App 崩溃等错误。
 
-onError里打印的错误，是拦截转发的。可能会丢失错误堆栈，导致无法精准定位问题。真机运行时尽量避免全局监听onError。
+onError里打印的错误，是拦截转发的。可能会丢失错误堆栈，导致无法精准定位问题所在代码行号。真机运行时尽量避免全局监听onError。
 
 #### onError 兼容性  
 | Web | 微信小程序 | Android | iOS | HarmonyOS |
@@ -248,7 +248,12 @@ onError里打印的错误，是拦截转发的。可能会丢失错误堆栈，
 
 > HBuilderX 3.99+
 
-小程序有 globalData，这是一种简单的全局变量机制。这套机制在 uni-app-x 里也可以使用，仅 `iOS uts 插件` 环境不支持。
+小程序有 globalData，这是一种简单的全局变量机制。这套机制在 uni-app x 里也可以使用。
+
+globalData依赖于vue和js环境，在页面里都使用，但在uts插件中使用有限制：
+
+- VDOM模式：仅 `iOS uts 插件` 环境不支持。
+- 蒸汽模式：Android和iOS的uts插件环境均不支持，鸿蒙在页面script驱动为ArkTS时，uts插件可以globalData，但页面script驱动为jsvm时，uts插件也不能使用globalData
 
 **以下是 App.uvue 中定义globalData的相关配置：**
 
@@ -278,7 +283,7 @@ onError里打印的错误，是拦截转发的。可能会丢失错误堆栈，
 
 ::: warning 注意
 - `uni-app x` 中 `globalData` 的数据结构与类型通过 `App.uvue` 中的 `globalData` 初始值定义，后续只能读取或修改，不能新增或删除。
-- 在组合式 API App.uvue 中使用 `globalData` 时，无法像选项式 API 那样通过 `this.globalData` 访问，而是需要通过 `getApp().globalData` 访问。但部分生命周期中 App 实例还未初始化，需要注意时机问题。
+- 在组合式 API App.uvue 中使用 `globalData` 时，无法像选项式 API 那样通过 `this.globalData` 访问，而是需要通过 `getApp().globalData` 访问。但部分生命周期中 App 实例可能还未初始化，需要注意时机问题。
 
 globalData是简单的全局变量，其他状态管理方式，可参考文档[全局变量和状态管理](../tutorial/store.md)。