tmui-cli 2.0.3 → 2.0.5

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

@@ -0,0 +1,67 @@
+## 简介
+`uni-app x 原生SDK`是为iOS/Android/harmonyOS原生工程师提供的开发工具包，用于混合开发。
+
+蒸汽（Vapor）模式的SDK需HBuilderX 5.25+
+
+使用 `uni-app x 原生SDK`，原生开发者可以：
+1. 渐进式的使用，把某些页面使用 uni-app x 来开发，嵌入之前的原生工程中
+2. 使用自己的原生工程集成环境来打包和发版
+
+原生工程师可以在自己的原生项目中引入`uni-app x 原生SDK`，该SDK分iOS/Android/harmonyOS不同版本，进而把uni-app x开发的页面编译进入原生工程中，整体联调运行。
+
+由于uts编译为了原生语言，所以原生工程和 uni-app x 工程可以良好的互操作，甚至可以整体断点Debug。
+
+`uni-app x 原生SDK`在某种程度上类似于react native/weex/flutter的SDK，但有如下特点：
+
+1. uni-app x 不仅仅是一个渲染view
+
+其他几个跨平台框架主要是渲染引擎，提供了一个view给原生开发者使用。
+
+而 uni-app x 提供了一个完整的应用，有页面管理、众多组件和API。
+
+所以在原生应用中集成`uni-app x 原生SDK`，更像是集成一个小程序SDK。
+
+当然 uni-app x 的性能足够好，它不会像小程序那样启动缓慢，也比其他跨平台框架的性能和原生UI兼容性更好（评测[另见](../app-vapor.md)）
+
+uni-app x 内置丰富的跨平台API，可以切实提高整体开发效率。
+
+如果仅UI跨平台，但大量API开发仍然需要各自平台为跨平台UI框架提供接口，那会造成4个人一起干活（1个人写前端页面，3个人在各自的原生平台写接口API）。
+
+而 uni-app x 丰富的内置组件和API，以及插件市场丰富的跨平台插件，可以保证大多数业务开发仅需1人写 uni-app x 代码即可。
+
+2. uni-app x和原生工程可以无缝融合
+
+rn/flutter等，运行语言与原生语言是不同的语言。互相交互需要搭桥。
+
+flutter的自渲染引擎，和原生渲染引擎也无法无缝融合。
+
+而 uni-app x 的uts代码，编译产物就是原生语言，所以可以无缝的互操作。
+
+互相调用时，相当于同一个语言不同函数的调用，而不是不同语言的桥接通信。
+
+基于这个特点，uni-app x 还提供了原生混编联调。
+
+把原生工程和 uni-app x 工程一起拖入HBuilderX中，整体联编为一个原生工程，让 uts 和 arkTS 混编，甚至断点联调。
+
+<!-- 比如现在uts代码下一个断点，然后调用到了原生工程的kt代码，再下一个断点，可以单步跟踪，给混合开发带来前所未有的方便体验。 -->
+
+## 关系
+
+这里有3个概念：
+1. 原生工程：开发者的既存原生工程
+2. uni-app x 原生SDK：需在 uni-app x 官方下载的SDK，分Android版、iOS版、harmonyOS版
+3. uni-app x 应用原生资源：开发者在HBuilderX中新建的 uni-app x 项目，通过发行菜单或HBuilderX的cli导出的应用原生资源
+
+使用流程一般是：
+1. 开发者在HBuilderX新建 uni-app x 项目，进行开发
+2. 在HBuilderX中导出应用原生资源，生成一批kt/swift/ets/js代码及相关图片字体等附件资源
+3. 开发者在原生工程中引入`uni-app x 原生SDK`，合并入导出的应用原生资源，整体运行编译
+
++ [集成Android平台原生SDK](./use/android.md)
++ [集成iOS平台原生SDK](./use/ios.md)
++ [集成harmonyOS平台原生SDK](./use/harmony.md)
+
+## 包体积增加说明
+集成 uni-app x 原生SDK 到原生工程中，
+- 蒸汽模式：iOS和鸿蒙的包体积增加数M。Android平台因为带了V8，包体积每个CPU增加十几M。如在manifest里选择不压缩so库，Android的包体积会增加4、50M。
+- VDOM模式，安装包体积增加数M。

package/data/uni-app-x-docs/native/debug/android.md

@@ -0,0 +1,126 @@
+# 原生联调
+
+宿主原生应用是kt/java代码，在as中运行。uni-app x应用是uvue/uts代码，在HBuilderX中运行。但两者经常需要联调。
+
+得益于uts的编译产物就是kotlin，所以uni-app x可以和原生应用混编运行，联调debug。
+
+有两种方案：
+1. 在HBuilderX 4.71以前，支持把宿主原生应用变成HBuilderX的自定义基座。
+这种方式需要把宿主应用先打包为带有uni-app x调试模块的apk，再运行uni-app x项目，无法动态修改宿主应用的原生代码。
+2. 从HBuilderX 4.71+，支持宿主原生工程直接拖入HBuilderX中，和uni-app x项目进行源码级联编联调。
+
+无论哪种方案1还是方案2，首先要对宿主原生应用进行一些配置
+
+## Android Studio 项目配置
+
+对宿主原生项目配置，目的是为了加入uni-app x的调试模块，并对uni-app x调试模块所需的依赖进行配置。
+
+1. 下载uni-app x原生SDK后，将debug-server-release.aar拷贝到原生项目的libs目录下
+2. 在app模块的build.gradle下添加如下依赖
+```groovy
+	dependencies {
+		implementation "com.squareup.okhttp3:okhttp:3.12.12"
+		implementation "net.lingala.zip4j:zip4j:2.11.5"
+		implementation "com.squareup.leakcanary:leakcanary-android:2.14"
+	}
+```
+3. 修改AndroidManifest.xml
+
+	在application节点下添加如下内容
+	
+	```xml
+	<meta-data android:name="DCLOUD_DEBUG" android:value="true"/>
+	```
+	
+	添加网络权限
+	
+	```xml
+	<uses-permission android:name="android.permission.INTERNET" />
+	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+	```
+	
+注意：
+- 如果android原生项目的drawable目录下不存在名称为icon的图片，需要临时先补充一个命名为icon的文件。
+- 当build.gradle中的`targetSdk`为34时，在安卓14设备上资源同步会失败。建议将`targetSdk`调整到30至33之间。
+- 当前模块仅为调试使用，发行版本请删除上面的配置。
+- 如果发行版本显示`正在加载调试框架...`或`Loading debugging framework...`，请删除上面的调试模块配置。
+
+## 方案1：把宿主应用打包为HBuilderX的自定义基座。
+
+思路：把宿主原生工程打包为apk，成为自定义基座。然后在HBuilderX中运行uni-app x时，选择这个自定义基座，运行到手机上。
+
+如果您不了解什么是运行基座、标准基座、自定义基座，这些概念，请参考[文档](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#playground)
+
+### 1. 原生工程生成自定义基座  
+
+- 打开原生工程build.gradle文件，修改versionCode和versionName字段，如下图：
+	
+![avatar](https://img.cdn.aliyun.dcloud.net.cn/nativedocs/5%2BSDK-android/image/6-1.png)
+	
+versionCode为应用的版本号（整数值），用于各应用市场的升级判断，需要与uni-app x项目的manifest.json中versionCode值一致
+	
+versionName为应用的版本名称（字符串），在系统应用管理程序中显示的版本号，需要与uni-app x项目的manifest.json中versionName值一致。
+
+**注意：版本号应该与uni-app x应用一致。**
+
+- 点击android studio的`Build->Generate Signed Bundle/APK...`生成安装包。
+
+**注意：自定义基座不支持aab包。**
+
+### 2. 将自定义基座添加到uni-app x 项目  
+- 将生成的apk文件重命名为`android_debug.apk（VDOM模式）`或`android_debug_vapor.apk（蒸汽模式）`
+- 将apk文件拷贝到uni-app x项目的unpackage/debug目录下
+- 点击 HBuilderX中运行按钮->运行到Android App基座，勾选`使用自定义基座运行`
+
+	![](https://web-ext-storage.dcloud.net.cn/native/doc/android/debug_hx.png)
+
+运行成功后，在手机自定义基座中打开uni-app x应用，HBuilderX控制台可以看到运行log。
+在HBuilderX中修改uni-app x代码，可以在手机端基座中热刷生效。
+
+## 方案2：原生工程联编联调 @installedapk  
+> HBuilderX4.71+
+
+**注意：需要将 HBuilderX 和 uni-app x SDK 都升级到4.71或以上版本**
+
+在前述原生工程配置完成后，可以通过android studio直接运行到手机上。
+
+然后切换到 HBuilderX 点击运行按钮->运行到Android App基座，勾选`使用自定义基座运行`->`已安装的基座`。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/debug_installed.jpg)
+
+调试的包名与原生工程的`build.gradle`中`applicationId`字段一致。
+
+选择正确的包名，点击运行即可。
+
+uni-app x项目将开始编译，并热重载到手机的原生应用中。
+
+运行成功后，将可以在HBuilderX的控制台中看到uni-app x应用的日志，点击后可以到uvue/uts的源码中。
+修改uni-app x代码后，手机端将热重载更新。
+
+此时也可以在控制台右上角点击红色虫子按钮开启debug，进行uni-app x应用的断点调试。
+
+如果您不了解如何在HBuilderX中如何调试uni-app x，可以参考[文档](https://uniapp.dcloud.net.cn/tutorial/debug/uni-uts-debug.html)。
+
+如果需要调试原生工程，需要配置上图中的`关联项目`，关联项目的路径为原生工程的根目录。并将原生工程拖入到HBuilderX中。参考下图：
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/drop_project.gif)
+
+配置成功后，重新运行uni-app x项目。
+
+在需要调试的kt/java代码行号上点右键设置断点，开启`uts调试`。如下图：
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/kt_debug.png)
+
+断点设置成功之后，可以触发相应的逻辑进入调试模式。
+
+在HBuilderX中还可以在原生工程和uni-app x项目中各自打断点。在原生的kt/java和uni-app x代码的断点之间来回单步跟踪，方便排查联调问题。具体效果可以参考如下视频：
+
+<video id="video" preload="none" controls="controls" width="900px" height="580px" src="https://web-ext-storage.dcloud.net.cn/native/doc/android/debug-native-video.mov" poster="https://web-ext-storage.dcloud.net.cn/native/doc/android/debug-native-video-poster.png"></video>
+
+:::tip Tips
+- 如果在HBuilderX中改动了原生工程的kt/java文件，需要在android studio中重新运行项目才会生效。
+- 关联项目的路径应为原生工程的根目录。否则HBuilderX设置在kt/java文件上的断点可能不会生效。
+- 不要在Android studio和HBuilderX中同时开启调试服务，否则会导致Android studio/HBuilderX的调试服务无法正常启动。
+- 调试原生工程时，在Android studio中重新运行项目，需要在HBuilderX中重新开启调试服务。
+- HBuilderX对kt/java代码只有基本的高亮和格式化，没有语言服务。编写原生代码仍然应该在Android Studio中进行。两个IDE同时打开协作使用。
+:::

package/data/uni-app-x-docs/native/debug/harmony.md

@@ -0,0 +1,119 @@
+# 原生联调@joint-debugging
+
+> 本文档描述的内容适用于 HBuilderX 4.71+ 版本，针对 uni-app x 项目有效。
+
+原生工程和其他跨平台框架的功能之间混合开发，是很麻烦的。两个项目来回修改、编译、同步到原生工程中，发现有问题，再重来。
+
+得益于 uni-app x 编译为原生语言的能力，在鸿蒙原生工程中嵌入 [uni-app x 原生 SDK 鸿蒙版](https://doc.dcloud.net.cn/uni-app-x/native/use/harmony.html) 进行混合开发时，可以方便地联调。
+
+这是其他跨平台工具无法提供的，但又对开发效率、问题排查极其重要，能切实提高混合开发效率。
+
+由于 HBuilderX 支持调试 uts，且 uts 在鸿蒙上编译为 ets，所以 HBuilderX 也具备调试 ets 的能力。
+
+把 uni-app x 项目和宿主原生应用项目都在 HBuilderX 中打开，直接以【联编调试】的方式在 HBuilderX 中对宿主应用和 uni-app x 项目进行联调，可以随时对 uni-app x 项目中的源代码做修改，并在两个项目同时进行断点调试，就像调试一个普通的 uni-app x 项目那样方便。
+
+
+## 准备工作@prepare
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/harmony-native-debug-prepare.png)#{.zooming style="max-height:400px"}
+
+首先，在 HBuilderX 中导入 uni-app x 项目目录和宿主应用的原生鸿蒙工程目录。
+
+然后在 uni-app x 项目根目录中的 `.hbuilderx/launch.json` 文件中添加如下内容（如果文件不存在则手动创建）：
+
+```json
+{
+  "version" : "1.0",
+  "configurations": [
+    {
+      "type": "uni-app:app-harmony",
+      "debugWithNativeHarmony": true,
+      "nativeHarmonyProjectPath": "D:/native-harmony-project"
+    }
+  ]
+}
+```
+其中：
+- `type` 固定值为 `"uni-app:app-harmony"`。
+- `debugWithNativeHarmony` 用于开启联编调试功能，缺省为 `false` 不开启。
+- `nativeHarmonyProjectPath` 用于指定调试运行的时候使用的鸿蒙工程目录（即导入 HbuilderX 的那个宿主应用项目的根目录），无缺省值，如果开启了联编调试则此项必填，且指向的目录必须已存在。
+
+
+## 调试开发@debugging
+
+在 HBuilderX 中，打开 uni-app x 项目中的任何一个文件，然后通过主菜单或工具条执行【运行到鸿蒙】操作，HBuilderX 会在对 uni-app x 项目进行编译之后自动执行类似于【本地打包 App 资源】的操作，
+只不过生成的 App 资源会自动组装到宿主原生应用的鸿蒙工程目录中去。
+
+然后就可以像调试普通 uni-app x 项目一样来进行调试开发了。
+
+**此时的调试操作不仅适用于 uni-app x 项目，也适用于宿主原生应用项目。**
+
+### 开启/关闭调试@enable-debugger
+
+通过【运行到鸿蒙】把 uni-app x 项目启动运行之后，可以在控制台里面点击调试按钮开启。
+
+![](https://web-ext-storage.dcloud.net.cn/doc/tutorial/harmony/b7c69c0e-0447-41f1-b974-35eb8d076cc8.png)#{.zooming style="max-height:60px;border:1px solid silver"}
+
+点击【开启调试】按钮的时候如果还在编译阶段，则会等到后续应用运行起来的时候进入调试状态。
+
+如果点击时应用已经运行起来，则直接进入调试状态，此后代码运行遇到断点就会停下来，但应用启动阶段的代码断点因为已经错过了时机而不会停下来，此时要想让那些断点起作用的话可以点击旁边的【重启应用】按钮。
+
+如果要退出调试状态，再次点击该按钮即可。
+
+### 打断点@add-breakpoint
+
+打开要调试的uts、uvue、ets文件，在代码行号上，鼠标右击或双击添加断点。
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uts-add-breakpoint.png)#{.zooming style="max-height:200px"}
+
+### 调试视图@debug-view
+
+开启调试后，即可在HBuilderX左侧视图，看到调试视图，具体如下：
+
+下图中包含了uvue、uts、ets的调试步骤
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/harmony-debug.gif)#{.zooming style="max-width:100%"}
+
+调试视图分为5部分:
+
+- 调试工具栏
+- 变量窗口 (`复制值`、`复制表达式`、`添加到监视`)
+- 监视窗口（包含`添加`/`编辑`/`删除`表达式，以及`复制值`）
+- 调用堆栈窗口
+- 断点窗口（包含`删除`/`启用`/`禁用`断点）
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uts-debug-action.jpg)#{.zooming style="max-height:200px"}
+
+### 跟踪调试操作@debug-actions
+
+- 继续 `F8`
+- 下一步 `F10`
+- 进入 `F11`
+- 返回 `Shift+F11`
+
+### 数据检查：添加到监视@add-to-watch
+
+在【变量窗口】，选中变量，右键菜单，即可将变量添加到监视窗口。
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uts-add_to_monitor.png)#{.zooming style="max-height:240px"}
+
+### 数据检查：悬停显示@hover-preview
+
+断点调试过程中，将鼠标悬停在要查看的变量上，即可打开悬停窗口。
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uts-hovering_window.jpg)#{.zooming style="max-height:250px"}
+
+
+## 注意事项@notes
+
+1. 如果修改了宿主原生应用的代码，则需要保存之后手动再次【运行到鸿蒙】（或者点击控制台工具条的【重新运行】按钮）重新开始调试运行。
+
+2. HBuilderX 的联编调试功能不能跟 DevEco Studio 的调试功能同时运行，也不能 Attach 到 DevEco Studio 已经运行的应用实例上。
+
+3. HBuilderX 对鸿蒙原生工程的支持有限，大段代码开发仍然应该在 DevEco Studio 中进行。
+
+4. 宿主原生项目的路径应为原生鸿蒙工程的根目录，否则 HBuilderX 设置在 ets 文件上的断点可能不会生效。
+
+5. 如果主应用 Ability 的 constructor 无法打断点，可以在里面加一个 setInterval 定时器来辅助调试。（此问题后续会解决。）
+
+6. 在 uni-app x 与鸿蒙原生工程联调时，会优先ets的调试。因此，直接调试 uni-app x 项目里 uts 目前不可行(uvue可以正常调试)，但鸿蒙工程根目录下的ets文件可以正常调试。比如uni-app x 项目下uni_modules目录会被编译到鸿蒙工程根目录下，这种场景下可以直接调试鸿蒙工程/uni_modules目录中的ets文件（此问题后续会解决。）

package/data/uni-app-x-docs/native/debug/ios.md

@@ -0,0 +1,92 @@
+# 原生联调
+
+宿主原生应用是Objective-C/Swift代码，在Xcode中运行。uni-app x应用是uvue/uts代码，在HBuilderX中运行。但两者经常需要联调。
+
+得益于uts的编译产物就是Swift，所以uni-app x可以和原生应用混编运行，联调debug。
+
+有两种方案：
+1. 在HBuilderX 4.81以前，支持把宿主原生应用变成HBuilderX的自定义基座。
+这种方式需要把宿主应用先打包为带有uni-app x调试模块的基座(.ipa文件)，再运行uni-app x项目，无法动态修改宿主应用的原生代码。
+2. 从HBuilderX 4.81+，支持宿主原生工程直接拖入HBuilderX中，和uni-app x项目进行源码级联编联调。
+
+无论哪种方案1还是方案2，首先要对宿主原生应用进行一些配置
+
+## Xcode 配置项目
+对宿主原生项目配置，目的是为了加入uni-app x的调试模块，并对uni-app x调试模块所需的依赖进行配置。
+1. 下载[uni-app x原生SDK](https://doc.dcloud.net.cn/uni-app-x/native/download/ios.html)后，将DCloudDebugServe.xcframework添加到原生工程中。
+2. 将原生工程中`Target`的名称改为`UniAppX`。如图：
+   ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_update_target_name.jpg)
+         
+3. 在工程`Info.plist`下添加`UIFileSharingEnabled`节点，值设置为`true`。如图：   
+      
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_info_filesharingenabled.png)
+
+4. 填写`Display Name(建议与manifest.json中name值一致)`、`Build(建议与manifest.json中versionCode一致)`、`Version(建议与manifest.json中versionName值一致)`字段。如图：
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_update_name_version.png)
+
+5. 在工程`Info.plist`下添加`uniapp-x`节点，在节点中配置`appid(必须与manifest.json中appid值一致)`以及`ipatype(在HBuilderX中调试需要设置为1)`,如图：  
+   ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/uniappx_app_info.png)
+  
+## 方案1：把宿主应用打包为HBuilderX的自定义基座。
+思路：把宿主原生工程打包为ipa，成为自定义基座。然后在HBuilderX中运行uni-app x时，选择这个自定义基座，运行到手机上。
+
+如果您不了解什么是运行基座、标准基座、自定义基座，这些概念，请参考[文档](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#playground)
+
+### 原生工程生成自定义基座
+检查`Target -> Info -> uniapp-x`节点下的`uniRuntimeVersion`与`HBuilder X`版本号是否一致，如有差异建议更新为相同版本。   
+在Xcode菜单栏中，选择`Product -> Archive` 根据提示导出ipa文件  
+
+### 将自定义基座添加到uni-app x 项目  
+1. 将生成的`ipa`文件重命名为`iOS_debug.ipa`   
+2. 将`iOS_debug.ipa`拷贝到`uni-app x`项目的`unpackage/debug`目录下   
+3. 点击 `运行 -> 运行到iOS App基座`，勾选`使用自定义基座运行` 
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_export_to_hx.jpg)
+
+运行成功后，在手机自定义基座中打开uni-app x应用，HBuilderX控制台可以看到运行log。
+在HBuilderX中修改uni-app x代码，可以在手机端基座中热刷生效。
+
+
+## 方案2：原生工程联编联调
+> HBuilderX4.81+
+
+**注意：需要将 HBuilderX 和 uni-app x SDK 都升级到4.81或以上版本**
+
+在前述`Xcode 配置项目`配置完成后，可以通过Xcode直接运行到手机上。
+
+然后切换到 HBuilderX 点击运行按钮->运行到iOS App基座，勾选`使用自定义基座运行`->`原生工程基座`，在`基座位置`处输入Xcode编译产物(UniAppX.app)的路径后，点击运行。
+
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_debug_choose_ipa.png)
+
+### 如何获取基座位置
+编译成功后，在 Xcode 左侧的 ​​项目导航器 (Navigator)​​ 中，切换到 ​​`Products`​​ 目录。找到你的项目名称对应的 .app文件。右键点击​​它，选择 `​​Show in Finder` 或 将其拖入到终端中获取路径。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_debug_xcode_find_app_path.png)
+ 
+
+### 调试原生工程中的uvue页面
+
+在HBuilder X完成运行基座后，通过 HBuilder X 控制台右上角的红色虫子按钮点击`开启uts调试(jscore)`后通过双击或右键在uvue页面中添加断点调试。断点调试详情参考 [uni-app x iOS uts 调试](https://uniapp.dcloud.net.cn/tutorial/debug/uni-uts-debug-ios.html) 中的 `uni-app x jscore调试` 部分。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_hx_start_debug.png)
+
+
+### 调试原生主工程或UTS插件
+
+在HBuilder X完成运行基座后，将Xcode中的原生工程根目录拖入到HBuilderX的项目管理器中，通过 HBuilder X 控制台右上角的红色虫子按钮点击`开启uts调试(swift)`后通过双击或右键在原生代码中添加断点。断点调试详情参考[uni-app x iOS uts 调试](https://uniapp.dcloud.net.cn/tutorial/debug/uni-uts-debug-ios.html) 中的 `uni-app x swift调试` 部分。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_debug_hx_native.png)
+
+
+调试UTS插件必须将插件原生工程通过 ​​`Workspace` 或 `引用工程`的方式​​ 引入您的主工程。不可仅引用导出的`xcframework`或`framework`产物文件，否则无法进行源码调试。具体可参考SDK中的示例`UniAppXDemo`。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/x_native_sdk_debug_xcode_uniappxdemo_workspace.png)
+
+
+调试UTS插件流程同上，在HBuilder X完成运行基座后，将插件原生工程拖入到HBuilderX的项目管理器中，`开启uts调试(swift)`打断点调试即可。
+
+
+:::tip Tips
+- 如果原生工程的源码文件有变更，需要在Xcode中重新编译、运行项目后才会生效。
+- 调试原生工程时，在Xcode中重新运行项目，需要在HBuilderX中重新开启调试服务。
+:::

package/data/uni-app-x-docs/native/download/android.md

@@ -0,0 +1,132 @@
+# uni-app x Android原生SDK
+
+## 说明
+
+- 从HBuilderX 4.81-alpha版开始，为了适配Kotlin版本，对gradle插件做了升级，升级SDK时需要替换原有插件。插件配置及说明参考[文档](../use/android.md#gradleplugin)。
+
+注意：蒸汽模式的离线sdk需 uni-app x 5.25+
+
+## 正式版
+
+### 5.26.2026091802
+
+**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101163-5.26.zip)**
+
+**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15075-5.26.zip)**
+
+* 更新uni-app离线打包支持，需使用HBuilderX（5.26.2026091802）版本生成本地打包App资源。
+* 新增 API uni.onAppRoute、uni.onBeforeAppRoute、uni.rewriteRoute 支持页面路由监听及重写 [文档](https://doc.dcloud.net.cn/uni-app-x/api/app-route.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31599>
+* 变更 组件 rich-text 使用 user-select 属性替代 selectable [文档](https://doc.dcloud.net.cn/uni-app-x/component/rich-text.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31518>
+* 优化 API uni.showLoading 调整背景透明度与消息提示框相同 [文档](https://doc.dcloud.net.cn/uni-app-x/api/loading.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31614>
+* 蒸汽模式 新增 组件 表单相关组件适配暗黑模式 [文档](https://doc.dcloud.net.cn/uni-app-x/component/switch.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31289>
+* 修复 编译器 蒸汽模式下独立 .ts 文件中调用支持摇树的 uni API 时，云打包后的基座提示缺少对应模块 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32167)
+* 优化 API uni.createVideoContext playbackRate 设置播放倍速的取值范围 [文档](https://doc.dcloud.net.cn/uni-app-x/api/create-video-context.html#playbackrate) <https://issues.dcloud.net.cn/pages/issues/detail?id=32253>
+* 修复 组件 video 点击进度条跳转后 controls 自动隐藏定时器未重置 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31671)
+* 新增 API 广告 美数渠道 [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-ad) <https://issues.dcloud.net.cn/pages/issues/detail?id=32000>
+* 新增 API uni.requestSystemPermission 主动申请系统权限 [文档](https://doc.dcloud.net.cn/uni-app-x/api/request-system-permission.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31823>
+* 新增 发行 云打包支持自适应图标 [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-android.html#adaptiveicon) <https://issues.dcloud.net.cn/pages/issues/detail?id=29277>
+* 优化 API push 申请系统通知权限逻辑 [文档](https://doc.dcloud.net.cn/uni-app-x/api/uni-push.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31815>
+* 修复 组件 view dialogPage 中 view 全屏后和 dialogPage 显示重叠 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31990)
+* 修复 组件 video 在 dialogPage 中不显示播放控制按钮 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31916)
+* 修复 组件 video 在 dialogPage 中无法退出全屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32066)
+* 蒸汽模式、VDOM模式 修复 组件 input maxlength 属性支持字符串类型 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31799)
+* 蒸汽模式 新增 vue 内置组件Teleport [文档](https://doc.dcloud.net.cn/uni-app-x/vue/built-in.html#teleport) <https://issues.dcloud.net.cn/pages/issues/detail?id=30782>
+* 蒸汽模式 新增 pages.json 支持配置页面滚动相关属性 enableBackToTop、bounces、androidOverscroll [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32082>
+* 蒸汽模式 新增 组件 list-view 支持scroll-into-view跳转到item、header或section [文档](https://doc.dcloud.net.cn/uni-app-x/component/list-view.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31678>
+* 蒸汽模式 新增 组件 list-view 支持滚动锚定特性 [文档](https://doc.dcloud.net.cn/uni-app-x/component/list-view.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31833>
+* 蒸汽模式 新增 组件 list-view 支持默认显示到底部 [文档](https://doc.dcloud.net.cn/uni-app-x/component/list-view.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32464>
+* 蒸汽模式 新增 组件 waterflow 支持通过scroll-into-view跳转到flow-item [文档](https://doc.dcloud.net.cn/uni-app-x/component/waterflow.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31974>
+* 蒸汽模式 新增 组件 web-view 支持 associative-container 属性 [文档](https://doc.dcloud.net.cn/uni-app-x/component/web-view.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32177>
+* 蒸汽模式 新增 CSS @media prefers-color-scheme 媒体查询，方便适配暗黑 [文档](https://doc.dcloud.net.cn/uni-app-x/css/common/at-rules.html#media) <https://issues.dcloud.net.cn/pages/issues/detail?id=31052>
+* 蒸汽模式 新增 CSS 支持 direction 属性 设置文本方向 [文档](https://doc.dcloud.net.cn/uni-app-x/css/direction.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31692>
+* 蒸汽模式 新增 CSS text-align 支持 justify 设置文字向两侧对齐 [文档](https://doc.dcloud.net.cn/uni-app-x/css/text-align.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31601>
+* 蒸汽模式 新增 CSS backdrop-filter 属性 实现毛玻璃效果 [文档](https://doc.dcloud.net.cn/uni-app-x/css/backdrop-filter.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31677>
+* 蒸汽模式 新增 scheme启动及获取参数，可实现直达 [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/app.html#%E5%8F%82%E6%95%B0-2) <https://issues.dcloud.net.cn/pages/issues/detail?id=32465> <https://issues.dcloud.net.cn/pages/issues/detail?id=32459> <https://issues.dcloud.net.cn/pages/issues/detail?id=31788>
+* 蒸汽模式 新增 devTools 支持元素、网络、存储审查 [文档](https://doc.dcloud.net.cn/uni-app-x/tutorial/debug/devtools.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=31885>
+* 蒸汽模式 新增 离线原生 SDK 集成 [文档](https://doc.dcloud.net.cn/uni-app-x/native/) <https://issues.dcloud.net.cn/pages/issues/detail?id=32417>
+* 蒸汽模式 新增 uni统计2.0 [文档](https://uniapp.dcloud.net.cn/uni-stat-public.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32445>
+* 蒸汽模式 修复 组件 swiper 大小发生变化后没有自动计算布局 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32051)
+* 蒸汽模式 修复 组件 list-view 部分情况下记录的sticky-section顺序异常导致界面错乱 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31835)
+* 蒸汽模式 修复 组件 list-view 清空list-item时占位高度没消失 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31892)
+* 蒸汽模式 修复 组件 list-view 追加数据后视口出现空白，滚动后恢复 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32156)
+* 蒸汽模式 修复 组件 text 嵌套子text上使用不支持的样式时编译报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31722)
+* 蒸汽模式 修复 组件 scroll-view 容器或内容变化引发的滚动不会触发scrollend事件 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32611)
+* 蒸汽模式 修复 组件 list-view list-item高度变成0时未重排后续item位置 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32592)
+* 蒸汽模式 修复 组件 list-view initial-scroll-bottom属性部分情况下未将初始位置滚动到底部 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32614)
+* 蒸汽模式 修复 组件 list-view 滚动期间及滚动结束瞬间概率出现闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32910)
+* 蒸汽模式 修复 组件 list-view 开启 scroll-anchoring 后追加消息可能出现白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32913)
+* 蒸汽模式 修复 CSS useComputedStyle 支持 css 变量。同时基于useComputedStyle的input、textarea、loading也支持了css变量 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31606)
+* 蒸汽模式 修复 CSS 变量的 !important 不生效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31626)
+* 蒸汽模式 修复 组件 canvas lineDashOffset值超过50就不会有变化 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32144)
+* 蒸汽模式 修复 组件 canvas 性能优化 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32285)
+* 蒸汽模式 优化 框架快照化以提升应用启动速度 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32284)
+* 蒸汽模式 优化 so 库导出符号表以减少安装包大小 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32290)
+* 蒸汽模式 新增 组件 scroll-view 支持 android-refresher-color 属性设置下拉刷新雪花前景颜色 [文档](https://doc.dcloud.net.cn/uni-app-x/component/scroll-view.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32104>
+* 蒸汽模式 修复 vue 动态插槽中包含组件时编译失败 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32103)
+* 蒸汽模式 修复 组件 text 嵌套 text 上使用 v-if 或 v-for 时可能无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32539)
+* 蒸汽模式 修复 组件 rich-text 设置 translateY 后可能内容显示不完整 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32820)
+* 蒸汽模式 修复 组件 image 没有设置 fade-show 加载网络图片首次显示会有渐变动画效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32762)
+* 蒸汽模式 修复 组件 Click 事件 中调用 uni.closeDialogPage 引起应用崩溃 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32504)
+* 蒸汽模式 修复 组件 view 元素设置为拍平后，非拍平的子元素显示位置可能不正常 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32469)
+* 蒸汽模式 修复 组件 scroll-view direction设置为 all 时上下滑动可能与父的 bounces 效果冲突 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32237)
+* 蒸汽模式 修复 组件 rich-text mode 为 native 流式绘制列表加载闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=30729)
+* 蒸汽模式 修复 组件 rich-text mode 为 native 流式绘制表格、代码块时闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32426)
+* 蒸汽模式 修复 组件 native-view 动态添加原生子 View 可能无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31372)
+* 蒸汽模式 修复 组件 native-view 截图如果页面存在拍平元素可能报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31818)
+* 蒸汽模式 修复 组件 native-view 设置 fixed 定位后无法通过 v-if 删除 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32208)
+* 蒸汽模式 修复 组件 input 去掉拼写检查的红色下划线 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31724)
+* 蒸汽模式 修复 组件 input 设置padding时，下沿被裁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32017)
+* 蒸汽模式 修复 组件 input 自动聚焦时，光标位置错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32295)
+* 蒸汽模式 修复 组件 video 在 list-view 中快速滚动 src 设置错乱 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32457)
+* 蒸汽模式 修复 组件 canvas createImage 无法共用 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31588)
+* 蒸汽模式 修复 组件 canvas 2D fillStyle 设置 rgba 透明度（alpha）无效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32186)
+* 蒸汽模式 修复 API uni.exit 执行 redirectTo 后可能无法正常退出显示白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32768)
+* 蒸汽模式 修复 API uni.previewImage 当图片格式为SVG时会变形 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31653)
+* 蒸汽模式 修复 API uni.showModal 成功回调内调用 navigateBack 崩溃 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31922)
+* 蒸汽模式 修复 CSS overflow 安卓蒸汽模式 某些场景，定位层中的滚动组件无法滚动 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31290)
+* 蒸汽模式 修复 CSS border border-bottom、border-right 某些情况可能被子元素覆盖 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32513)
+* 蒸汽模式 修复 CSS transition 多元素执行transition时不同步导致闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31454)
+* 蒸汽模式 修复 CSS transition 无单位长度值参与 transition 时，动画目标值被错误归零 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31761)
+* 蒸汽模式 修复 CSS transform transition 动画未结束时设置新 transform 值不生效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32507)
+* 蒸汽模式 修复 UniPage API 部分设备 pageBody 取值不正确 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32036)
+* 蒸汽模式 修复 DOM API UniElement 关闭页面时可能引起应用崩溃 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31739&ask_id=31971)
+* 新增 uni-ui x uni-tab 支持毛玻璃效果 [文档](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/uni-tab.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32439>
+* 新增 uni-ai x 适配蒸汽模式，高性能的AI流式聊天 [文档](https://doc.dcloud.net.cn/uniCloud/uni-ai-x.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32450>
+* 蒸汽模式 优化 uts插件通道通信性能 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31458)
+* 蒸汽模式 新增 UTSAndroid.destroyInstance 注销JS层引用的原生对象 [文档](https://doc.dcloud.net.cn/uni-app-x/uts/utsandroid.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32198>
+* 蒸汽模式 修复 uts插件向JS返回数据对象时，部分数据为空值 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31986)
+* 蒸汽模式 修复 字面量.toFloat方式声明的变量被编译为了Number类型 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32906)
+
+**[历史版本](https://pan.baidu.com/s/1M6XHzokpQYJqfICTzjuQ_g?pwd=93yh)**
+ 
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091802.html)**
+
+## alpha版
+
+### 5.26.2026091402-alpha
+
+**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101163-5.26.zip)**
+
+**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15075-5.26.zip)**
+
+* 更新uni-app离线打包支持，需使用HBuilderX（5.26.2026091402-alpha）版本生成本地打包App资源。
+* 蒸汽模式 修复 组件 scroll-view 容器或内容变化引发的滚动不会触发scrollend事件 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32611)
+* 蒸汽模式 修复 组件 list-view list-item高度变成0时未重排后续item位置 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32592)
+* 蒸汽模式 修复 组件 list-view initial-scroll-bottom属性部分情况下未将初始位置滚动到底部 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32614)
+* 蒸汽模式 修复 组件 list-view 滚动期间及滚动结束瞬间概率出现闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32910)
+* 蒸汽模式 修复 组件 list-view 开启 scroll-anchoring 后追加消息可能出现白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32913)
+* 蒸汽模式 修复 组件 text 嵌套 text 上使用 v-if 或 v-for 时可能无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32539)
+* 蒸汽模式 修复 组件 rich-text 设置 translateY 后可能内容显示不完整 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32820)
+* 蒸汽模式 修复 5.25版本引发的 组件 rich-text 页面滚动到页面上边缘偶现闪白 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32911)
+* 蒸汽模式 修复 组件 image 没有设置 fade-show 加载网络图片首次显示会有渐变动画效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32762)
+* 蒸汽模式 修复 5.25版本引发的 组件 画布 2D 绘制指令全部执行成功但画布始终空白不上屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32730)
+* 蒸汽模式 修复 API uni.exit 执行 redirectTo 后可能无法正常退出显示白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32768)
+* 蒸汽模式 修复 5.25版本引发的 API uni.getUniVerifyManager 调用报 `parameters length error` 错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32757)
+### uts插件
+* 蒸汽模式 修复 字面量.toFloat方式声明的变量被编译为了Number类型 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32906)
+* 蒸汽模式 修复 5.25版本引发的 uts插件导出的常量不能被页面组件引用 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32903)
+* 蒸汽模式 修复 5.25版本引发的 暴露给页面组件调用的class上含可为空的function类型属性时编译报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32624)
+
+**[历史版本](https://pan.baidu.com/s/1OXvFjfGW6zDAyzTZGpY7hQ?pwd=aa2c)**
+ 
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091402-alpha.html)**

package/data/uni-app-x-docs/native/download/ios.md

@@ -0,0 +1,32 @@
+# uni-app x iOS原生SDK
+
+## 正式版
+
+注意：蒸汽模式的 SDK 需 uni-app x 5.25+
+
+### 5.26.2026091802
+
+[点击下载蒸汽模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS-Vapor/UniAppXSDK-iOS-Vapor@5.26.zip)
+
+[点击下载 VDOM 模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS/UniAppX-iOS%405.26.zip)
+
++ [更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091802.html)
+
+**[历史版本](https://pan.baidu.com/s/1PVLzui3QRkG5brzTxSYJlg?pwd=amqt)**
+ 
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.23.2026080313-alpha.html)**
+
+## alpha版
+
+### 5.26.2026091402-alpha
+
+[点击下载蒸汽模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS-Vapor/UniAppXSDK-iOS-Vapor@5.26.zip)
+
+[点击下载 VDOM 模式SDK-5.26](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/iOS/UniAppX-iOS%405.26.zip)
+
++ [更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091402-alpha.html)
+
+
+**[历史版本](https://pan.baidu.com/s/130Rvlh2jdsp3aJ4YtigoJQ?pwd=xy7s)**
+ 
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.25.2026082902-alpha.html)**