|
|
@@ -1,12 +1,154 @@
|
|
|
-## 环境
|
|
|
+# JeecgUniapp项目介绍
|
|
|
|
|
|
-- node>=18
|
|
|
-- pnpm>=7.30
|
|
|
-- Vue Official>=2.1.10
|
|
|
-- TypeScript>=5.0
|
|
|
+JeecgUniapp 前端采用 [uniapp](https://uniapp.dcloud.net.cn/)、Vue3.0、Vite、 Wot-design-uni、TypeScript 等新技术方案,包括二次封装组件、路由拦截、请求拦截等功能。实现了与 `JeecgBoot` 完美对接:
|
|
|
+目前已经实现登录、用户信息、通讯录、公告、移动首页、九宫格、聊天等功能,提供了丰富的组件!
|
|
|
|
|
|
-## 快速开始
|
|
|
+当前最新版本: 3.0.0(发布日期:2025-03-17)
|
|
|
+
|
|
|
+
|
|
|
+[](https://github.com/zhangdaiscott/jeecg-boot/blob/master/LICENSE)
|
|
|
+[](http://www.jeecg.com)
|
|
|
+[](https://github.com/zhangdaiscott/jeecg-boot)
|
|
|
+[](https://github.com/zhangdaiscott/jeecg-boot)
|
|
|
+[](https://github.com/zhangdaiscott/jeecg-boot)
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+### 新版特点
|
|
|
+- 一份代码多终端适配,小程序、H5、安卓、ios、鸿蒙Next
|
|
|
+- 学习成本低、组件丰富、兼容性好、支持iframe嵌入
|
|
|
+- 新版APP具备低代码设计能力,包括表单设计、仪表盘设计等
|
|
|
+
|
|
|
+
|
|
|
+### 前端技术栈
|
|
|
+
|
|
|
+- 前端 IDE 建议:Vscode、HBuilderX、Intellij IDEA
|
|
|
+- 最新技术栈:Uniapp + Vue3.0 + Vite + TypeScript + Wot-design-uni + pinia + unocss
|
|
|
+- 依赖管理:node、pnpm
|
|
|
+
|
|
|
+### 环境要求
|
|
|
+
|
|
|
+- 本地环境安装 node(18+)、pnpm (7.3+)
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+### 后台源码下载
|
|
|
+
|
|
|
+- https://github.com/jeecgboot/jeecg-boot
|
|
|
+
|
|
|
+### 技术交流
|
|
|
+
|
|
|
+- 产品官网: [http://jeecg.com/appIndex](http://jeecg.com/appIndex)
|
|
|
+- 开发文档: [https://help.jeecg.com/uniapp3](https://help.jeecg.com/uniapp3)
|
|
|
+- 官方支持: 遇到BUG可以在github上 [发Issue](https://github.com/jeecgboot/jeecg-uniapp/issues/new)
|
|
|
+
|
|
|
+### 快速启动
|
|
|
+
|
|
|
+#### 配置接口地址
|
|
|
+
|
|
|
+> 配置文件:`env/.env.development`
|
|
|
+
|
|
|
+请把 http://localhost:8080/jeecg-boot 的两个地方替换成自己地址,其他不用改。
|
|
|
+
|
|
|
+```javascript
|
|
|
+// 变量必须以 VITE_ 为前缀才能暴露给外部读取
|
|
|
+NODE_ENV = 'development';
|
|
|
+// 是否去除console 和 debugger
|
|
|
+VITE_DELETE_CONSOLE = false;
|
|
|
+// 是否开启sourcemap
|
|
|
+VITE_SHOW_SOURCEMAP = true;
|
|
|
+// 后台接口全路径地址(必填)
|
|
|
+VITE_SERVER_BASEURL = 'http://localhost:8080/jeecg-boot';
|
|
|
+```
|
|
|
+
|
|
|
+#### 启动项目
|
|
|
|
|
|
执行 `pnpm i` 安装依赖
|
|
|
|
|
|
-执行 `pnpm dev` 运行 `H5`
|
|
|
+运行下面命令,运行 `H5`
|
|
|
+
|
|
|
+```javascript
|
|
|
+ pnpm run dev
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
+### 新旧版本对比
|
|
|
+
|
|
|
+| 特性 | 旧版 | 新版 |
|
|
|
+| -------------------- | -------------- |------------------------------------------------|
|
|
|
+| **技术栈** | Vue2,技术陈旧 | Vue3,现代化开发体验 |
|
|
|
+| **UI 框架** | 未集成 | 集成`wot-design-uni` |
|
|
|
+| **编辑器** | 仅限 HbuilderX | 支持 VSCode、Intellij IDEA 等主流编辑器 |
|
|
|
+| **鸿蒙** | 不支持 | 支持鸿蒙系统 |
|
|
|
+| **构建工具** | Webpack | Vite,构建更快 |
|
|
|
+| **Unocss 原子化** | 不支持 | 支持 Unocss 原子化 |
|
|
|
+| **TypeScript 支持** | 不支持 | 支持 TS,提供类型提示 |
|
|
|
+| **基础组件封装** | 较少 | 封装丰富组件(用户、部门、分类字典树、自定义树、popup、popupDict、导航组件等) |
|
|
|
+| **代码片段快捷创建** | 无 | 支持 v3 快速创建页面片段 |
|
|
|
+
|
|
|
+### 入门必备
|
|
|
+
|
|
|
+本项目需要一定前端基础知识,请确保掌握 Vue 的基础知识,以便能处理一些常见的问题。 建议在开发前先学一下以下内容,提前了解和学习这些知识,会对项目理解非常有帮助:
|
|
|
+
|
|
|
+- [Vue3 文档](https://cn.vuejs.org)
|
|
|
+- [Uniapp](https://uniapp.dcloud.net.cn/)
|
|
|
+- [Wot-design-uni](https://wot-design-uni.cn)
|
|
|
+- [Unibest 文档](https://www.unibest.tech)
|
|
|
+- [TypeScript](https://www.typescriptlang.org)
|
|
|
+- [Es6](https://es6.ruanyifeng.com/)
|
|
|
+- [Vitejs](https://vitejs.dev)
|
|
|
+- [Pinia(vuex 替代方案)](https://pinia.esm.dev/introduction.html)
|
|
|
+- [Vue-RFCS](https://github.com/vuejs/rfcs)
|
|
|
+- [UnoCSS](https://unocss.dev)
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+### 效果预览
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+### 功能模块
|
|
|
+```
|
|
|
+├─框架实现
|
|
|
+│ ├─APP开发框架搭建
|
|
|
+│ ├─登录对接
|
|
|
+│ ├─TOKEN接口机制
|
|
|
+│ ├─热更新\覆盖更新
|
|
|
+├─基础功能
|
|
|
+│ ├─菜单栏目
|
|
|
+│ ├─登录页面
|
|
|
+│ ├─移动首页
|
|
|
+│ ├─个人信息设置
|
|
|
+├─消息中心
|
|
|
+│ ├─通讯录
|
|
|
+│ ├─系统公告
|
|
|
+│ ├─消息推送
|
|
|
+│ ├─在线聊天
|
|
|
+├─低代码功能
|
|
|
+│ ├─Online表单(列表+表单渲染)
|
|
|
+│ ├─仪表盘(移动展示)
|
|
|
+├─示例代码
|
|
|
+│ ├─调用摄像头扫码(扫码)
|
|
|
+│ ├─获取地理位置(定位)
|
|
|
+├─新增组件
|
|
|
+│ ├─页面滚动
|
|
|
+│ ├─日历
|
|
|
+│ ├─时间选择
|
|
|
+│ ├─下拉选择
|
|
|
+│ ├─图片上传
|
|
|
+├─。。。
|
|
|
+```
|