四零语境后端代码仓库
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

188 lines
7.1 KiB

1 day ago
  1. # 项目介绍
  2. JeecgUniapp 是`JeecgBoot低代码平台`的配套`APP移动框架`,项目采用 Uniapp、Vue3.0、Vite、 Wot-design-uni、TypeScript 等最新技术栈,包括二次封装组件、路由拦截、请求拦截等功能。实现了与 `JeecgBoot` 完美对接:
  3. 目前已经实现登录、用户信息、通讯录、公告、移动首页、九宫格、聊天、Online表单、仪表盘等功能,提供了丰富的组件!
  4. 当前最新版本: 3.0.0(发布日期:2025-03-10)
  5. [![AUR](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg)](https://github.com/zhangdaiscott/jeecg-boot/blob/master/LICENSE)
  6. [![](https://img.shields.io/badge/Author-北京国炬软件-orange.svg)](http://www.jeecg.com)
  7. [![](https://img.shields.io/badge/version-3.0.0-brightgreen.svg)](https://github.com/zhangdaiscott/jeecg-boot)
  8. [![GitHub stars](https://img.shields.io/github/stars/zhangdaiscott/jeecg-boot.svg?style=social&label=Stars)](https://github.com/zhangdaiscott/jeecg-boot)
  9. [![GitHub forks](https://img.shields.io/github/forks/zhangdaiscott/jeecg-boot.svg?style=social&label=Fork)](https://github.com/zhangdaiscott/jeecg-boot)
  10. ### 视频介绍
  11. [![](https://upload.jeecg.com/jeecg/qiaoqiaoyunsite/jeecguniappvideo.png)](https://www.bilibili.com/video/BV15QQeYoEfQ)
  12. ### 新版特点
  13. - 一份代码多终端适配,小程序、H5、安卓、ios、鸿蒙Next。
  14. - 学习成本低、组件丰富、兼容性好、支持iframe嵌入。
  15. - 新版APP具备低代码能力,包括表单设计、仪表盘设计等。
  16. - 新版最大亮点是架构升级到 Vue3,适配鸿蒙 Next。
  17. - 支持使用 VSCode 和 IntelliJ IDEA 开发,不再必须 HBuilderX,这显著提升了开发体验和效率。
  18. - 支持低代码能力,例如Online表单可以在APP端展示和进行数据的添加与修改,仪表盘和大屏也支持移动端展示。
  19. ### 前端技术栈
  20. - 前端 IDE 建议:Vscode、HBuilderX、Intellij IDEA
  21. - 最新技术栈:Uniapp + Vue3.0 + Vite + TypeScript + Wot-design-uni + pinia + unocss
  22. - 依赖管理:node、pnpm
  23. ### 环境要求
  24. - 本地环境安装 node(18+)、pnpm (7.3+)
  25. ### 后台源码
  26. - https://github.com/jeecgboot/jeecg-boot
  27. ### 技术交流
  28. - 产品官网: [http://jeecg.com/appIndex](http://jeecg.com/appIndex)
  29. - 开发文档: [https://help.jeecg.com/uniapp3](https://help.jeecg.com/uniapp3)
  30. - 官方支持: 遇到BUG可以在github上 [发Issue](https://github.com/jeecgboot/jeecg-uniapp/issues/new)
  31. - QQ交流群: 716488839
  32. ### 快速启动
  33. #### 配置接口地址
  34. > 配置文件:`env/.env.development`
  35. 请把 http://localhost:8080/jeecg-boot 替换成自己地址,其他不用改。
  36. ```javascript
  37. // 变量必须以 VITE_ 为前缀才能暴露给外部读取
  38. NODE_ENV = 'development';
  39. // 是否去除console 和 debugger
  40. VITE_DELETE_CONSOLE = false;
  41. // 是否开启sourcemap
  42. VITE_SHOW_SOURCEMAP = true;
  43. // 后台接口全路径地址(必填)
  44. VITE_SERVER_BASEURL = 'http://localhost:8080/jeecg-boot';
  45. ```
  46. #### 启动项目
  47. 执行命令安装依赖
  48. ```
  49. pnpm i
  50. ```
  51. 运行启动命令,运行 `H5`
  52. ```
  53. pnpm run dev
  54. ```
  55. ### 新旧版本对比
  56. | 特性 | 旧版 | 新版 |
  57. | -------------------- | -------------- |------------------------------------------------|
  58. | **技术栈** | Vue2,技术陈旧 | Vue3,现代化开发体验 |
  59. | **UI 框架** | 未集成 | 集成`wot-design-uni` |
  60. | **编辑器** | 仅限 HbuilderX | 支持 VSCode、Intellij IDEA 等主流编辑器 |
  61. | **鸿蒙** | 不支持 | 支持鸿蒙系统 |
  62. | **构建工具** | Webpack | Vite,构建更快 |
  63. | **Unocss 原子化** | 不支持 | 支持 Unocss 原子化 |
  64. | **TypeScript 支持** | 不支持 | 支持 TS,提供类型提示 |
  65. | **基础组件封装** | 较少 | 封装丰富组件(用户、部门、分类字典树、自定义树、popup、popupDict、导航组件等) |
  66. | **代码片段快捷创建** | 无 | 支持 v3 快速创建页面片段 |
  67. ### 入门必备
  68. 本项目需要一定前端基础知识,请确保掌握 Vue 的基础知识,以便能处理一些常见的问题。 建议在开发前先学一下以下内容,提前了解和学习这些知识,会对项目理解非常有帮助:
  69. - [Vue3 文档](https://cn.vuejs.org)
  70. - [Uniapp](https://uniapp.dcloud.net.cn/)
  71. - [Wot-design-uni](https://wot-design-uni.cn)
  72. - [Unibest 文档](https://www.unibest.tech)
  73. - [TypeScript](https://www.typescriptlang.org)
  74. - [Es6](https://es6.ruanyifeng.com/)
  75. - [Vitejs](https://vitejs.dev)
  76. - [Pinia(vuex 替代方案)](https://pinia.esm.dev/introduction.html)
  77. - [Vue-RFCS](https://github.com/vuejs/rfcs)
  78. - [UnoCSS](https://unocss.dev)
  79. ### 效果预览
  80. - 基础功能
  81. ![](https://oscimg.oschina.net/oscnet/up-9fb74025440e6066651599d78b4bc78f2cd.png)
  82. ![](https://oscimg.oschina.net/oscnet/up-7605e213638a559bba64279b6db93af3ed0.png)
  83. ![](https://oscimg.oschina.net/oscnet/up-43ddd52486509ab06a920c3f99f42b8b432.png)
  84. ![](https://oscimg.oschina.net/oscnet/up-02d83a8fe3fab4c0153862a9084f8a94cbb.png)
  85. ![](https://oscimg.oschina.net/oscnet/up-937a63d5e13869c40e6f1437452171d8235.png)
  86. - 聊天功能
  87. ![](https://oscimg.oschina.net/oscnet/up-64bea8f521888f1c2b192c140ad3ba47024.png)
  88. ![](https://oscimg.oschina.net/oscnet/up-58d50a5ca1e3c15e628ede2dc59e87bca97.png)
  89. ![](https://oscimg.oschina.net/oscnet/up-800a03ecb4238a788ed32ecceefa809895b.png)
  90. ![](https://oscimg.oschina.net/oscnet/up-e840f754aa5927584a8e482662758b45218.png)
  91. ![](https://oscimg.oschina.net/oscnet/up-941cbcc10b4b6fc02d1f62b446764a465c3.png)
  92. - Online表单
  93. ![](https://oscimg.oschina.net/oscnet/up-051105a465e568b6a8935100a5a1af6de69.png)
  94. ![](https://oscimg.oschina.net/oscnet/up-942a0398a8cae684ee2bf8203c3ec96b709.png)
  95. ![](https://oscimg.oschina.net/oscnet/up-dbc6687d6c809f2682c5b2fb013ee6475e5.png)
  96. - 仪表盘
  97. ![](https://oscimg.oschina.net/oscnet/up-c31fb30bce7784318b7c3487e44cd3d928b.png)
  98. ![](https://oscimg.oschina.net/oscnet/up-b945e4d0fed55091cc30b63044cbd6cdee4.png)
  99. - 动画展示
  100. ![](https://oscimg.oschina.net/oscnet/up-49e27699eb278c7c6b6748bfeaeb6c13b72.gif)
  101. ### 功能模块
  102. ```
  103. ├─框架实现
  104. │ ├─APP开发框架搭建
  105. │ ├─登录对接
  106. │ ├─TOKEN接口机制
  107. │ ├─热更新\覆盖更新
  108. ├─基础功能
  109. │ ├─菜单栏目
  110. │ ├─登录页面
  111. │ ├─移动首页
  112. │ ├─个人信息设置
  113. ├─消息中心
  114. │ ├─通讯录
  115. │ ├─系统公告
  116. │ ├─消息推送
  117. │ ├─在线聊天
  118. ├─低代码功能
  119. │ ├─Online表单(列表+表单渲染)
  120. │ ├─仪表盘(移动展示)
  121. ├─示例代码
  122. │ ├─调用摄像头扫码(扫码)
  123. │ ├─获取地理位置(定位)
  124. ├─新增组件
  125. │ ├─页面滚动
  126. │ ├─日历
  127. │ ├─时间选择
  128. │ ├─下拉选择
  129. │ ├─图片上传
  130. ├─。。。
  131. ```