https://github.com/dcloudio/uni-app

A cross-platform framework using Vue.js
https://github.com/dcloudio/uni-app

android cross-platform crossplatform hbuilderx ios javascript miniprogram uni uni-app uniapp vue vue3

Last synced: 4 days ago
JSON representation

A cross-platform framework using Vue.js

• Host: GitHub
• URL: https://github.com/dcloudio/uni-app
• Owner: dcloudio
• License: apache-2.0
• Created: 2018-07-12T08:52:39.000Z (over 6 years ago)
• Default Branch: next
• Last Pushed: 2024-11-28T13:36:55.000Z (15 days ago)
• Last Synced: 2024-11-29T00:06:56.759Z (14 days ago)
• Topics: android, cross-platform, crossplatform, hbuilderx, ios, javascript, miniprogram, uni, uni-app, uniapp, vue, vue3
• Language: JavaScript
• Homepage: https://uniapp.dcloud.io
• Size: 4.74 GB
• Stars: 40,177
• Watchers: 513
• Forks: 3,637
• Open Issues: 1,035
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-frontend - uni-app - uni-app is a unified front-end framework that uses Vue.js to develop small programs, H5, and App.  (Repository / Cross Platform/Multiple Platform)
• awesome-github-star - uni-app - platform framework using Vue.js | dcloudio | 38630 | (JavaScript)
• awesome-wechat-app - uni-app ★19k+ - 使用 Vue 语法开发小程序、H5、App的统一框架 (工具)
• StarryDivineSky - dcloudio/uni-app - app 框架将其编译到 小程序（微信/支付宝/百度/字节跳动/QQ/快手/钉钉/小红书）、App（iOS/Android）、H5等平台，保证正确并达到优秀体验。 (前端开发框架及项目 / 其他_文本生成、文本对话)
• awesome-quick-dev - uni-app - app?style=flat-square) (小程序与App / Web管理后台通用)
• awesome-wechat-weapp - uni-app ★36.1k+ - 使用 Vue 语法开发小程序、H5、App的统一框架 (工具)
• awesome-star-libs - dcloudio / uni-app - app 是使用 Vue 语法开发小程序、H5、App的统一框架 (目录)
• awesome-uni-app - GitHub 仓库

README

        
# uni-app



  简体中文 | English



`uni-app` 是一个使用 `Vue.js` 开发小程序、H5、App的统一前端框架。官网地址：[https://uniapp.dcloud.io](https://uniapp.dcloud.io)

开发者使用 `Vue` 语法编写代码，`uni-app` 框架将其编译到 小程序（微信/支付宝/百度/字节跳动/QQ/快手/钉钉/小红书）、App（iOS/Android）、H5等多个平台，保证其正确运行并达到优秀体验。

# uni-app的特点

- 开发者和案例更多：HBuilder装机量800万台，开发者社区月活百万，70多个QQ微信群承载10万人。案例众多，uni统计月活超10亿（[详见](https://uniapp.dcloud.io/case)）

- 性能更高（见[评测](https://juejin.im/post/5ca1736af265da30ae314248)）

- 更丰富的周边生态，[插件市场](https://ext.dcloud.net.cn/)数千款插件

- 提供比小程序原生开发更好的开发体验、更高的工程化效率

- 跨端抹平度更完善，且各端特色发挥更灵活，可真正实现一套代码多端覆盖，无需各端多头维护升级

- 权威认可：阿里小程序官方工具内置uni-app（[详见](https://docs.alipay.com/mini/ide/0.70-stable)）、腾讯课堂官方自制uni-app培训视频（[详见](https://ask.dcloud.net.cn/article/35640)）

## 扫码体验

开发一次，编译到14个平台。依次扫描14个二维码，亲自体验最全面的跨平台效果！



  



*注： 某些平台不能提交简单demo，补充了一些其他功能。*

## 快速开始

`uni-app`支持通过`vue-cli`命令行、`HBuilderX`可视化界面两种方式快速创建项目：

- [vue-cli命令行方式](https://uniapp.dcloud.io/quickstart?id=_2-通过vue-cli命令行)：不限IDE，适合对node熟悉的开发者，扩展阅读：[在vscode中开发uni-app](https://ask.dcloud.net.cn/article/36286)、[在 WebStorm 中开发 uni-app](https://ask.dcloud.net.cn/article/36307)

- [HBuilderX可视化界面](https://uniapp.dcloud.io/quickstart?id=_1-通过-hbuilderx-可视化界面)：专用IDE，内置相关环境，开箱即用，开发效率更高。

## 项目案例

案例展示：[uniapp.dcloud.io/case](https://uniapp.dcloud.io/case)

欢迎提交你的应用，[uni-app案例征集](https://github.com/dcloudio/uni-app/issues/6)

## 需求墙

`uni-app`计划支持的功能点，会在需求墙上进行展示，征集开发者的投票意见，[前往投票](https://dev.dcloud.net.cn/wish/)。

## 更新日志

`uni-app`一直保持高频的更新迭代，详见[正式版更新日志](https://uniapp.dcloud.net.cn/release)、[Alpha版更新日志](https://uniapp.dcloud.net.cn/release-note-alpha)。

## 论坛

由于`DCloud`有70多个QQ、微信群，官方已无法维护更多交流群。请开发者到官方论坛交流：[https://ask.dcloud.net.cn/explore/](https://ask.dcloud.net.cn/explore/) 。论坛提供了比issues更专业的工具服务。

## 插件市场

`uni-app`有丰富的插件生态，众多开发者提交了数千款组件、sdk、项目模板，详见：[https://ext.dcloud.net.cn/](https://ext.dcloud.net.cn/)

除了众多三方ui库，官方还提供了uni-ui，在性能和跨端兼容方面有更强的优势。详见：[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)

## 现有项目如何迁移到uni-app体系

- 微信小程序转换uni-app指南及转换器：[https://ask.dcloud.net.cn/article/35786](https://ask.dcloud.net.cn/article/35786)

- vue h5项目转换uni-app指南：[https://ask.dcloud.net.cn/article/36174](https://ask.dcloud.net.cn/article/36174)

- mpvue 项目（组件）迁移指南、示例及资源汇总： [https://ask.dcloud.net.cn/article/34945](https://ask.dcloud.net.cn/article/34945)

- wepy转uni-app转换器：[https://github.com/zhangdaren/wepy-to-uniapp](https://github.com/zhangdaren/wepy-to-uniapp)

## 常见疑问

- 问：不同端有不同的需求、不同的特色，登录支付也不一样，如何统一？

- 答：差异部分使用条件编译。uni-app提供了灵活强大的[条件编译](https://uniapp.dcloud.io/platform)。可以完美处理复用部分和差异部分。真正一套工程源码。当业务升级时，不再需要多端维护。如果多端维护，经常会因为某些端的流量不大，就一直拖延无法让那些用户享受到最新服务。另外登录支付在客户端部分，已经被uni-app统一成一样的api了。

- 问：多端是不是一种妥协，是否会造成性能下降？

- 答：good question。多端且不影响性能，确实很难，但uni-app做到了。在h5端，它的性能、包体积与直接使用vue.js开发一致； 在小程序端，它的性能比大多数开发框架更好，uni-app底层自动处理的setdata差量同步机制，比开发者手动写setdata更好，就像使用vue.js更新界面比手动写js修改dom更高效一样； 在App，uni-app支持webview渲染和原生渲染双引擎，启用原生渲染时，css写法受限，但性能是很接近原生开发的效果的，在当前的手机环境下，千万日活以下的应用在App使用uni-app也不会遇到任何压力。当然也可以在已经做好的原生App中将部分页面改为uni-app实现; 此外，我们会把很多跨端处理放在编译期完成的，这样会减少对运行期的效率影响。

- 问：不做多端，是不是不需要uni-app？

- 答：不是。大量开发者用uni-app只做一个端，详见[案例](https://uniapp.dcloud.io/case)。对于开发者而言，一个优秀工具在手，做什么都不愁。

- 问：uni-app以后会不会变更开源协议，转向收费？

- 答：官方承诺永远不会变更开源协议。无论HBuilderX、uni-app、App，面向中国人永久免费。

## 更多资料

- 评测：[App跨平台框架VS原生开发深度评测之2023版](https://juejin.cn/post/7317091780826497075)

- 评测：[跨端开发框架深度横评之2020版](https://juejin.cn/post/6844904118901817351)

- 评测：[深入测试一周，主流多端框架大比武之2019版](https://mp.weixin.qq.com/s/jIDEHfuMnED6HTfNgjsW4w)

- [uni-app x在App端和flutter的比较](https://doc.dcloud.net.cn/uni-app-x/select.html)

## 贡献指南

如果你想参与贡献，请先阅读[贡献指南](.github/CONTRIBUTING.md)。