展示全部

# uni-app x 是什么？HBuilderX 3.9+

uni-app x，是下一代 uni-app，是一个跨平台应用开发引擎。

uni-app x 是一个庞大的工程，它包括uts语言、uvue渲染引擎、uni的组件和API、以及扩展机制。

uni-app x 即跨平台，又做到了比原生更快的渲染速度、更高的帧率。评测见蒸汽模式

可以体验打包后的hello uni-app x，访问地址或扫描二维码后获取：

支持 Android、iOS、鸿蒙、web、微信小程序。

hello uni-app x

TIP

hello uni-app x的源码见：https://gitcode.com/dcloud/hello-uni-app-x

# 1. uts语言

该语言在2022年9月推出

uts 全称 uni type script，是一门跨平台的、高性能的、强类型的现代编程语言。它在不同平台，会被编译为不同平台的native语言，如：

web/小程序平台，编译为JavaScript
Android平台，编译为Kotlin
iOS平台，编译Swift
鸿蒙next平台，编译为ArkTS

uts和ts很相似，但为了跨端，uts进行了一些约束和特定平台的增补。详见 uts语言介绍

uni-app x早期为vdom模式，Android平台的页面script仅支持uts且会编译为kt代码，受强类型约束。

uni-app x于2026年推出蒸汽模式，全平台兼容ts/js写法，不再强制约束强类型。

在蒸汽模式后，uts语言的主要作用是开发uts原生插件。

# 2. uvue渲染引擎

uvue是一套基于uts/ts/js的、兼容vue语法的、跨平台的、原生渲染引擎。

它分为2个模式，VDOM模式和蒸汽模式。

VDOM模式于早期推出：

Android版于3.99上线
Web版于4.0上线
iOS版于4.11上线
微信小程序版于4.41上线
harmonyOS版于4.61上线

从2026年起，新的蒸汽模式将逐渐替代老的VDOM模式。

harmonyOS版于5.0上线
iOS版于5.1上线
Android版于5.2上线

vue蒸气模式（Vapor），免除了vnode的创建耗时，并全新研发了基于原生渲染管线的UI系统，渲染速度更快、帧率更高。

uni-app x蒸汽模式，摘下了跨平台框架的圣杯：即跨平台，渲染性能又超过了原生，且兼容原生组件生态。

以渲染4050个view和text的测试例为例，在不同平台原生的耗时和uni-app x蒸汽模式的耗时如下：

	原生	uni-app x蒸汽模式
鸿蒙	798	280
iOS	339.7	185
Android	436	224

耗时的单位为ms。

鸿蒙测试设备：鸿蒙nova12(apiLevel 21，鸿蒙最低端手机)
iOS测试设备：iPhoneXR(iOS18.5)
Android测试设备：华为mate30 Android

可见，uni-app x蒸汽模式，均比原生渲染快2、3倍。

测试报告还有很多内容，详细介绍见蒸汽模式

有了uvue，开发者就可以使用vue语法、css来快速编写页面，编译为不同平台的、高性能的界面。

一个uvue页面的例子：

<template>
	<view class="content">
		<button @click="buttonClick">{{title}}</button>
	</view>
</template>

<script setup lang="uts">
	const title = ref("Hello world")

	onLoad(() => {
		console.log('onLoad')
	})

	const buttonClick = () => {
		uni.showModal({
			"showCancel": false,
			"content": "点了按钮"
		})
	}
</script>

<style>
	.content {
		width: 750rpx;
		background-color: white;
	}
</style>

示例源码如下，请查看 pre > code 标签中的内容

<template>
	<view class="content">
		<button @click="buttonClick">{{title}}</button>
	</view>
</template>

<script setup lang="uts">
	const title = ref("Hello world")

	onLoad(() => {
		console.log('onLoad')
	})

	const buttonClick = () => {
		uni.showModal({
			"showCancel": false,
			"content": "点了按钮"
		})
	}
</script>

<style>
	.content {
		width: 750rpx;
		background-color: white;
	}
</style>

uvue支持的是vue3语法，VDOM模式支持组合式API和选项式API。蒸汽模式仅支持组合式API。详见vue语法

uvue在App端支持的css语法，是web的子集，类似于但优于nvue的css。仅支持flex布局，但也足以布局出需要的界面。详见css语法

使用该css子集，可保证跨端。如果把uvue页面编译到web和小程序平台，则浏览器的其他css也都可以使用。

# 3. uni的组件

uni-app x支持的组件包括：

内置基础组件：如view、text、image、scroll-view、input...等，详见组件清单
自定义uvue组件：使用内置组件和vue组件技术进行封装的组件，支持easycom。
uts组件插件：用于原生sdk的ui以组件的方式嵌入。

除了微信小程序，其他端不支持小程序wxml组件。

更多组件介绍，详见

# 4. API

uni-app x支持的API包括：

uts的API 详见
全局API，前面不需要加uni.。如getApp、getCurrentPages
uni.xxx的内置API。数量较多，详见
uniCloud.xxx的内置API。详见
dom的API 详见
原生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 的能力获取手机型号。如下：

	import Build from 'android.os.Build';
	console.log(Build.MODEL); //调用原生对象，返回手机型号
	console.log(uni.getSystemInfoSync().deviceModel); //调用uni API，返回手机型号。与上一行返回值相同

示例源码如下，请查看 pre > code 标签中的内容

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 的内部实现就是一个uts模块，底层使用了一样的代码，也是import了android.os.Build。

uni.的api，大多是uts开发的，它们开源在uni-api。

插件市场也有很多做好的uts插件，方便开发者拿来即用。uts插件

老uni-app，支持 plus API 和 weex API。但 uni-app x 中，不再支持这些API。

# 5. 插件生态

uni-app x的插件生态，以uni_modules为主。这是一种面向全端的、统一的插件管理方案。它容纳支持了npm、Android仓库、iOS Swift PM、CocoaPods、鸿蒙ohpm。可以引入web和原生的各种生态库。

uni插件市场是跨端插件的聚集地，前端插件可以去npm找，但原生插件更推荐在这里找。

uni-app x的插件生态，基于uts插件。这是一种面向全端的、统一的插件管理方案。

目前已经有数千款插件支持uni-app x，它们发布在uni插件市场

uts插件通过统一的interface，约束了所有平台的API的输入输出，甚至错误码，保障了跨平台调用的一致性。

uts插件有多种开发方式：

可以使用uts语言直接调用系统API来封装插件比如电量插件，在每个平台都是uts代码，但统一了interface。
可以原生混编在不同平台，直接用uts调用平台原生代码，比如Android的kt文件、iOS的swift文件、鸿蒙的ets文件。同样使用一套interface约束。
比如音频播放插件，在Android上使用了kt混编，iOS使用了swift混编，复用现成的原生代码，快速封装插件。
调用三方sdk并引入库管理 uts插件是一个大一统的插件模型，其中在不同的子平台可以包含不同平台的库管理方案，不管是aar、so、framework、har都可以使用
- web平台和小程序平台，以及跨端的js库，支持npm
- Android平台支持gradle等仓储
- iOS平台支持cocoaPods和Swift PM
- Harmony平台支持ohpm

如果你只是使用插件，那么访问插件市场，勾选uni-app x的checkbox就能找到所需插件。

如果你想开发uts插件，参考插件开发教程

如果想复用web生态的内容，还可以使用web-view组件承载：并利用组件提供的postMessage和原生通信。

# 推荐的优秀插件

基于uni-app x的纯前端组件，比如ui库，这里推荐一些：

uni-ui x：官方UI库。它的设计规范与uni ui有差别，是为uni-app x重新设计的更好的ui库。兼容蒸汽模式、使用样式隔离策略2.0
RiceUI：支持蒸汽模式，全端组合式UI库。
lime-UI：即兼容uni-app又兼容uni-app x，高频维护的优秀插件。2025插件大赛一等奖。
TMUI4.0：高品质UI库，2023插件大赛一等奖。
TuiPlus：简洁高效的组件库，买即赠xCharts原生图表库
CoolUI：全端支持的组合式UI库，内置 Tailwind CSS、支持多主题切换与国际化
firstUI：免费、轻量UI库
uXui：graceUI作者的免费开源组件库

# 开放性

uni-app x的组件和API基本都开源，个别未开源部分也会在接下来陆续完成开源。

在uni-app x的每个组件和API的文档中，都有该API具体实现的源码github和gitcode链接（文档右侧）。比如uni.showModal

开发者可以审查这些源码的合理性，也可以在遇到官方bug时，自行拉源码修复。
uni-app x支持单独的组件和API替换，将源码的uni_modules下载到工程下，修改源码后打包即可将官方实现自动替换为你修改的实现。

uni-app x的Web版、小程序版的主引擎有单独开源地址：https://github.com/dcloudio/uni-app

uni-app x的所有可视元素，都没有写死样式和文字，开发者可以自己定制风格和国际化。

开发者编写的代码，编译后的产物代码都在项目的unpackage目录下。
开发者可以看到实际生成的js、kt、swift、ets代码是什么样的，无需担心埋入不合适的代码。
开发者可以自行把这些编译产物引入自己的原生工程中，自行打包。这些都是开放的。

uni-app x引擎仅在引擎崩溃时有数据收集以用于产品改进，且不采集任何《个人信息保护法》涉及的个人隐私数据。详见隐私协议

# 路线图

uni-app x 在2026年会陆续完成

Android版蒸汽模式
Android版js驱动
app热更新
支付宝小程序、抖音小程序

其他计划，将根据社区的反馈意见来排优先级。

欢迎去需求墙投票。

# 案例

另见

# 自动化测试

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

# 历史老项目兼容指南

# uni-app js版老项目迁移指南

详见：uni-app 升级 uni-app x

# 原生/rn/flutter页面兼容指南

之前已经有原生/rn/flutter页面，希望渐进式的迁移到uni-app x架构，该怎么搞？

uni-app x 毕竟是原生应用，内嵌flutter、rn这些没有任何问题，包括调用其他原生写的界面也可以。把之前的页面封装为uts插件，云打包就可以用。

插件市场已经有uts版本的内嵌flutter插件、内嵌compose ui插件

而uni-agent，也具备把原生、rn、flutter应用翻译成uni-app x应用的能力。

至于把 uni-app x 作为一个sdk内嵌到其他原生应用中，请参考uni-app x原生SDK。

# FAQ

uni-app x 支持uvue页面和vue页面混写吗？
不支持混写。但蒸汽模式下的uvue可以写js/ts/uts。如需升级详见：uni-app 升级 uni-app x
uni-app x 的app端能离线打包吗？
鸿蒙平台和小程序类似，本身就是本地打包。而iOS和Android的离线打包文档详见
uni-app x 的App能热更新吗？
Android和iOS开发期间可以热刷，但打包后不能热更新。
Android作为原生应用，可以使用uni小程序sdk，热更新小程序。当然开发者也可自行封装原生的插件动态加载方案。
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
uni-app x 的开发只能用HBuilderX吗？
官方已发布cursor/vscode的语法服务插件，运行和打包仍需要HBuilderX。详见
uni-app x 支持AI开发吗？
官方提供的uni-agent，是最佳的uni-app x AI Coding工具。熟悉uni全线产品，熟悉uts语法、自动修复编译错误，还熟悉原生混编，可以写uts原生插件。
官方的uni-ui x 组件库，以及众多新出的设备API，都是使用uni-agent开发的。
uni-app x 支持最低的Android版本多少？浏览器版本多少？\
- Android VDOM最低支持Android 5，蒸汽模式最低支持Android 5；
- 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+的维护。

因为uni-app x蒸汽模式已经兼容js/ts写法，开发者可以方便的将老uni-app升级到uni-app x蒸汽模式。所以老uni-app、尤其是老uni-app的app平台的维护意义也不大了。

不再维护不是下线，而是没有重大问题的话（如新手机不兼容）不会再更新了。

如果开发小程序和Web，那使用哪个都差不多。如果开发App，那么推荐改用uni-app x。

不管uni-app还是uni-app x，都支持uts插件生态，原生扩展api和插件是复用的。

包括官方的组件和API也是复用的，比如电量API uni.getbatteryinfo，它们使用uts开发，在 uni-app和uni-app x上，调用的都是一套代码。