235 lines
8.4 KiB
Markdown
235 lines
8.4 KiB
Markdown
JEECG BOOT 低代码开发平台（Vue3前端）
|
||
===============
|
||
当前最新版本： 3.8.0（商业版）
|
||
|
||
[](https://github.com/zhangdaiscott/jeecg-boot/blob/master/LICENSE)
|
||
[](http://www.jeecg.com)
|
||
[](https://jeecg.blog.csdn.net)
|
||
[](https://github.
|
||
com/zhangdaiscott/jeecg-boot)
|
||
[](https://github.com/zhangdaiscott/jeecg-boot)
|
||
[](https://github.com/zhangdaiscott/jeecg-boot)
|
||
|
||
|
||
商业协议说明
|
||
-----------------------------------
|
||
|
||
JeecgBoot商业版 是由 北京国炬信息技术有限公司 发行的软件。 总部位于北京，地址：中国·北京·朝阳区科荟前街1号院奥林佳泰大厦。邮箱：jeecgos@163.com
|
||
本软件受适用的国家软件著作权法（包括国际条约）和商业合同 双重保护许可。
|
||
|
||
- 1.JeecgBoot商业版本，需要购买商业授权才可使用。
|
||
- 2.购买授权的企业，允许基于本平台软件开展业务系统开发。
|
||
- 3.不得基于该平台软件的基础，修改包装成一个与JeecgBoot平台软件功能类似的产品进行发布、销售，或与JeecgBoot参与同类软件产品市场的竞争。
|
||
违反此条款属于侵权行为，须赔偿侵权经济损失，同时立即停止著作权侵权行为。
|
||
- 4.保密义务：JeecgBoot商业版本，禁止盗卖、泄露、传播商业源码和商业资料，双方签订合同有保密协议，违者收回商业授权，并追究法律责任
|
||
- 5.盗版举报：禁止盗版买卖，违者必究，举报邮箱 jeecgos@163.com
|
||
|
||
##### 解释权归：
|
||
- http://www.jeecg.com
|
||
- http://guojusoft.com
|
||
|
||
```
|
||
<developers>
|
||
<developer>
|
||
<name>北京国炬信息技术有限公司</name>
|
||
<email>jeecgos@163.com</email>
|
||
</developer>
|
||
<developer>
|
||
<name>授权对象(合作企业): 中国船舶集团有限公司第七〇四研究所</name>
|
||
<email>授权范围：贵司通过商业合作，获得商业产品的使用权，但商业版源码、资料禁止传播、盗卖，违者必究！！！</email>
|
||
</developer>
|
||
</developers>
|
||
```
|
||
|
||
|
||
## 简介
|
||
JeecgBoot-Vue3采用 Vue3.0、Vite、 Ant-Design-Vue3、TypeScript 等新技术方案，包括二次封装组件、utils、hooks、动态菜单、权限校验、按钮级别权限控制等功能。
|
||
是采用Vben实现的 JeecgBoot低代码平台的全新vue3版本。
|
||
|
||
> 强大的代码生成器让前后端代码一键生成! JeecgBoot引领低代码开发模式(OnlineCoding-> 代码生成-> 手工MERGE)， 帮助解决Java项目70%的重复工作，让开发更多关注业务。既能快速提高效率，节省成本，同时又不失灵活性
|
||
|
||
## 技术支持
|
||
|
||
关闭Gitee的issue通道，使用中遇到问题或者BUG可以在 [Github上提Issues](https://github.com/jeecgboot/jeecgboot-vue3/issues/new)
|
||
|
||
官方支持： http://jeecg.com/doc/help
|
||
|
||
|
||
|
||
##### 项目说明
|
||
|
||
| 项目名 | 说明 |
|
||
|--------------------|------------------------|
|
||
| `jeecgboot-vue3` | Vue3版前端代码 |
|
||
| `jeecg-boot` | SpringBoot后台项目（支持微服务） |
|
||
|
||
## 开发环境搭建
|
||
|
||
- [前端开发环境准备](https://help.jeecg.com/setup/dev.html)
|
||
- [前端项目快速启动](https://help.jeecg.com/setup/startup.html)
|
||
- [通过IDEA启动项目](https://help.jeecg.com/java/setup/idea/startup.html)
|
||
|
||
## 技术文档
|
||
|
||
- 官方文档：[http://help.jeecg.com](http://help.jeecg.com)
|
||
- 官方网站： [http://www.jeecg.com](http://www.jeecg.com)
|
||
- 快速入门：[快速入门](http://jeecg.com/doc/quickstart) | [常见问题](http://help.jeecg.com/qa.html) | [视频教程](https://www.bilibili.com/video/BV1V34y187Y9 "入门视频") | [ 代码生成](http://help.jeecg.com/vue3/codegen/online.html)
|
||
- 在线演示 ： [Vue3演示](http://boot3.jeecg.com) | [APP演示](http://jeecg.com/appIndex)
|
||
> 演示系统的登录账号密码，请点击 [获取账号密码](http://jeecg.com/doc/demo) 获取
|
||
|
||
|
||
## 安装与使用
|
||
|
||
|
||
#### 前端环境要求
|
||
|
||
* 本地环境安装 `Node.js 、npm 、pnpm`
|
||
* Node.js 版本建议`v20.15.0`，要求`Node 18+ / 16+` 版本以上
|
||
` ( 因为Vite5 不再支持已 EOL 的 Node.js 14 / 16 / 17 / 19，现在需要 Node.js 18 / 20+ )`
|
||
|
||
|
||
- Get the project code
|
||
|
||
```bash
|
||
git clone https://github.com/jeecgboot/jeecgboot-vue3.git
|
||
```
|
||
|
||
- Installation dependencies
|
||
|
||
```bash
|
||
cd jeecgboot-vue3
|
||
|
||
pnpm install
|
||
```
|
||
|
||
- 配置接口地址 `.env.development`
|
||
|
||
```bash
|
||
VITE_PROXY = [["/jeecgboot","http://localhost:8080/jeecg-boot"],["/upload","http://localhost:3300/upload"]]
|
||
VITE_GLOB_DOMAIN_URL=http://localhost:8080/jeecg-boot
|
||
```
|
||
|
||
> 说明：把`http://localhost:8080/jeecg-boot` 换成自己地址，其他不用改。
|
||
|
||
|
||
- run
|
||
|
||
```bash
|
||
pnpm serve
|
||
```
|
||
|
||
|
||
- build
|
||
|
||
```bash
|
||
pnpm build
|
||
```
|
||
|
||
|
||
## Docker镜像启动前端(单体模式)
|
||
|
||
- host设置
|
||
|
||
>注意： 需要把`127.0.0.1`替换成真实IP 比如`192.`开头,不然后端不通。
|
||
|
||
```bash
|
||
127.0.0.1 jeecg-boot-system
|
||
127.0.0.1 jeecg-boot-gateway
|
||
```
|
||
|
||
|
||
- 下载项目
|
||
|
||
```bash
|
||
git clone https://github.com/jeecgboot/jeecgboot-vue3.git
|
||
|
||
cd jeecgboot-vue3
|
||
```
|
||
|
||
- 配置接口域名 `.env.production`
|
||
|
||
```bash
|
||
VITE_GLOB_API_URL=/jeecgboot
|
||
VITE_GLOB_DOMAIN_URL=http://jeecg-boot-system:8080/jeecg-boot
|
||
```
|
||
后台单体启动 [见此文档](https://help.jeecg.com/java/setup/docker/up.html)
|
||
|
||
- 编译项目
|
||
|
||
```bash
|
||
pnpm install
|
||
|
||
pnpm build
|
||
```
|
||
|
||
- 启动容器
|
||
```bash
|
||
docker build -t jeecgboot-vue3 .
|
||
docker run --name jeecgboot-vue3-nginx -p 80:80 -d jeecgboot-vue3
|
||
```
|
||
|
||
- 访问前台
|
||
|
||
http://localhost
|
||
|
||
## Docker镜像启动前端(微服务模式)
|
||
> 这里只写与单体的区别步骤
|
||
|
||
- 区别1. 修改后台域名
|
||
.env.production
|
||
|
||
```bash
|
||
VITE_GLOB_API_URL=/jeecgboot
|
||
VITE_GLOB_DOMAIN_URL=http://jeecg-boot-gateway:9999
|
||
```
|
||
|
||
后台微服务启动 [见此文档](https://help.jeecg.com/java/springcloud/docker.html)
|
||
|
||
- 区别2. 修改Dockerfile文件
|
||
|
||
```bash
|
||
- 把`http://jeecg-boot-system:8080/jeecg-boot`替换成 `http://jeecg-boot-gateway:9999`
|
||
- 把`jeecg-boot-system`替换成 `jeecg-boot-gateway`
|
||
```
|
||
|
||
- 其他与单体模式一样
|
||
|
||
```bash
|
||
镜像需要重现构建，最好把单体的镜像删掉，重新构建docker镜像。
|
||
```
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 入门必备
|
||
|
||
本项目需要一定前端基础知识，请确保掌握 Vue 的基础知识，以便能处理一些常见的问题。 建议在开发前先学一下以下内容，提前了解和学习这些知识，会对项目理解非常有帮助:
|
||
|
||
* [JeecgBoot-Vue3文档](http://help.jeecg.com)
|
||
* [Vue3 文档](https://cn.vuejs.org/)
|
||
* [Vben文档](https://doc.vvbin.cn)
|
||
* [Ant-Design-Vue](https://www.antdv.com/docs/vue/introduce-cn/)
|
||
* [TypeScript](https://www.typescriptlang.org/)
|
||
* [Vue-router](https://router.vuejs.org/zh)
|
||
* [Es6](https://es6.ruanyifeng.com/)
|
||
* [Vitejs](https://cn.vitejs.dev/guide/)
|
||
* [Pinia(vuex替代方案)](https://pinia.esm.dev/introduction.html)
|
||
* [Vue-RFCS](https://github.com/vuejs/rfcs)
|
||
* [Vue2 迁移到 3](https://v3.vuejs.org/guide/migration/introduction.html)
|
||
* [vxetable文档](https://vxetable.cn)
|
||
* [~~WindiCss~~](https://windicss.netlify.app/)
|
||
|
||
|
||
## 浏览器支持
|
||
|
||
**本地开发**推荐使用`Chrome 最新版`浏览器，**不支持**`Chrome 90`以下版本。
|
||
|
||
**生产环境**支持现代浏览器，不支持 IE。
|
||
|
||
| [](http://godban.github.io/browsers-support-badges/)IE | [](http://godban.github.io/browsers-support-badges/)Edge | [](http://godban.github.io/browsers-support-badges/)Firefox | [](http://godban.github.io/browsers-support-badges/)Chrome | [](http://godban.github.io/browsers-support-badges/)Safari |
|
||
| --- | --- | --- | --- | --- |
|
||
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
|