tmui-cli 2.0.3 → 2.0.4

package/data/uniappx/project.md

@@ -0,0 +1,149 @@
+# uni-app x项目
+
+## 新建
+
+首先需下载最新版[HBuilder](https://www.dcloud.io/hbuilderx.html)
+
+在菜单文件>新建>项目中，选择新建uni-app项目。（或工具链左上角的新建快捷菜单，或者快捷键Ctrl+N）
+
+可以选择空项目，也可以选择hello uni-app x示例项目，这个项目有几百个页面，演示了uni-app x的各种组件和API的用法。
+
+注意这里区分uni-app和uni-app x项目，在该界面的底部有一个checkbox：uni-app x。**勾选后**会新建为uni-app x项目。
+
+不要错选成uni-app！
+
+uni-app x只支持vue3，无法勾选vue2。
+
+uni-app x的项目，manifest.json中会多一个节点`"uni-app-x" : {}`。这是HBuilder识别项目类型的标记。如手动增删这个节点，需对项目点右键"重新识别项目类型"
+```json
+{
+    "name" : "hello-uniapp x",
+    "appid" : "__UNI__4517034",
+    "description" : "",
+    "versionName" : "1.0.0",
+    "versionCode" : "100",
+    "uni-app-x" : {
+    }
+}
+```
+
+uni-app x的项目，在左侧项目管理器的图标是圆形的U（之前是方型的U）。
+
+## 项目结构
+
+uni-app x的项目结构与[uni-app老版的项目结构](https://uniapp.dcloud.net.cn/tutorial/project.html)基本一致。
+
+主要的差别是没有nativeplugins目录。原因是uni-app x不支持App原生语言插件，仅支持uts插件。
+
+基于uts的插件，可以在uni-app x和uni-app上通用。
+
+<pre v-pre="" data-lang="">
+	<code class="lang-" style="padding:0">
+┌─uniCloud              云空间目录，支付宝小程序云为uniCloud-alipay，阿里云为uniCloud-aliyun，腾讯云为uniCloud-tcb（详见<a href="https://doc.dcloud.net.cn/uniCloud/quickstart?structure&id=structure">uniCloud</a>）
+│─components            符合vue组件规范的uni-app x组件目录
+│  └─comp-a.vue         可复用的a组件
+├─utssdk                存放uts文件（已废弃）
+├─pages                 业务页面文件存放的目录
+│  ├─index
+│  │  └─index.uvue      index页面
+│  └─list
+│     └─list.uvue       list页面
+├─static                存放应用引用的本地静态资源（如图片、字体、音视频等）的目录，<b>注意：</b>静态资源都应存放于此目录  <a href="https://doc.dcloud.net.cn/uni-app-x/compiler/#static">详见</a>
+├─uni_modules           存放uni_module <a href="https://uniapp.dcloud.net.cn/plugin/uni_modules.html">详见</a>
+├─platforms             存放各平台专用页面的目录，<a href="https://uniapp.dcloud.net.cn/tutorial/platform.html#preprocessor">详见</a>
+├─nativeResources       App端原生资源目录
+│  ├─android            Android原生资源目录 <a href="https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android">详见</a>
+|  └─ios                iOS原生资源目录 <a href="https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#%E8%B5%84%E6%BA%90%E6%96%87%E4%BB%B6-bundle-resources">详见</a>
+├─harmonyConfig         HarmonyOS 端原生资源目录 <a href="https://uniapp.dcloud.net.cn/tutorial/harmony/runbuild.html#config-dir">详见</a>
+├─hybrid                App端存放web-view组件使用的本地html文件的目录，<a href="./component/web-view">详见</a>
+├─wxcomponents          微信小程序平台wxml组件专用目录
+├─unpackage             非工程代码，一般存放运行或发行的编译结果、App自定义基座。默认应配置git忽略
+├─main.uts              Vue初始化入口文件
+├─App.uvue              应用配置，用来配置App全局样式以及监听 <a href="./collocation/App#应用生命周期">详见</a>
+├─pages.json            配置页面路由、导航条、选项卡等页面类信息，<a href="./collocation/pages">详见</a>
+├─manifest.json         配置应用名称、appid、logo、版本等打包信息，<a href="./collocation/manifest">详见</a>
+├─AndroidManifest.xml   Android原生应用清单文件 <a href="https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android">详见</a>
+├─Info.plist            iOS原生应用配置文件 <a href="https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios">详见</a>
+└─uni.scss              内置的常用样式变量
+	</code>
+</pre>
+
+> 当使用cursor等ai工具开发uni-app x时，可以在项目下放置.cursor目录，帮助AI更好的生成uni-app x代码。[链接](https://github.com/dcloudio/uni-app-x-ai-rules)
+
+## 运行时的UniApp实例
+
+每个uni-app x应用启动，会有一个UniApp实例，通过全局API `getApp()` 获取。
+
+UniApp上有应用级的方法和属性。[详见](./api/get-app.md)
+
+## 运行
+
+新建项目后，可以直接点顶部菜单或工具栏运行，选择要运行的目标平台。
+
+在HBuilder中，有顶部菜单、toolbar运行按钮、快捷键三种运行入口。
+
+1. 顶部运行菜单
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/menurun.png)
+
+2. toolbar工具栏上的运行按钮
+
+![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/toolbarrun.png)
+
+	toolbar的运行按钮点击后会展开一个菜单。这个菜单可配置，通过`自定义菜单`将不常用的运行项目折叠起来。
+
+3. 快捷键
+
+	运行快捷键是【Ctrl+r】
+
+	弹出的菜单还支持键盘快捷选择：按回车可以选中菜单的第一项；windows下按数字可以快捷选中菜单项开头数字对应的菜单项。
+
+如果不能看到相关菜单，那么HBuilder当前打开的文件可能不是uni-app x项目下的文件。
+
+运行到不同平台，需要不同平台的运行环境，比如安装浏览器、安装小程序模拟器、安装手机模拟器或电脑端插入真机。
+
+根据提示安装运行环境，并注意观察控制台的日志。
+
+在控制台的右上角，点击红色虫子可以开启debug调试。详见左侧的运行和调试章节。
+
+### 运行到App
+
+uni-app x在运行到Android和iOS时，提供了真机运行基座（playground），该基座安装到手机后，可以把开发者编写代码同步到手机上运行在这个基座上。
+并实现修改代码后热刷新，在手机上及时看到效果。
+
+运行到鸿蒙时，没有基座概念，直接调用本地的deveco出包。当然也就不支持热刷新了。
+
+Android和iOS上的基座有标准基座和自定义基座的概念。
+
+和 uni-app/5+App/wap2app 的基座不同，uni-app x的标准基座是一个绿色圆形的U（之前是方型H），基座名称默认为`uni-app x`（之前叫HBuilder）。
+
+- uni-app x基座，只能运行uni-app x项目，包名是io.dcloud.uniappx
+- HBuilder基座，可以运行uni-app/5+App/wap2app。包名是io.dcloud.HBuilder
+
+标准基座使用的图标、包名、证书以及配置的三方sdk的appkey等各种原生信息，都是DCloud的。[详见](./tutorial/app-playground.md)
+
+当需要使用自己的包名、证书、原生配置以及变更三方原生sdk时，需在打包界面勾选打包自定义基座，打包后的自定义基座会放置在项目的unpackage目录下，然后在运行项目时的界面中可以选择自定义基座来运行。
+
+uni-app x运行时，默认仅显示开发者代码和uni-app x框架的输出日志，在控制台右上角还可以选择开启原生日志。
+
+### 运行到web
+
+uni-app x运行到浏览器时，编译基于vite，其特点是按需编译。所以项目运行后很快能看到首页，但后续仍然在编译其他页面直到项目编译完成。
+
+如果后续页面有报错，就会在控制台看到输出。即便这个页面并未打开。
+
+## 发行
+
+选中要发行的项目，点顶部菜单发行（或者对项目点右键，或者快捷键Ctrl+U），选择要发行的目标平台。
+
+所有平台的都支持本地发行，同时依赖本地安装的发布环境。在菜单或弹出界面上有相应的教程链接。
+
+如果发布Android和iOS应用，HBuilder还额外提供了方便的云打包，免去安装和配置原生环境，直接出apk、ipa包。[详见](./tutorial/app-package.md)
+
+除了在菜单里点击发布，也可以通过HBuilderX的cli，实现持续集成和自动发布。[详见](https://hx.dcloud.net.cn/cli/README)
+
+如果你不希望直接发布成品应用，而希望发布成其他应用的一部分，那么
+- App平台：需参考[uni-app x 原生SDK文档](./native/README.md)，把uni-app x项目发布为kt、swift源码，集成到自己的原生项目中。
+- 小程序平台：可发布为分包，成为其他小程序的一个分包。[详见](https://uniapp.dcloud.net.cn/hybrid.html)
+
+如果你已经拥有了非uni-app x的成型应用，想要渐进式的引入uni-app x，那么上面的方案非常合适。可以用uni-app x开发部分页面，集成到原来的项目中。

package/data/uniappx/readme.md

@@ -0,0 +1,381 @@
+# uni-app x 是什么？<Badge text="HBuilderX 3.9+"/>
+
+uni-app x，是下一代 uni-app，是一个基于vue、js/ts/uts、css和原生渲染的跨平台开发框架。
+
+uni-app x 四年磨一剑，在2026年推出[蒸汽模式](./app-vapor.md)后，终于实现了跨平台框架的终极愿景：即跨平台，又做到了比原生更快的渲染速度。见[性能对比](#pk)
+
+可以体验打包后的[hello uni-app x](https://hellouniappx.dcloud.net.cn)，访问地址或扫描二维码后获取：
+
+开发一次，即可编译到 Android、iOS、鸿蒙、web、微信小程序、支付宝小程序。
+  
+<div>
+	<a
+		href="https://hellouniappx.dcloud.net.cn" target="_blank"
+		style="display: flex; align-items: center;flex-direction: column;margin: 0 5px 20px;width:160px;"
+	>
+		
+		<b>hello uni-app x</b>
+	</a>
+</div>
+
+::: tip
+hello uni-app x 的源码见：[https://gitcode.com/dcloud/hello-uni-app-x](https://gitcode.com/dcloud/hello-uni-app-x)
+
+## 性能对比@pk
+
+以渲染4050个view和text的测试例为例，需在同一屏幕内渲染，在不同平台原生的耗时和`uni-app x蒸汽模式`的耗时如下：
+
+|平台		|原生		|uni-app x|差距倍数	|对比视频																																									|
+|--			|--			|--				|--				|--																																												|
+|Android|505		|273			|1.85倍		|[https://www.bilibili.com/video/BV17VuG6sExP](https://www.bilibili.com/video/BV17VuG6sExP)|
+|iOS		|325.76	|167			|1.95倍		|[https://www.bilibili.com/video/BV1ApMt66Eez](https://www.bilibili.com/video/BV1ApMt66Eez)|
+|鸿蒙		|804		|267			|3倍			|[https://www.bilibili.com/video/BV1RpPQzAEDS](https://www.bilibili.com/video/BV1RpPQzAEDS)|
+
+表格数据为耗时，单位为ms。
+
+- Android测试设备：小米Fold4(Android16)
+- iOS测试设备：iPhoneSE(iOS26.5)
+- 鸿蒙测试设备：鸿蒙nova12(api21)
+
+可见，uni-app x蒸汽模式，在每个平台，均比原生渲染快2、3倍。
+
+**重现方式：**
+
+- uni-app x 的源码：[https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/template/4050/4050.uvue](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/template/4050/4050.uvue)。上方二维码显示的[ hello uni-app x 下载页面](http://hellouniappx.dcloud.net.cn/)可下载编译后的体验包。
+- Android原生源码：[https://gitcode.com/dcloud/test4050-android](https://gitcode.com/dcloud/test4050-android)。仓库下有编译好的apk可直接体验。
+- iOS原生源码：[https://gitcode.com/dcloud/test4050-ios](https://gitcode.com/dcloud/test4050-ios)，开发者可以自行编译。
+- 鸿蒙原生源码：[https://gitcode.com/dcloud/test4050-harmony-arkui](https://gitcode.com/dcloud/test4050-harmony-arkui)，开发者可以自行编译。
+
+本文为 uni-app x 简介，并非详细评测报告，更多内容，包括Compose UI、Swift UI等更多技术方案的对比，包括如何公平测试，包括长列表、富文本、canvas等更多组件的性能测试，详见专业的benchmark：
+- [Android benchmark](./benchmark/vapor-benchmark-android.md)
+- [iOS benchmark](./benchmark/vapor-benchmark-ios.md)
+- [鸿蒙benchmark](./benchmark/vapor-benchmark-harmony.md)
+
+## VDOM模式和蒸汽模式
+
+uni-app x 的第一代是VDOM模式，该模式的编程语言是uts，一种可以编译为kotlin、Swift、ets、js的跨平台强类型语言。
+* `web/小程序`平台，编译为JavaScript
+* `Android`平台，编译为Kotlin
+* `iOS`平台，编译Swift
+* `鸿蒙next`平台，编译为ArkTS
+
+虽然跨语言调用障碍抹平，但由于VDOM的存在以及渲染引擎不够强大，实际渲染速度比原生慢。
+
+2026年，uni-app x 推出了新一代的[蒸汽模式](./app-vapor.md)，由于新版的渲染引擎性能远超原生数倍，改成js也还是快于原生数倍。
+考虑到AI熟悉度、易用性、生态、动态化、以及老uni用户的升级，在蒸汽模式下改用普通的ts/js。
+
+如果写成uts，Android和iOS也会通过uts2js运行在js引擎上。鸿蒙目前运行在arkts引擎上，未来为了热更新，也会提供运行在js引擎上的选项。
+
+在蒸汽模式后，uts语言的主要作用是开发uts原生插件。仅uts插件（utssdk目录）继续保留uts向kotlin、Swift、ets的编译能力。
+
+也就是uni-app x 蒸汽模式，不依赖uts的原生编译能力，拥有js的动态性、拥有非常强的AI友好度，渲染性能又超过原生。
+
+从2026年起，新的[蒸汽模式](./app-vapor.md)将逐渐替代老的VDOM模式。
+- harmonyOS版于5.0上线
+- iOS版于5.11上线
+- Android版于5.21上线
+
+## 开发技术
+
+开发者使用vue + js/ts + css(子集) 来开发 uni-app x 蒸汽模式。
+
+与uni-app相比，无需新学习任何编程语言或框架。仅需注意在uni-app x 的app平台，由于使用的是原生渲染，其支持的css是web css的子集。
+
+如果您是新手，也可以通过[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)来完成应用开发，AI对 uni-app x 蒸汽模式的开发非常友好。
+
+一个典型的 uni-app x 的 uvue页面例子：
+
+```html
+<template>
+	<view class="content">
+		<button @click="buttonClick">{{title}}</button>
+	</view>
+</template>
+
+<style>
+	.content {
+		flex: 1;
+		background-color: white;
+	}
+</style>
+
+```
+
+### uni的组件 @uni-components
+
+uni-app x 支持的组件包括：
+- `内置基础组件`：与uni-app和小程序相同，如view、text、image、scroll-view、input...等，详见[组件清单](./component/README.md)
+- `自定义uvue组件`：使用内置组件和vue组件技术进行封装的组件，支持easycom。
+- `uts原生组件插件`：用于原生sdk的ui以组件的方式嵌入。
+
+> 除了微信小程序，其他端不支持小程序wxml组件。
+
+很多内置组件，也是开源的uvue组件，在每个组件文档右上角可以点击源码仓库链接查看。
+
+更多组件介绍，[详见](./component/README.md)
+
+## API @uni-api
+
+uni-app x 支持的API包括：
+
+1. js的内置API
+2. 全局API，前面不需要加`uni.`。如[getApp](./api/get-app.md)、[getCurrentPages](./api/get-current-pages.md)
+3. uni.xxx的内置API。数量较多，[详见](./api/README.md)
+4. uniCloud.xxx的内置API。[详见](./api/unicloud/README.md)
+5. dom的API [详见](./api/dom/README.md)
+6. 原生API
+
+uni-app x 不会限制任何原生API的调用，在每个平台都可以调用其平台所有原生能力：
+- web平台：可调用浏览器的所有api，可混合使用js，可使用web生态的各种库，包括npm。
+- 小程序平台：可调用小程序的所有api，可混合使用js，小程序的自定义组件生态（如wxml组件），包括支持小程序的npm库。
+- Android平台：可调用Android os的所有api，可混合使用kotlin、java源码，可使用所有适配Android的sdk，包括so库，可使用gradle等仓储。
+- iOS平台：可调用iOS的所有api，可混合使用swift，可使用所有适配iOS的sdk，包括动态库静态库，可使用cocoaPods库管理
+- Harmony平台：可调用鸿蒙的所有api，可混合使用ArkTS，可使用所有适配鸿蒙的sdk，包括so库，可使用ohpm库管理。
+
+uni.的api，大多是uts开发的，在每个API文档右上角可以点击源码仓库链接查看。
+
+插件市场也有很多做好的uts插件，方便开发者拿来即用。[uts插件](https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate)
+
+老uni-app，支持 plus API 和 weex API。但 uni-app x 中，不再支持这些API。
+
+更多API介绍，[详见](./api/README.md)
+
+## CSS @css
+
+uni-app x 在web和小程序，支持完成的浏览器css，在app平台，由于是原生渲染，支持的css的子集。
+
+主要差异包括：
+- 使用flex布局，且默认方向为竖向
+- 文字必须写在text组件内且样式不支持继承
+
+其他差异详见 [css文档](./css/README.md)
+
+## 插件生态@plugin
+
+uni-app x 的插件生态，以uni_modules为主。这是一种面向全端的、统一的插件管理方案。
+
+它容纳支持各种平台的原生库管理方案，包括npm、Android仓储、iOS Swift PM、CocoaPods、鸿蒙ohpm。
+
+可以引入web和原生的各种生态库。
+
+如果不开发原生插件，仅使用纯js库，在蒸汽模式下，npm上众多库也可以直接在App平台使用，比如vue-pinia、day.js等。而vdom模式则需要uts适配库才能在App平台使用。
+
+但需注意小程序和App平台不支持window等api，对dom api的支持也有限。详见[DOM API](./api/dom/README.md)。所以尽量选用那些适配小程序的NPM库，比如[echarts-for-weixin](https://echarts.apache.org/handbook/zh/how-to/cross-platform/wechat-app/)
+
+[uni插件市场](https://ext.dcloud.net.cn/)是跨端插件的聚集地，前端插件可以去npm找，但原生插件更推荐在这里找。
+
+uni-app x 的插件生态，基于[uts插件](./plugin/uts-plugin.md)。这是一种面向全端的、统一的插件管理方案。
+
+目前已经有数千款插件支持 uni-app x，它们发布在[uni插件市场](https://ext.dcloud.net.cn/?uni-appx=1)
+
+uts插件通过统一的interface，约束了所有平台的API的输入输出，甚至错误码，保障了跨平台调用的一致性。
+
+uts插件有多种开发方式：
+1. 可以使用uts语言直接调用系统API来封装插件
+比如[电量插件](https://gitcode.com/dcloud/uni-api/tree/master/uni_modules/uni-getbatteryinfo/utssdk)，在每个平台都是uts代码，但统一了interface。
+2. 可以原生混编
+在不同平台，直接用uts调用平台原生代码，比如Android的kt文件、iOS的swift文件、鸿蒙的ets文件。同样使用一套interface约束。\
+比如[音频播放插件](https://gitcode.com/dcloud/uni-api/tree/dev/uni_modules/uni-createInnerAudioContext)，在Android上使用了kt混编，iOS使用了swift混编，复用现成的原生代码，快速封装插件。
+3. 调用三方sdk并引入库管理
+uts插件是一个大一统的插件模型，其中在不同的子平台可以包含不同平台的库管理方案，不管是aar、so、framework、har都可以使用
+	- web平台和小程序平台，以及跨端的js库，支持npm
+	- Android平台支持gradle等仓储
+	- iOS平台支持cocoaPods和Swift PM
+	- Harmony平台支持ohpm
+
+如果你只是使用插件，那么访问插件市场，勾选`uni-app x`的checkbox就能找到所需插件。
+
+如果你想开发uts插件，[参考插件开发教程](./plugin/uts-plugin.md)。
+
+推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)来开发uts原生插件，它可以做到不懂原生的前端开发者开发出uts原生插件。
+
+### 推荐的优秀插件
+
+基于uni-app x的纯前端组件，比如ui库，这里推荐一些：
+- [uni-ui x](./component/uni-ui-x/README.md)：官方UI库。它的设计规范与uni ui有差别，是为uni-app x重新设计的更好的ui库。兼容[蒸汽模式](https://doc.dcloud.net.cn/uni-app-x/app-vapor.html)、使用样式隔离策略2.0
+- [lime-UI Vapor](https://ext.dcloud.net.cn/plugin?id=28915)：即兼容uni-app又兼容uni-app x蒸汽模式。2025插件大赛一等奖。
+- [RiceUI](https://ext.dcloud.net.cn/plugin?id=24907)：支持蒸汽模式，全端组合式UI库。
+- [TuiPlus Vapor](https://ext.dcloud.net.cn/plugin?id=28497)：支持蒸汽模式，支持css原子化。
+- [TMUI4.0](https://ext.dcloud.net.cn/plugin?id=16369)：VDOM模式高品质UI库，2023插件大赛一等奖。
+
+## 开放性
+
+uni-app x 的组件和API基本都开源，个别未开源部分也会在接下来陆续完成开源。
+
+在 uni-app x 的每个组件和API的文档中，都有该API具体实现的源码github和gitcode链接（文档右侧）。比如[uni.showModal](https://doc.dcloud.net.cn/uni-app-x/api/modal.html)
+
+开发者可以审查这些源码的合理性，也可以在遇到官方bug时，自行拉源码修复。\
+uni-app x 支持单独的组件和API替换，将源码的`uni_modules`下载到工程下，修改源码后打包即可将官方实现自动替换为你修改的实现。
+
+uni-app x 的Web版、小程序版的主引擎有单独开源地址：[https://github.com/dcloudio/uni-app](https://github.com/dcloudio/uni-app)
+
+uni-app x 的所有可视元素，都没有写死样式和文字，开发者可以自己定制风格和国际化。
+
+开发者编写的代码，编译后的产物代码都在项目的unpackage目录下。\
+开发者可以看到实际生成的js、kt、swift、ets代码是什么样的，无需担心埋入不合适的代码。\
+开发者可以自行把这些编译产物引入自己的原生工程中，自行打包。这些都是开放的。
+
+uni-app x 引擎仅在引擎崩溃时有数据收集以用于产品改进，且不采集任何《个人信息保护法》涉及的个人隐私数据。详见[隐私协议](https://dcloud.io/license/appprivacy.html)
+
+如大型开发者需要提前获取 uni-app x 的未开源部分，可以联系：service@dcloud.io
+
+## 路线图
+
+uni-app x 在2026年会陆续完成
+- app热更新
+- web平台蒸汽模式
+- 支付宝小程序、抖音小程序
+
+其他计划，将根据社区的反馈意见来排优先级。
+
+欢迎去[需求墙](https://vote.dcloud.net.cn/#/?name=uni-app%20x)投票。
+
+## 案例
+[另见](./sample.md)
+
+## 质量
+
+uni-app x 从2023年起第一个版本就支持自动化测试。
+
+并且 uni-app x 坚持一个原则，修复的每个开发者报的[issues](https://issues.dcloud.net.cn/?mid=uni-app-x)，都要配套自动化测试例。
+
+数年来，uni-app x 已经积累数万个自动化测试例，包括功能、性能、UI截图对比、内存泄漏、崩溃等多种维度。
+
+uni-app x 蒸汽模式 虽然是2026年推出的，但它的发布之初，就通过了所有 uni-app x 积累的所有自动化测试例。
+
+所以 uni-app x 蒸汽模式 的质量，并不比更早推出的 uni-app x VDOM模式 差。可以明确，它的质量已达到商用标准。
+
+uni-app x 蒸汽模式还有一个特点：内部实现代码基本都是一套，都是跨平台的c或uts。所以它的平台差异很小。
+
+同时也建议开发者通过 uni-app x 提供的自动化测试框架，为自己的app编写自动化测试，以提升自己的产品质量。在AI时代，首先可以让AI协助写自动化测试例，然后在有了充足的自动化测试例之后，再让AI高效改代码，自动跑自动化测试，可以大幅提升开发效率，减少人工review的压力。
+
+uni-app (x) 的自动化测试教程详见：[https://uniapp.dcloud.net.cn/worktile/auto/quick-start.html](https://uniapp.dcloud.net.cn/worktile/auto/quick-start.html)
+
+## 历史老项目兼容指南
+
+### uni-app js版老项目迁移指南
+
+详见：[uni-app 升级 uni-app x](./uniapptox.md)
+
+### 原生/rn/flutter页面兼容指南
+
+之前已经有原生/rn/flutter页面，希望渐进式的迁移到uni-app x架构，该怎么搞？
+
+uni-app x 毕竟是原生应用，内嵌flutter、rn这些没有任何问题，包括调用其他原生写的界面也可以。把之前的页面封装为[uts插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)，云打包就可以用。
+
+插件市场已经有uts版本的[内嵌flutter插件](https://ext.dcloud.net.cn/search?q=flutter&orderBy=Relevance&cat1=8)、[内嵌compose ui插件](https://ext.dcloud.net.cn/search?q=compose+ui&orderBy=Relevance&cat1=8)
+
+而[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，也具备把原生、rn、flutter应用翻译成 uni-app x 应用的能力。
+
+至于把 uni-app x 作为一个sdk内嵌到其他原生应用中，请参考[uni-app x原生SDK](native/README.md)。
+
+## FAQ
+- AI时代，跨平台工具的价值还明显吗？\
+	AI大幅提效，削减了行业整体的开发成本。不管是原生、其他跨平台框架，还是uni，开发成本都大幅下降。\
+	由于开发成本和耗时的进一步下降，事实上催生了uni应用数量的进一步增长。\
+	但如果想交付好多端成品，使用原生技术栈时仍然需要多个平台的开发工程师各自操作AI。\
+	如果你不懂各平台原生，直接让AI写3个平台的原生代码、10个小程序平台的代码，你会很快得到一个能在主流平台跑的半成品，然后发现2个问题：AI对非主流平台不熟悉，还不如用 uni-app x 的vue方式开发；即使主流平台，从半成品变成商用成品的过程中发现不懂原生不行。\
+	AI不背锅，开发者需要背。进度延期、线上出bug，你无法甩锅给AI。只有懂AI写的代码，才能hold住，才能担起责任。
+	
+	* 在web平台，AI熟悉原生js，但大家还是用vue、react来写代码。为什么不使用原生js？因为原生js生成的代码量太多，token消耗多、以及代码越多越容易出bug，原生js还需要自己操心写不好引发性能问题。只要框架够好，还是用框架更好。
+	* 在pc平台，AI熟悉 windows 的 c#，也熟悉 macos 的 swift，但大家还是用 electron、tauri 这些 webview 渲染的跨平台框架。不是AI不会原生，是好的框架让开发者和AI更轻松。
+	
+	AI会淘汰一些简易、低质量的轮子。但复杂、高质量的轮子，永远都受欢迎。
+	
+	另外在App平台，uni-app x 还有2个相对于原生的优势：
+	1. 比原生更好的渲染性能，使用 AI + 原生也达不到 uni-app x 的流畅度。
+	2. uni-app x 毕竟是vue的声明式写法，比原生的命令式写法更简单、更高效。而原生的声明式写法不跨端且性能不佳。即使不跨端，只开发一个平台，uni-app x 都能比原生开发更快、生成代码更少、成品性能更流畅。
+
+	在AI时代，自动化测试非常重要。大量的自动化测试例，可以让AI更快的迭代。\
+	但如果使用不同平台的原生代码编写，那么自动化测试例也得分平台写。\
+	比如表单验证，如果用原生写了6、7个平台的表单代码，那么验证逻辑的自动化测试，也得用6、7个平台的原生语言各自写。众多表单项交叉组合情况很多，在不同平台可能出现各种bug。\
+	而 uni-app x 提供了统一的自动化测试方案，写好一套 test.js 脚本，可以驱动全平台做自动化测试。uni的跨平台跨的不止是业务代码，也包括质量管理的跨平台。开发商节省的不止是研发人员的人月，更包括测试人员的人月。
+
+- uni-app x 支持AI开发吗？\
+	官方提供的[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，是最佳的 uni-app x AI Coding工具。熟悉uni全线产品，熟悉uts语法、自动修复编译错误，还熟悉原生混编，可以写uts原生插件。\
+	官方的[uni-ui x](./component/uni-ui-x/README.md) 组件库，以及众多 组件（高德地图、lottie的animation-view）、API（陀螺仪、加速计、指南针、日历、通讯录...），都是使用 uni-agent 开发的。
+
+	uni-app x 蒸汽模式，由于支持普通的ts/js，使用vue、css等标准技术栈，AI非常熟悉。\
+	`uni-app`还为AI模型训练提供了强化学习工具，[详见](https://doc.dcloud.net.cn/uni-app-x/ai/cli-for-aimodel.html)。已经有大模型厂商利用该工具对 uni-app (x) 进行强化学习。
+
+- uni-app x 的技术路线稳定了吗？还会换吗？\
+	从 uni-app 到 uni-app x vdom模式，直到 uni-app x 蒸汽模式，是 DCloud 一路在追求让跨平台框架达到原生性能的梦想。\
+	如今目标已经超预期实现，不止达到、还比原生快了数倍。DCloud 没有再更换技术路线的计划。\
+	而且事实证明DCloud走出了别人未走出的最佳技术路线。\
+	uni-app x 蒸汽模式支持js后，对老uni用户的升级非常友好，而VDOM模式的uts代码也可以兼容使用。
+
+- uni-app x 的插件生态和竞品相比如何？\
+	uni-app x 支持的插件生态有较多种，[见上](#plugin)。\
+	flutter和react native的插件生态，长于国外sdk的封装。而国内、尤其是要鸿蒙和小程序，还是uni的生态更丰富。\
+	另外很多高频的功能，本身在uni-app中已经官方内置。\
+	大多数插件，只是一个桥接翻译层，在AI时代，通过 uni-agent 可以轻松的把原生SDK封装对接出来，这种较浅的插件其实意义不大，下载三方代码还不如自己用AI封装一下。
+
+- 原生已经够快了，还需要更好的渲染性能吗？\
+	当然还需要。\
+	传统应用的转场动画是300ms。\
+	但 uni-app x 推荐的转场动画是 150ms，让用户少等一半时间。如果你的服务器够快，这个时间还能更短。\
+	谁愿意多等呢？人都是用过好的就会嫌弃差的。用过retina屏幕才开始嫌弃标清屏幕；用过高刷屏就回不去普刷了。\
+	性能比更多功能更值得重视，你可能辛辛苦苦给App做了100个功能，但用户会因为10个他常用功能竞品更流畅，就流失掉。
+	
+	原生开发，并不是天然高性能，需要理解很多概念，有经验才能做好性能优化。\
+	在 AI Coding 时代，一不小心 AI 就会写出满足功能需求但降低性能的代码，还需投入经验丰富的原生工程师来review。\
+	而 uni-app x 提供了性能优秀的声明式框架，可以显著降低让应用性能优秀的人力门槛和人月代价。\
+	优秀的底层框架留给了上层“造”的空间，让业务代码可以快速生成上线，免除原生开发中投入高级原生工程师打磨性能的投入。
+
+- uni-app x 支持uvue页面和vue页面混写吗？\
+  不支持混写。但蒸汽模式下的uvue可以写js/ts/uts（不要指定script的lang，外部脚本文件后缀保持uts，但里面可以写js/ts代码）。如需升级详见：[uni-app 升级 uni-app x](./uniapptox.md)
+
+- uni-app x 的app端能离线打包吗？\
+  鸿蒙平台和小程序类似，本身就是本地打包。而iOS和Android的离线打包文档[详见](./native/README.md)
+
+- uni-app x 的App能热更新吗？\
+  App开发期间可以热刷，但打包后目前不能热更新。\
+  蒸汽模式下的3端app会推出发布后热更新，请关注更新。\
+  Android目前可以使用[uni小程序sdk](https://ext.dcloud.net.cn/plugin?id=17638)，热更新小程序。\
+  
+- uni-app x 能调用所有原生API吗？\
+  可以。在app端，kotlin、swift、ets能调用的，uts就能调，因为uts其实就是编译成这些语言了。在浏览器、小程序端，所有js能调用的，uts也都能调。
+	
+- uni-app x 能集成原生sdk吗？\
+  可以，通过uts插件，[https://uniapp.dcloud.net.cn/plugin/uts-plugin.html](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)
+
+- uni-app x 的开发只能用HBuilderX吗？\
+  官方已发布cursor/vscode的语法服务插件，运行和打包仍需要HBuilderX。[详见](tutorial/ls-plugin.md)\
+	官方已启动 HBuilderV 产品开发，这是一个类似cursor的、基于vscode的IDE。（之所以不是vscode的插件，是因为vscode的插件api不够用，只能参考cursor、trae的做法）
+
+- 不跨平台，uni-app x 有优势吗？
+	即使不跨端，`uni-app`也是更好的小程序开发框架、更好的App开发框架、更方便的Web开发框架。
+	* 更好的小程序框架：vue的通用性、生态，比小程序厂商自定语法要好的多。
+	* 更好的App框架：
+		+ vue的模板写法，是一种AI熟悉的、简单而成熟的声明式写法。比如原生的命令式写法的开发效率高的多，而原生提供的声明式写法又性能不佳。在AI时代，由于声明式的约束，让AI犯错的机会也少的多、消耗的token也少的多。
+		+ uni-app x 支持开发期间热刷新。而原生开发，改一下代码都得等很久，非常低效。
+		+ 用 uni-app x 开发性能还比原生渲染更高，那确实没必要用原生开发了。
+
+	另外，由于AI对开发成本的降低，大多数业务希望获取更多流量入口、给用户开放更多使用其业务的载体，多端需求其实会越来越强烈。
+
+- uni-app x 支持最低的Android版本多少？浏览器版本多少？\
+  * Android VDOM最低支持`Android 5`，蒸汽模式最低支持`Android 6`；
+  * iOS版 VDOM模式最低支持`iOS12`，蒸汽模式最低支持`iOS15`
+  * harmonyOS版 VDOM模式最低支持`API14`；蒸汽模式最低支持`API20`
+  * Web版`发行模式`最低支持`chrome 64`、`safari 11.1`、`firefox 62`、`edge 79`、`safari on iOS 12`；
+  * Web版`运行模式`最低支持`chrome 66`、`safari 11.1`、`firefox 62`、`edge 79`、`safari on iOS 12`；另外由于运行时不会对语法进行转化来兼容低版本浏览器，如果使用了一些比较新的语法可能会无法在低版本浏览器上运行。
+
+- 老 uni-app 还维护吗？\
+  
+	官方已于2024年停止nvue和5+的维护。并将于2027年初停止uni-app的App平台的维护。
+	
+	因为 uni-app x蒸汽模式 已经兼容js/ts写法，开发者可以方便的将 老uni-app 升级到 uni-app x蒸汽模式。所以 老uni-app 的app平台的维护意义也不大了。
+	
+	不再维护不是下线，而是没有重大问题的话（如新手机不兼容）不会再更新了。
+
+  如果只开发小程序，那使用 uni-app 或 uni-app x 哪个都差不多。如果开发App，那么推荐改用 uni-app x。另外未来 uni-app x 的web平台也会升级蒸汽模式，而 老uni-app不会升级。所以后续web平台也推荐使用 uni-app x。
+
+  不管 uni-app 还是 uni-app x，都支持uts插件生态，原生扩展的api插件是复用的。但原生组件插件在老uni-app 和 uni-app x 蒸汽模式之间不能复用。
+
+  包括官方的API也是复用的，比如电量API [uni.getbatteryinfo](https://ext.dcloud.net.cn/plugin?id=9295)，它们使用uts开发，在 uni-app 和 uni-app x 上，调用的都是一套代码。
+
+本章节是概述性FAQ。蒸汽模式性能相关的FAQ，另见[蒸汽模式](./app-vapor.md#faq)
+
+::: tip 加群交流
+欢迎加入 uni-app x 专用群交流
+- [uni-im群](https://im.dcloud.net.cn/#/?joinGroup=6582a367058a46652e0deda9)