tmui-cli 2.0.6 → 5.3.2

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

@@ -96,3 +96,8 @@
 
 
 <!-- CUSTOMTYPEJSON.UniNativeViewElement.example -->
+
+## tips
+
+鸿蒙有多种原生视图可以绑定，有bindHarmonyController、bindHarmonyWrappedBuilder、bindHarmonyFrameNode。
+在 uni-app x 蒸汽模式下，bindHarmonyFrameNode的性能更高一些。

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

@@ -9,15 +9,25 @@
 - NFC：[见插件市场](https://ext.dcloud.net.cn/search?q=nfc&orderBy=Relevance&cat1=8&cat2=81)
 
 ## plus api替代@plus
-uni-app x 中不再支持plus和weex的API。对于plus api中一些常用的api，在uni-app x中进行了替换增补。
-- plus.runtime.quit => [uni.exit](./exit.md)
-- plus.runtime.install => [uni.installApk](./install-apk.md)
-- plus.zip => [uni.getFileSystemManager](./get-file-system-manager.md) 中有一批 zip 相关的api。
+uni-app x 中不再支持plus和weex的API。
 
-一些plus api在插件市场有替代：
-- plus.sqlite [插件市场](https://ext.dcloud.net.cn/search?q=sqlite&uni-appx=1)
-- plus.speech [插件市场](https://ext.dcloud.net.cn/search?q=%E6%96%87%E5%AD%97%E8%BD%AC%E8%AF%AD%E9%9F%B3&orderBy=Relevance&uni-appx=1)
+本身uni的api和plus的api有一些重叠，在老uni-app中，能用uni api替代的，也应该用uni api替代。
+
+对于老uni-app中，plus api未进行uni化替代的，在uni-app x 中进行了增补或插件替代。
+
+- plus.runtime.quit 改用 [uni.exit](./exit.md)
+- plus.runtime.install 分拆成为2个API [uni.installApk](./install-apk.md) 和 [uni.installWgt](./install-wgt.md)
+- plus.runtime.restart 改用 [getApp().restart](./get-app.md#appmethods)
+- plus.runtime.setBadgeNumber 改用 [uni.setAppBadgeNumber](./uni-push.md#setappbadgenumber)
 - plus.runtime.openURL [插件市场](https://ext.dcloud.net.cn/plugin?id=17828)
+- plus.runtime.openWeb [uni-link](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/uni-link.html)
+- plus.runtime.showPrivacyDialog 请自行调用dialogPage，弹出自己的uvue页面。
+- plus.runtime.agreePrivacy、plus.runtime.disagreePrivacy 改用 [button组件](../component/button.md)的opentype="agreePrivacyAuthorization"
+- plus.runtime.launcher、plus.runtime.arguments 改用[app.uvue](../collocation/app.md)中onLaunch、onShow生命周期中的options参数
+- plus.io、plus.zip 改用 [uni.getFileSystemManager](./get-file-system-manager.md) 中有一批文件和压缩相关的api。
+- plus.navigator 中控制顶部状态栏和底部导航栏的方法，改在 pages.json 的 [pageStyle](../collocation/pagesjson.md#pagesoptionspage-style) 中控制，也可以在 UniPage 的 [setStyle](./unipage.md#unipage-methods) 方法中控制。
+- plus.sqlite 改用 [uasm的sqlite标准插件](https://ext.dcloud.net.cn/plugin?id=29856) 或 [插件市场的其他sqlite插件](https://ext.dcloud.net.cn/search?q=sqlite&uni-appx=1)
+- plus.speech [插件市场](https://ext.dcloud.net.cn/search?q=%E6%96%87%E5%AD%97%E8%BD%AC%E8%AF%AD%E9%9F%B3&orderBy=Relevance&uni-appx=1)
 
 插件市场有一些抹平plus写法的插件，自定义了一个plus对象，方法内部再调用uni或uts的api，以兼容历史的plus写法，[详见](https://ext.dcloud.net.cn/search?q=plus&orderBy=Relevance&uni-appx=1)
 

package/data/uni-app-x-docs/api/file-system-spec.md

@@ -20,10 +20,10 @@ uni-app x框架因为需要也会产生一些文件在CACHE目录中，比如拍
 	+ static
 	+ uni_modules
 - 本地磁盘文件：指应用在手机端运行时可访问的磁盘文件。又分以下目录：
-	+ 应用外置沙盒目录（`uni.env.SANDBOX_PATH`）：手机应用的沙盒目录，其中包括缓存文件目录和用户文件目录。在文件管理器中可看到。
-		* 缓存文件目录（`uni.env.CACHE_PATH`）：手机运行过程中框架保存缓存文件的目录（cache），系统空间不足时会被自动清理掉
-		* 用户文件目录（`uni.env.USER_DATA_PATH`）：提供给开发者操作的本地文件目录（files）
-	+ 应用内置沙盒目录（`uni.env.ANDROID_INTERNAL_SANDBOX_PATH`）：存放框架的网络缓存（如网络图片、视频、web-view的缓存）、storage。
+	+ 应用沙盒目录`uni.env.SANDBOX_PATH`：手机应用的沙盒目录，其中包括缓存文件目录和用户文件目录。在文件管理器中可看到。
+		* 缓存文件目录`uni.env.CACHE_PATH`：手机运行过程中框架保存缓存文件的目录（cache），系统空间不足时会被自动清理掉
+		* 用户文件目录`uni.env.USER_DATA_PATH`：提供给开发者操作的本地文件目录（files）
+	+ 应用内置沙盒目录`uni.env.ANDROID_INTERNAL_SANDBOX_PATH`：存放框架的网络缓存（如网络图片、视频、web-view的缓存）、storage。
 	+ 沙盒外目录
 
 **uts插件开发**  
@@ -73,15 +73,18 @@ fileManager.copyFile({
 
 > 注意：代码包文件只读，无法动态修改或删除。修改代码包文件一般会copy到沙盒目录后再修改。
 
-### 真机运行时代码包文件目录 @packageDebug  
+### 真机运行时代码包文件目录 @packagedebug  
 
 **注意：真机运行时代码包文件目录有特殊处理**  
 
 Android/iOS端真机运行期间，为了实现动态性，将代码包文件同步到`应用沙盒目录`下的特定目录：
 - Android平台
-	保存在应用专属存储空间的外置存储空间根目录下的apps目录，通常为“/sdcard/Android/data/%应用包名%/apps/%应用AppID%/www/”
+  + VDOM模式  
+    保存在应用专属存储空间的外置存储空间根目录下的apps目录，通常为“/sdcard/Android/data/%应用包名%/apps/%应用AppID%/www/”
+  + 蒸汽（Vapor）模式  、
+    保存在应用专属存储空间的内置存储空间根目录下的apps目录，通常为“/data/data/%应用包名%/apps/%应用AppID%/www/”
 - iOS平台
-	保存在应用沙盒目录下的Documents/uni-app-x目录，通常为“/%应用沙盒目录%/Documents/uni-app-x/apps/%应用AppID%/www/”
+  保存在应用沙盒目录下的Documents/uni-app-x目录，通常为“/%应用沙盒目录%/Documents/uni-app-x/apps/%应用AppID%/www/”
 
 请开发者不要使用FileManage API操作应用代码包文件。虽然真机运行时可以访问，但打包后代码包不在沙盒中，无法再访问。
 
@@ -113,7 +116,7 @@ fs.writeFile({
 ```
 
 
-### 外置应用沙盒目录@sandbox
+### 应用沙盒目录@sandbox
 目录常量名称：`uni.env.SANDBOX_PATH`
 
 App端专有目录，为应用沙盒根目录，其下包含了`缓存文件目录`和`用户数据目录`，真机运行时还包括应用资源目录。此目录在不同平台差异较大，不建议直接使用此目录，建议直接按需使用下方的缓存目录`uni.env.CACHE_PATH`和数据目录`uni.env.USER_DATA_PATH`。
@@ -206,7 +209,7 @@ uni-app x框架的一些内置组件和API会涉及缓存文件，存放到本
 FileSystemManager目前对内置应用沙盒目录为只读。如需写入，需开发uts插件。
 
 ### 沙盒外目录
-FileSystemManager API暂不支持访问沙盒外目录。
+FileSystemManager API不支持访问沙盒外目录。
 
 保存图片和视频到相册，有专门的API：[uni.saveImageToPhotosAlbum](./save-image-to-photos-album.md)、[uni.saveVideoToPhotosAlbum](./save-video-to-photos-album.md)、
 

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

@@ -14,6 +14,8 @@
 
 <!-- UTSAPIJSON.getApp.returnValue -->
 
+restart，并非真正的应用整体重启，而是前端wgt应用重启。js引擎会重新初始化，onLaunch会重新触发。但开发者需注意原生插件中重复初始化问题，插件作者应该做好防护。
+
 <!-- UTSAPIJSON.getApp.example -->
 
 ### 全局方法调用@appmethods

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

@@ -17,8 +17,6 @@
 
 - [ReadFileSuccessResult](./get-file-system-manager.md#readfilesuccessresult-values) 的data参数以前类型是string，Android平台4.31、iOS平台4.61起为了同时支持arraybuffer，类型改成了‘string | ArrayBuffer’，请在使用时手动as为指定类型；
 
-- app-ios平台4.11版本之前支持的api仅支持在uvue文件中使用文件管理器对象，uts插件中暂不支持； app-ios平台4.61版本后，所有api都支持在uts插件和uvue文件中使用，具体请查看兼容性；
-
 :::warning 注意
 
 ##### 为了和微信小程序保持一致，`HBuilderX 4.71+` 涉及如下API调整
@@ -26,7 +24,7 @@
 | 相关 API                | 升级前                                                                                                                                                          | 升级后                                                                                                                                                                                                                                                                                                                                                 |
 |------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `stat` / `statSync`    | - 返回路径是系统绝对路径                                                                                                                                   | - 返回路径是相对参数path的相对路径  <br> * 微信小程序规则：当 recursive 为 false 时，res.stats 是一个 Stats 对象。当 recursive 为 true 且 path 是一个目录的路径时，res.stats 是一个 Array，数组的每一项是一个对象，每个对象包含 path 和 stats  <br> * uniapp-x规则为避免返回值是联合类型，均返回数组，具体优化如下: <br> --- 当 path = 文件路径，返回数组，仅包含本身stats，返回 stats.path= "" <br> --- 当 path = 目录路径 && recursive = false，返回数组，仅包含本身stats，返回 stats.path= "/" <br> --- 当 path = 目录路径 && recursive = true，返回数组，包含本身stats和其递归子文件stats和目录文件stats                                                                                                                                                                                                                                                                                                                    |
-| `saveFile` / `saveFileSync` | **参数 `filePath`**  <br> - 传入nil：默认保存到 `uni.env.USER_DATA_PATH` 目录  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到filePath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br> <br> **返回路径 `savedFilePath`** <br> - 返回绝对路径   | **参数 `filePath`** <br> - 传入nil：默认保存到 `uni.env.CACHE_PATH/uni-store/` 目录 <br> - 传入错误路径：比如无权限的路径，返回 error  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存 <br> -传入filePath是目录路径且已存在，则返回错误码`1300021`   <br>  -传入filePath是文件路径且已存在，则覆盖写入  <br>- 判断传入路径尾部是否带斜线，如xxx/path、 xxx/path/，直接视为写入到path文件，如xxx/path/sub.txt 具体的是写入到具体的文件，path是目录 <br> <br> **返回路径 `savedFilePath`** <br> - 使用 `unifile://` 路径, 如果参数filePath=nil, savedFilePath= `unifile://cache/uni-store/xxx`; 否则savedFilePath= `unifile://cache/xxx`/`unifile://usr/xxx`/`unifile://sandbox/xxx` <br>  <br> **其他** <br> - 成功保存后删除临时文件 |
+| `saveFile` / `saveFileSync` | **参数 `filePath`**  <br> - 传入 `null`：默认保存到 `uni.env.USER_DATA_PATH` 目录  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到filePath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br> <br> **返回路径 `savedFilePath`** <br> - 返回绝对路径   | **参数 `filePath`** <br> - 传入 `null` ：默认保存到 `uni.env.CACHE_PATH/uni-store/` 目录 <br> - 传入错误路径：比如无权限的路径，返回 error  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存 <br> -传入filePath是目录路径且已存在，则返回错误码`1300021`   <br>  -传入filePath是文件路径且已存在，则覆盖写入  <br>- 判断传入路径尾部是否带斜线，如xxx/path、 xxx/path/，直接视为写入到path文件，如xxx/path/sub.txt 具体的是写入到具体的文件，path是目录 <br> <br> **返回路径 `savedFilePath`** <br> - 使用 `unifile://` 路径, 如果参数filePath=`null`, savedFilePath= `unifile://cache/uni-store/xxx`; 否则savedFilePath= `unifile://cache/xxx`/`unifile://usr/xxx`/`unifile://sandbox/xxx` <br>  <br> **其他** <br> - 成功保存后删除临时文件 |
 | `getSavedFileList`     | 返回 `uni.env.USER_DATA_PATH` 目录中的文件列表, 均绝对路径                                                                                                                            | 返回 `unifile://cache/uni-store/`(uni.env.CACHE_PATH/uni-store/) 目录中的文件列表                                                                                                                                                                                                                                                            |
 | `rmdir` / `rmdirSync`  | iOS 无法删除空的 `uni.env.USER_DATA_PATH`、`uni.env.CACHE_PATH` 目录（系统限制）<br>Android/Harmony 可删除任意目录                                                         | **删除特殊目录，只删除子，保留本身**  <br>  - `uni.env.SANDBOX_PATH` <br> - `uni.env.CACHE_PATH` <br>  - `uni.env.USER_DATA_PATH` <br> - `uni.env.ANDROID_INTERNAL_SANDBOX_PATH` <br> <br> **其他创建的目录可以删除子和本身**  <br>                                                                                                                                                                                   |
 | `copyFile` / `copyFileSync` | **参数 `destPath`**  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存  <br> - 传入目录路径：如果存在，保存到destPath/截取tempFilePath的文件名；如果不存在，先创建再保存  <br> - 传入错误路径：比如无权限的路径，返回 error <br>  | **参数 `destPath`** <br>  <br> - 传入错误路径：比如无权限的路径，返回 error  <br> - 传入文件路径：如果上一级目录存在，保存到传入的路径，如存在则覆盖；如果上一级目录不存在，上上级目录也不存在，则先递归创建再保存 <br> -传入destPath是目录路径且已存在，则返回错误码`1300021`   <br>  -传入destPath是文件路径且已存在，则覆盖写入  <br>- 判断传入路径尾部是否带斜线，如xxx/path、 xxx/path/，直接视为写入到path文件，如xxx/path/sub.txt 具体的是写入到具体的文件，path是目录 <br> <br> |

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

@@ -0,0 +1,73 @@
+<!-- UTSAPIJSON.installWgt.name -->
+
+<!-- UTSAPIJSON.installWgt.description -->
+
+wgt，是 uni-app x 蒸汽模式的前端资源包。包括uvue、脚本、静态资源。不包括原生插件。
+
+通过在线下载和安装wgt，可以实现相同appid应用的资源替换。
+
+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 包是不同的。
+
+推荐使用 [uni升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html) 进行 wgt 发布与更新，它拥有众多优势：
+- 成熟、现成的云端一体升级系统，免去数十工作日的成本
+- 丰富的更新策略：整包更新、热更新，强制更新、静默更新、灰度更新...
+- 更安全：通过sha256验签，防止网络劫持造成的安全隐患
+- 更高性能：客户端的下载、验签、安装全部在独立子线程，不影响前台应用
+- cdn成本更低
+
+<!-- UTSAPIJSON.installWgt.compatibility -->
+
+<!-- UTSAPIJSON.installWgt.param -->
+
+<!-- UTSAPIJSON.installWgt.fileFormats -->
+
+<!-- UTSAPIJSON.installWgt.returnValue -->
+
+<!-- UTSAPIJSON.installWgt.example -->
+
+## 热更新与应用商店
+
+应用商店可以接受热更新用于修复紧急bug、运营活动调整、部分功能升级。几乎所有大厂App也都有动态化方案。
+
+但应用商店也有底限：
+1. 热更新不能用于改变应用性质，不能用于动态添加违法违规内容，不能用于绕过Apple的iap分成等类似影响应用商店权益的行为。
+2. 确保提交给应用商店审核的包是最新包，不能在审核期间热更新。
+
+额外建议：当开发者发布了热更新后，也应该及时提交应用商店，避免应用刚下载就立即弹升级提示。可以使用[uni多商店上传](https://doc.dcloud.net.cn/uni-app-x/uni-publish/intro.html)，来批量提交应用商店。
+
+## 使用流程
+
+通过wgt包在线升级应用操作流程：
+- 更新版本号： manifest中修改应用版本名称（versionName），要求大于线上已发布的版本名称
+- 生成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热更新，只能更新前端资源，不能热更新原生底座的原生模块，不能热更新manifest相关内容。需注意前端代码与原生底座的匹配性。
+
+举例，初始的原生包中，未包含map地图模块。如果基于该原生包安装新wgt包，新wgt包中的代码引用了map组件，那么该这部分代码在运行时会报错。
+
+打包时，HBuilder控制台会列出当前打包了哪些模块，默认是根据当前代码使用的模块来摇树决定的。如果要额外添加某些模块，需要在manifest中手动配置，配置后需重新打包才能生效。[详见](../collocation/manifest-modules.md#manual)
+
+开发者可以提前预置一些暂时未使用的模块。也可以在遇到需要更新原生模块的时候，请求用户升级完整包（可以在热更新的时候，也可以在报缺少模块错误的时候）。
+
+## tips
+
+- **真机运行环境：** 调用 `uni.installWgt` 成功后会直接替换当前运行资源。为了避免出现资源不同步，必须在安装成功的回调中调用 `getApp().restart()` 重启应用或手动关闭重新打开应用。
+- **正式包环境：** 调用 `uni.installWgt` 成功后不会直接替换当前应用资源，新资源仅在重启应用或主动调用 `getApp().restart()` 后生效，不会影响当前正在运行的版本。
+- **测试建议：** wgt包升级测试务必在打包后的正式包环境中进行，不建议仅凭真机运行环境测试。
+
+<!-- UTSAPIJSON.installWgt.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

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

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

@@ -66,7 +66,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
+* Android release 包默认禁止 http 明文请求（Android 9+ targetSdkVersion≥28）。会导致联网失败，表现为报错 CLEARTEXT communication to xxx not permitted by network security policy（如 {"errCode":602001,"errMsg":"request system error",...,"cause":{"message":"CLEARTEXT communication to xxx not permitted by network security policy"}}）。优先推荐使用 https 来解决。如果确定坚持不安全的http，那么方案如下：在项目根目录新建 AndroidManifest.xml，给 application 节点加 android:usesCleartextTraffic="true"，配置方式见 https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html
 
 <!-- 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>
 

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

@@ -36,27 +36,40 @@
 
 <!-- UTSAPIJSON.general_type.param -->
 
-## Bug & Tips@tips
-- 在 iOS、微信小程序、Web 平台，showToast 是和页面（包括 dialogPage）绑定的
-- 在 Android 平台
-	* position 设为 bottom 时，为系统toast，此时与 App 绑定，而不是与页面绑定。position 不为 bottom 时仍与页面绑定
-	* 系统toast 不支持 icon 图标，仅支持文字
+## 页面级toast和应用级toast@position
+
+toast，分页面级和应用级。默认为页面级。
+
+- 页面级toast：
+	toast 和页面绑定。**页面（含 dialogPage）关闭时，toast 会跟随页面立即一起消失；新页面（含 dialogPage）出现时会遮挡之前页面弹出的 toast **。
+  + 当showToast执行时，会寻找当前页面栈顶的窗体（包括 dialogPage），找到后进行绑定，然后弹出 Toast。
+	+ 在支持 dialogPage 的平台（Web和App），[uni.showModal](./modal.md)、[uni.showActionSheet](./action-sheet.md) 也是 dialogPage 实现的，此时 toast 会绑定到这些 dialogPage 上
+	+ 在弹出 toast 后，再次打开新页面，新页面会覆盖原页面弹出的 toast。
+		+ 如需在新页面（包括 dialogPage）弹出 toast，需要再次调用 showToast
+  + 关闭页面（包括 dialogPage）时，toast 会跟随页面（包括 dialogPage）一起消失
+		+ 如需在dialogPage关闭后，仍然弹出 toast，需要在关闭dialogPage后再次调用 showToast
+- 应用级toast：
+	toast 和应用绑定。
+	弹出和关闭页面，全部 toast 都不会跟随页面被遮挡或消失。toast会按指定的时长完整显示，然后再消失。
+
+由于历史原因和平台差异，设置应用级 toast 的方式是设置 showToast 的参数 position 属性，不管 position 设为 "top"、"center"、"bottom" 均可。
+
+并非所有平台、所有版本都支持设置 position，即应用级 toast。
+- 小程序平台不支持，所以小程序平台的 toast 都是和页面绑定的。
+- web平台暂不支持。后续会补充
+- iOS平台需要5.31+ 蒸汽模式才支持。
+- Android平台设置 position 时弹出的是 Android系统的 toast，该 toast 样式受rom影响：
+	* 系统toast 不支持 icon 图标，仅支持文字，Android12及以上版本文字内容通常限制为两行
+	* Android11及以上版本，系统toast设置不支持设置显示在顶部或居中，仅支持显示在底部
+	* Android11及以上版本，应用进入后台后，调用系统 toast 不弹出。 [文档地址](https://developer.android.google.cn/about/versions/11/behavior-changes-11?hl=nb#toasts)
 	* 部分 Android ROM，如 MIUI，调用系统 toast 时，会在 toast 行首自动加上 App 图标。此为 ROM 行为，目的是帮助用户区分该 toast 是哪个 App 弹出的
-- 在 HarmonyOS 平台
+- HarmonyOS 平台
   - 5.24 及以下
     - 只有系统 toast ，和 App window 绑定
   	- 不支持 icon 图标，仅支持文字
   - 5.25 及以上：
   	* 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 上
-	+ 在弹出 Toast 后，再次打开新页面，新页面会覆盖原页面弹出的 Toast。
-		+ 如需在新页面（包括 dialogPage）弹出 Toast，需要再次调用 showToast
-  + 关闭页面（包括 dialogPage）时，Toast 会跟随页面（包括 dialogPage）一起消失
-		+ 如需在dialogPage关闭后，仍然弹出 Toast，需要在关闭dialogPage后再次调用 showToast
-- 当 Toast 和应用绑定时，也即系统 toast：
-	弹出和关闭页面，系统 toast 都不会跟随页面被遮挡或消失。
-- Android 11 及以上版本，应用进入后台后，调用系统 toast 不弹出。 [文档地址](https://developer.android.google.cn/about/versions/11/behavior-changes-11?hl=nb#toasts)
+
+## Bug & Tips@tips
 - showToast 里的 Loading，和 showLoading 的区别是，showLoading 需要手动调用 HideLoading 才会关闭。而 showToast 里的 Loading 显示指定时间后会自动关闭。一般情况都需要精准控制关闭时机，所以大多使用 showLoading 和 hideLoading