uni-app Documentation

A cross-platform framework using Vue.js

41,600 stars Objective-C 1 file · ~3,503 tokens #android#cross-platform#crossplatform#hbuilderx#ios#javascript#miniprogram#uni
RAW Doc

File: README.md

简体中文 | English

uni-app是一个使用 Vue.js 开发所有前端应用的框架，开发者编写一套代码，可发布到iOS、Android、鸿蒙、Web（响应式）、以及各种小程序（微信/支付宝/百度/抖音/飞书/QQ/快手/钉钉/淘宝/京东/小红书）、快应用、鸿蒙元服务等多个平台。

DCloud公司拥有上千万开发者、数百万应用、几十亿手机端月活用户、数万款uni-app插件，开发者可以放心选择。

uni-app分 uni-app 和 uni-app x。

  • uni-app：基于前端技术栈，App引擎采用与小程序相同的技术架构，逻辑层使用js，渲染层使用web-view。
  • uni-app x：是新一代 uni-app，拥有比原生应用更优秀的渲染性能。

uni-app x 蒸汽模式支持使用js/ts/uts开发页面。uts语言主要用于原生插件扩展。

uts是一门类ts的、跨平台的语言。uts在Android平台编译为kotlin、在iOS平台编译为swift、在鸿蒙next平台上编译为ArkTS、在Web和小程序平台编译为js。

uni-app在手，做啥都不愁。即使不跨端，uni-app也是更好的小程序开发框架（详见）、更好的App跨平台框架、更方便的Web开发框架。不管领导安排什么样的项目，你都可以快速交付，不需要转换开发思维、不需要更改开发习惯。

uni-app是一个AI友好的技术框架，使用AI擅长的vue、js/ts、css即可完成应用开发。同时DCloud公司提供了uni-agent，可以更方便的使用AI开发uni-app

快速体验

text
注：
    *- 某些平台不能提交简单demo，故补充了一些其他功能；hello uni-app (x)示例代码可从 [github](https://github.com/dcloudio/hello-uniapp) 获取*
    *- 快应用仅支持 vivo 、oppo、华为*

仓库介绍

uni-app x 分支，为 uni-app x 版本的开源仓库。

uni-app，分 vue2 和 vue3，分支分别是：uni-app-vue2、uni-app-vue3。

uni-app x分支目录说明：

  • benchmark 目录下为性能评测报告
  • docs 目录为文档
  • examples 目录为示例项目
  • src 目录为源码
  • test 目录为测试例
  • CHANGELOG.md 为更新日志

一套代码，运行到多个平台

uni-app实现了一套代码，同时运行到多个平台；如下图所示，一套代码，同时运行到iOS模拟器、Android模拟器、web、微信开发者工具、支付宝小程序Studio、百度开发者工具、抖音开发者工具、QQ开发者工具（底部每个终端选项卡，代表1个终端模拟器）：

实际运行效果如下（点击图片可放大）：

File: docs/README.md

uni-app x 是什么？

uni-app x，是下一代 uni-app，是一个基于vue、js/ts/uts、css和原生渲染的跨平台开发框架。

uni-app x 在2026年推出蒸汽模式后，终于实现了跨平台框架的终极愿景：即跨平台，又做到了比原生更快的渲染速度。见性能对比

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

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

text
<a
	href="https://hellouniappx.dcloud.net.cn" target="_blank"
	style="display: flex; align-items: center;flex-direction: column;margin: 0 5px 20px;width:160px;"
>
	
	**hello uni-app x**
</a>

::: tip
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|
|iOS |325.76 |167 |1.95倍 |https://www.bilibili.com/video/BV1ApMt66Eez|
|鸿蒙 |804 |267 |3倍 |https://www.bilibili.com/video/BV1RpPQzAEDS|

表格数据为耗时，单位为ms。

  • Android测试设备：小米Fold4(Android16)
  • iOS测试设备：iPhoneSE(iOS26.5)
  • 鸿蒙测试设备：鸿蒙nova12(api21)

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

重现方式：

本文为 uni-app x 简介，并非详细评测报告，更多内容，包括Compose UI、Swift UI等更多技术方案的对比，包括如何公平测试，包括长列表、富文本、canvas等更多组件的性能测试，详见专业的benchmark：

VDOM模式和蒸汽模式

uni-app x 的第一代是VDOM模式，该模式的编程语言是uts，一种可以编译为kotlin、Swift、ets、js的跨平台强类型语言。

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

虽然跨语言调用障碍抹平，但由于VDOM的存在以及渲染引擎不够强大，实际渲染速度比原生慢。

2026年，uni-app x 推出了新一代的蒸汽模式，由于新版的渲染引擎性能远超原生数倍，改成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年起，新的蒸汽模式将逐渐替代老的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来完成应用开发，AI对 uni-app x 蒸汽模式的开发非常友好。

一个典型的 uni-app x 的 uvue页面例子：

html
<template>
	<view class="content">
		{{title}}
	</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 {
		flex: 1;
		background-color: white;
	}
</style>

uni的组件 @uni-components

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

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

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

很多内置组件，也是开源的uvue组件，在每个组件文档右上角可以点击源码仓库链接查看。

更多组件介绍，详见

API @uni-api

uni-app x 支持的API包括：

  1. js的内置API
  2. 全局API，前面不需要加uni.。如getApp、getCurrentPages
  3. uni.xxx的内置API。数量较多，详见
  4. uniCloud.xxx的内置API。详见
  5. dom的API 详见
  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插件

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

更多API介绍，详见

CSS @css

uni-app x 在web和小程序，支持完成的浏览器css，在app平台，由于是原生渲染，支持的css的子集。

主要差异包括：

  • 使用flex布局，且默认方向为竖向
  • 文字必须写在text组件内且样式不支持继承

其他差异详见 css文档

插件生态@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。所以尽量选用那些适配小程序的NPM库，比如echarts-for-weixin

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

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

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

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

uts插件有多种开发方式：

  1. 可以使用uts语言直接调用系统API来封装插件
    比如电量插件，在每个平台都是uts代码，但统一了interface。
  2. 可以原生混编
    在不同平台，直接用uts调用平台原生代码，比如Android的kt文件、iOS的swift文件、鸿蒙的ets文件。同样使用一套interface约束。
    比如音频播放插件，在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插件，参考插件开发教程。

推荐使用uni-agent来开发uts原生插件，它可以做到不懂原生的前端开发者开发出uts原生插件。

推荐的优秀插件

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

  • uni-ui x：官方UI库。它的设计规范与uni ui有差别，是为uni-app x重新设计的更好的ui库。兼容蒸汽模式、使用样式隔离策略2.0
  • lime-UI Vapor：即兼容uni-app又兼容uni-app x蒸汽模式。2025插件大赛一等奖。
  • RiceUI：支持蒸汽模式，全端组合式UI库。
  • TuiPlus Vapor：支持蒸汽模式，支持css原子化。
  • TMUI4.0：VDOM模式高品质UI库，2023插件大赛一等奖。

开放性

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 的未开源部分，可以联系：[email protected]

路线图

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

  • app热更新
  • 支付宝小程序、抖音小程序

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

欢迎去需求墙投票。

案例

另见

质量

uni-app x 从2023年起第一个版本就支持自动化测试。

并且 uni-app x 坚持一个原则，修复的每个开发者报的issues，都要配套自动化测试例。

数年来，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

历史老项目兼容指南

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

  • AI时代，跨平台工具的价值还明显吗？
    AI大幅提效，削减了行业整体的开发成本。不管是原生、其他跨平台框架，还是uni，开发成本都大幅下降。
    但如果想交付好多端成品，使用原生技术栈时仍然需要多个平台的开发工程师各自操作AI。
    如果你不懂原生，直接让AI写3个平台的原生代码，你会很快得到一个半成品，然后再变成商用成品的过程中发现不懂原生不行。\

    可以这么类比：\

    • AI Coding之前，开发者假使每个平台需要2人月的工作量，3个平台是6人月，而使用 uni-app 能变成 1人月。节省5倍成本和1倍的时间。
    • AI Coding之后，原生从6人月变成了3人月 + 部分token费用。而使用 uni-app x 蒸汽，则变成了 0.5人月 + 部分token费用。还是节省5倍左右的成本和1倍的时间。

    由于开发成本和耗时的进一步下降，事实上催生了uni应用数量的进一步增长。

    另外 uni-app x 还有2个相对于原生的优势：

    1. 比原生更好的渲染性能，使用 AI + 原生也达不到 uni-app x 的效果。
    2. uni-app x 毕竟是vue的声明式写法，比原生的命令式写法更简单、更高效。而原生的声明式写法不跨端且性能不佳。即使不跨端，只开发一个平台，uni-app x 都能比原生开发更快、成品性能更流畅。

  • uni-app x 支持AI开发吗？
    官方提供的uni-agent，是最佳的 uni-app x AI Coding工具。熟悉uni全线产品，熟悉uts语法、自动修复编译错误，还熟悉原生混编，可以写uts原生插件。
    官方的uni-ui x 组件库，以及众多 组件（高德地图、lottie的animation-view）、API（陀螺仪、加速计、指南针、日历、通讯录...），都是使用 uni-agent 开发的。

    另外 uni-app x 蒸汽模式，由于支持普通的ts/js，使用vue、css等标准技术栈，AI非常熟悉。

  • 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 支持的插件生态有较多种，见上。
    flutter和react native的插件生态，长于国外sdk的封装。而国内、尤其是要鸿蒙和小程序，还是uni的生态更丰富。
    另外很多高频的功能，本身在uni-app中已经官方内置。
    大多数插件，只是一个桥接翻译层，在AI时代，通过 uni-agent 可以轻松的把原生SDK封装对接出来，这种较浅的插件其实意义不大，下载三方代码还不如自己用AI封装一下。

  • uni-app x 支持uvue页面和vue页面混写吗？
    不支持混写。但蒸汽模式下的uvue可以写js/ts/uts。如需升级详见：uni-app 升级 uni-app x

  • uni-app x 的app端能离线打包吗？
    鸿蒙平台和小程序类似，本身就是本地打包。而iOS和Android的离线打包文档详见

  • uni-app x 的App能热更新吗？
    App开发期间可以热刷，但打包后不能热更新。
    蒸汽模式下的3端app会推出发布后更新，请关注更新。
    Android目前可以使用uni小程序sdk，热更新小程序。\

  • 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。详见
    官方已启动 HBuilderV 产品开发，这是一个类似cursor的、基于vscode的IDE。（之所以不是vscode的插件，是因为vscode的插件api不够用，只能参考cursor、trae的做法）

  • 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+的维护。

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

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

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

    不管 uni-app 还是 uni-app x，都支持uts插件生态，原生扩展的api插件是复用的。但原生组件插件在老uni-app 和 uni-app x 蒸汽模式之间不能复用。

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

::: tip 加群交流
欢迎加入 uni-app x 专用群交流

Explore Related Technologies & Topics

View All 9,111+ Repositories →

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#android Browse android catalog → #cross-platform Browse cross-platform catalog → #crossplatform Browse crossplatform catalog → #hbuilderx Browse hbuilderx catalog → #ios Browse ios catalog → #javascript Browse javascript catalog → ⚡ MCP Servers Model Context Protocol → 🧠 Agent Skills Prompt & rule files → 🔌 OpenAPI Specs REST & Swagger schemas →