--- name: uni-app summary: "uni-app is an open-source Objective-C project in the ui components space with 41.5k GitHub stars. The repository is actively maintained, with recent commits." language: Objective-C license: Apache-2.0 repo: https://github.com/dcloudio/uni-app source: https://opensources.dev/resource/uni-app health: 100 --- # uni-app uni-app is an open-source Objective-C project in the ui components space with 41.5k GitHub stars. The repository is actively maintained, with recent commits. # uni-app x 是什么？ uni-app x，是下一代 uni-app，是一个跨平台应用开发引擎。 uni-app x 是一个庞大的工程，它包括uts语言、uvue渲染引擎、uni的组件和API、以及扩展机制。 uts是一门类ts的、跨平台的、新语言。 uts在Android平台编译为kotlin、在iOS平台编译为swift、在鸿蒙next平台上编译为ArkTS、在Web和小程序平台编译为js。 在Android平台，uni-app x 的工程被整体编译为kotlin代码，本质上是换了vue写法的原生kotlin应用。 在iOS和鸿蒙平台，因为蒸汽模式渲染引擎的强大，取得了比原生应用渲染快数倍的优异性能。详见[蒸汽模式](./app-vapor.md) 可以体验打包后的[hello uni-app x](https://hellouniappx.dcloud.net.cn)，访问地址或扫描二维码后获取： - `Android` - Android 端通过开发者工具显示界面元素边界可知界面都是原生UI，解包后也不会看到js引擎，里面的html文件是示例中演示web-view组件所用 - `iOS` 示例应用无法上架Appstore，需通过 ABM（Apple 商务管理）方式使用 - 使用 iPhone 扫码后跳转页面，使用 DCloud 账号登录，登录过后自动分发兑换码在 AppStore 获取安装包，此过程不需要您支付费用。ABM包在Appstore中无法公开搜索到，但安装后可在 AppStore 更新页面进行更新。 - `鸿蒙next` - 使用鸿蒙next手机的应用商店，搜索“DCloud开发者中心系统”，或者扫描下方二维码 - `Web` - 访问如下地址，[https://hellouniappx.dcloud.net.cn/web](https://hellouniappx.dcloud.net.cn/web)，或者扫描下方二维码 - `微信小程序` - 微信中搜索小程序`HelloUniAppX`，或者扫描下方二维码 ::: tip hello uni-app x的源码见：[https://gitcode.com/dcloud/hello-uni-app-x](https://gitcode.com/dcloud/hello-uni-app-x) ::: ## 1. uts语言 > 该语言在2022年9月推出，初期用于原生插件扩展开发。 开发者在 uni-app x 中，需使用 uts 而不是js。尤其是 Android端不自带js引擎，无法运行js代码。 uts 全称 uni type script，是一门跨平台的、高性能的、强类型的现代编程语言。它在不同平台，会被编译为不同平台的native语言，如： - `web/小程序`平台，编译为JavaScript - `Android`平台，编译为Kotlin - `iOS`平台，编译Swift - `鸿蒙next`平台，编译为ArkTS uts和ts很相似，但为了跨端，uts进行了一些约束和特定平台的增补。详见 [uts语言介绍](./uts/README.md) ## 2. uvue渲染引擎 uts替代的是js，而uvue替代的就是html和css。或者如果你了解flutter的话，也可以理解为uts类似dart，而uvue类似flutter。 uvue是一套基于uts的、兼容vue语法的、跨平台的、原生渲染引擎。 它分为2个模式，VDOM模式和[蒸汽模式](./app-vapor.md)。 VDOM模式于早期推出： - Android版于3.99上线 - Web版于4.0上线 - iOS版于4.11上线 - 微信小程序版于4.41上线 - harmonyOS版于4.61上线 从2026年起，新的[蒸汽模式](./app-vapor.md)将逐渐替代老的VDOM模式。 - harmonyOS版于5.0上线 - iOS版于5.1上线 - Android版将于5.2上线 vue蒸气模式（Vapor），免除了vnode的创建耗时，渲染速度更快 uni-app x蒸汽模式，摘下了跨平台框架的圣杯：**即跨平台，渲染性能又超过了原生，且兼容原生组件生态**。 以渲染4050个view和text的测试例为例，在不同平台原生的耗时和uni-app x蒸汽模式的耗时如下： 原生uni-app x蒸汽模式iOS388181鸿蒙798280 耗时的单位为ms。 - 鸿蒙测试设备：鸿蒙nova12(apiLevel 21，鸿蒙最低端手机) - iOS测试设备：iPhoneXR(iOS18.5) 可见，uni-app x蒸汽模式，均比原生渲染快2、3倍。 测试报告还有很多内容，详细介绍见[蒸汽模式](./app-vapor.md) uvue渲染引擎包括uts版的vue框架（组件、数据绑定...）、跨平台基础ui、css引擎。 有了uvue，开发者就可以使用vue语法、css来快速编写页面，编译为不同平台的、高性能的纯原生界面。 一个uvue页面的例子： > 示例没有涉及uts不允许的动态类型，也没有涉及uvue不支持的css，所以它实际上和uni-app js版的vue页面没有区别。 ```html ``` uvue支持的是vue3语法，VDOM模式支持组合式API和选项式API。蒸汽模式仅支持组合式API。详见[vue语法](./vue/README.md) uvue在App端支持的css语法，是web的子集，类似于但优于nvue的css。仅支持flex布局，但也足以布局出需要的界面。详见[css语法](./css/README.md) 使用该css子集，可保证跨端。如果把uvue页面编译到web平台，则web的其他css也都可以使用。 ## 3. uni的组件 @uni-components uni-app x支持的组件包括： - `内置基础组件`：如view、text、image、scroll-view、input...等，详见[组件清单](./component/README.md) - `自定义uvue组件`：使用内置组件和vue组件技术进行封装的组件，支持easycom。 - `uts组件插件`：用于原生sdk的ui以组件的方式嵌入。 > 除了微信小程序，其他端不支持小程序wxml组件。 更多组件介绍，[详见](./component/README.md) ## 4. API @uni-api uni-app x支持的API包括： 1. uts的API [详见](./uts/buildin-object-api/global.md) 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库管理。 以下示例，在 Android 上调用了 OS 的能力获取手机型号。如下： ```uts import Build from 'android.os.Build'; console.log(Build.MODEL); //调用原生对象，返回手机型号 console.log(uni.getSystemInfoSync().deviceModel); //调用uni API，返回手机型号。与上一行返回值相同 ``` ::: info 上面的示例，打印了2行日志，显示手机型号。 - uni.getSystemInfoSync，是uni的api - import的Build，是Android OS 的api ::: 在uni-app x里，可以直接调用 OS 的能力，不受限制，语法是uts的语法，但需要了解什么功能在原生里是哪个api。 使用`uni.getSystemInfoSync`则比较简单，看uni的文档即可，且可跨平台。 其实，[uni.getSystemInfoSync](https://gitcode.com/dcloud/uni-api/blob/master/uni_modules/uni-getSystemInfo/utssdk/app-android/index.uts) 的内部实现就是一个uts模块，底层使用了一样的代码，也是import了android.os.Build。 uni.的api，大多是uts开发的，它们开源在[uni-api](https://gitcode.com/dcloud/uni-api)。 插件市场也有很多做好的uts插件，方便开发者拿来即用。[uts插件](https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate) uni-app js引擎版，支持 plus API 和 weex API。但 uni-app x 中，不再支持这些API。 ## 5. 插件生态 uni-app x不使用插件，也可以直接调用各平台原生API。但把各平台API统一封装后，会让调用者更加方便。 uni-app x的插件生态，基于[uts插件](./plugin/uts-plugin.md)。这是一种面向全端的、统一的插件管理方案。 目前已经有数千款uts插件，它们发布在[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平台和小程序平台支持npm - Android平台支持gradle等仓储 - iOS平台支持cocoaPods - Harmony平台支持ohpm 如果你只是使用插件，那么访问插件市场，勾选`uni-app x`的checkbox就能找到所需插件。 如果你想开发uts插件，[参考插件开发教程](./plugin/uts-plugin.md) 如果想复用web生态的内容，可以使用 1. web-view组件承载：并利用组件提供的postMessage和原生通信。 2. ts生态的迁移：很多js库是ts编写的，如果没有使用uts不支持的语法，ts代码就可以使用。如果略有不同，也可以稍加改造ts以适配uts。 uni-app x支持npm，但npm的大多数库是for web的，无法跨端，这些库只能在uni-app x编译为web时使用，有的也支持小程序。当然如果有兼容uni-app x的全端库，可以使用，比如这些库[z-paging-x](https://www.npmjs.com/package/z-paging-x)、[lwu-css](https://www.npmjs.com/package/lwu-css)。 [uni插件市场](https://ext.dcloud.net.cn/)是跨端插件的聚集地，更推荐在这里找插件而不是去npm。 ### 推荐的优秀插件 基于uni-app x的纯前端组件，比如ui库，这里推荐一些： - [uni-ui x](./component/uni-ui-x/README.md)：官方UI库。 - [RiceUI](https://ext.dcloud.net.cn/plugin?id=24907)：支持蒸汽模式，全端组合式UI库。 - [lime-UI](https://ext.dcloud.net.cn/plugin?id=22372)：即兼容uni-app又兼容uni-app x，高频维护的优秀插件。2025插件大赛一等奖。 - [TMUI4.0](https://ext.dcloud.net.cn/plugin?id=16369)：高品质UI库，2023插件大赛一等奖。 - [TuiPlus](https://ext.dcloud.net.cn/plugin?id=21111)：简洁高效的组件库，买即赠[xCharts原生图表库](https://ext.dcloud.net.cn/plugin?id=21107) - [CoolUI](https://ext.dcloud.net.cn/plugin?id=24497)：全端支持的组合式UI库，内置 Tailwind CSS、支持多主题切换与国际化 - [firstUI](https://ext.dcloud.net.cn/plugin?id=16294)：免费、轻量UI库 - [uXui](https://ext.dcloud.net.cn/plugin?id=15726)：graceUI作者的免费开源组件库 ## 开放性 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的所有可视元素，都没有写死样式和文字，开发者可以自己定制风格和国际化。 开发者编写的代码，不管是uvue还是uts，编译后的产物代码都在项目的unpackage目录下。 开发者可以看到实际生成的kt、swift、ets、js代码是什么样的，无需担心埋入不合适的代码。 开发者可以自行把这些kt等文件引入自己的原生工程中，自行打包。这些都是开放的。 uni-app x引擎仅在引擎崩溃时有数据收集以用于产品改进，且不采集任何《个人信息保护法》涉及的个人隐私数据。详见[隐私协议](https://dcloud.io/license/appprivacy.html) ## 路线图 uni-app x 在2026年会陆续完成 - Android版蒸汽模式 - Android版js驱动 - app热更新 - 支付宝小程序、抖音小程序 其他计划，将根据社区的反馈意见来排优先级。 欢迎去[需求墙](https://vote.dcloud.net.cn/#/?name=uni-app%20x)投票。 ## 案例 [另见](./sample.md) ## 自动化测试 uni-app x 从源头重视产品质量，第一个版本就支持自动化测试。并为uni-app x产品编写了数十万行自动化测试例代码。 uni-app x 的自动化测试方案和 uni-app js版相同，自动化测试脚本使用js编写（注意不是uts）。整个自动化测试环境，运行在电脑端。 开发者可以为自己的app编写好自动化测试，以提升自己的产品质量。 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 - uni-app x 支持uvue页面和vue页面混写吗？ 仅支持uvue页面。Android平台暂未内置js引擎，不能运行vue页面。但历史vue页面可以通过 [uni小程序sdk](https://ext.dcloud.net.cn/plugin?id=17638) 嵌入到uni-app x中。 - uni-app x 的app端能离线打包吗？ 鸿蒙平台和小程序类似，本身就是本地打包。而iOS和Android的离线打包文档[详见](./native/README.md) - uni-app x 的App能热更新吗？ Android和iOS开发期间可以热刷，但打包后不能热更新。 Android作为原生应用，可以使用[uni小程序sdk](https://ext.dcloud.net.cn/plugin?id=17638)，热更新小程序。当然开发者也可自行封装原生的插件动态加载方案。 iOS平台的js逻辑层模式，未来会推出wgt更新。 - 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) - uni-app x 支持AI开发吗？ 官方提供的[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，是最佳的uni-app x AI Coding工具。熟悉uts语法、自动修复编译错误，还熟悉原生混编，可以写uts插件。 官方的[uni-ui x](./component/uni-ui-x/README.md) 组件库，以及众多新出的[设备API](./api/calendar.md)，都是使用uni-agent开发的。 - uni-app x 支持最低的Android版本多少？浏览器版本多少？\ - Android App最低支持`Android 5`； - iOS版最低支持`iOS12` - harmonyOS版最低支持`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 js引擎版还维护吗？ 维护。服务js开发者仍然是DCloud的重点。但nvue和5+将不再维护。不再维护不是下线，而是没有重大问题的话（如新手机不兼容）不会再更新了。 如果开发小程序和Web，那使用哪个都差不多。 如果开发App，那uni-app面向的是对体验不敏感，只了解web技术，对开发成本更敏感的前端开发者。而uni-app x则适用于愿意多付出一些开发成本、以追求更好体验的开发者。当然这个多付出的开发成本也远低于原生开发各端的成本。 不管uni-app还是uni-app x，都支持uts插件生态，原生扩展api和插件是复用的。 包括官方的组件和API也是复用的，比如电量API [uni.getbatteryinfo](https://ext.dcloud.net.cn/plugin?id=9295)，和[lottie组件](https://ext.dcloud.net.cn/plugin?id=10674)，它们使用uts开发，在 uni-app和uni-app x上，调用的都是一套代码。 所以不必担心官方精力不足，顾此失彼。 ::: tip 加群交流 欢迎加入 uni-app x 专用群交流 - [uni-im群](https://im.dcloud.net.cn/#/?joinGroup=6582a367058a46652e0deda9) :::