You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tanghe-report/doc/docs/guide/搭建AJ-Report-开发环境.md

245 lines
6.0 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

**搭建aj-report开发环境**
# 工具版本
参考
[Mysql] 5.7
[Jdk] 1.8
[Spring Boot] 2.3.5
[Mybatis-plus] 3.3.2
[flyway] 5.2.1
[Apache Maven] 3.5
[Node.js] 14.16.0
[Windows 10]
实际
Mysql 5.7.34
JDK 1.8u291
IdeaJ 2020.2.1
Spring Boot DTD
Maven 3.5.4
Windows7
Git 2.33.0 x64
Node 13.14.0-x64
Vscode 1.59.0
# 环境准备
共分前端、公共、后端。
## 后端
### Mysql
下载mysql数据库
下载地址
<https://dev.mysql.com/downloads/installer/>
步骤【选择安装类型】即Choosing a Setup Type选择【仅服务器】即Server
only
步骤【类型和网络】即Type and Networking选择【开发电脑】即Development
Computer
步骤【账户和角色】即Account and Rolesroot密码设置为root。
步骤【Windows服务】即Windows
Service勾选【配置MySQL服务作为一个Windows服务】即Configure MySQL Server as
a Windows Service
除以上外,都采用默认,一直下一步,直至安装完成。
### JDK
采用默认安装,一直下一步,直至完成。
配置环境变量
JAVA_HOME C:\\Program Files\\Java\\jdk1.8.0_291
### IdeaJ
采用默认安装,一直下一步,直至完成。
### Maven
下载地址
https://dlcdn.apache.org/maven/maven-3/3.5.4/binaries/
将压缩包解压到路径C:\\Program Files\\
添加环境变量M2_HOME C:\\Program Files\\apache-maven-3.5.4
旧版变量写法MAVEN_HOME
调整Path环境变量增加 ;%M2_HOME%C:\\bin
### 插件
IdeaJ安装spring boot开发插件
已自带,不用再安装。
安装lombok
## 公共
### Git
#### 安装
采用默认安装,一直下一步,直至完成。
#### 拉代码
为idea指定git路径
默认情况下IDEA是不自带git运行程序的所以需要通过
菜单-\>settings-\>Version Control-\>Git-\>Path to Git executable:
设置为安装git中所安装的git.exe
获取gitee上面的要拉取项目的url即页面左上方【可隆/下载】单击选择【复制】即可获得url。
在ideaj中选择路径file -\> new -\> Project from Version Control -\> Git
将url复制到URL后的方框
选择本地目录即Directory
点击【Clone】开始拉代码。
## 前端
### Node
采用默认安装,一直下一步,直至完成。
### Vscode
步骤【选择附件任务】勾选【添加到PATH重启后生效
其余采用默认安装,一直下一步,直至完成。
# 开发环境
## 后端
新建文件夹用于存放后端代码C:\\ijproj将git下载的代码解压至该目录。
### 下载源码
具体步骤见Git2.2.1.2拉代码
### 依赖插件
下载依赖和插件。Git完代码后会自动下载依赖和插件。如果pom中的依赖和插件爆红。可设置mavenFile
——\> Settings。找到Maven相关的三项设置包括Maven home directory、User
settings file、Local repository可直接使用默认设置。
遇到个别顽固爆红的依赖和插件,可以直接在本地资料库.m2\\repository中查找确认是否已经下载。确认已经下载的话则可以尝试在该依赖或者插件中增加版本号与资料库中的一致org.springframework.boot对应的路径
资料库路径\\org\\springframework\\bootspring-boot-maven-plugin对应上述路径的子文件夹spring-boot-maven-plugin此文件夹即spring-boot-maven-plugin的子文件夹是版本号2.3.5.RELEASE打开2.3.5.RELEASE就是对应的jar包等内容
### 设置Mysql
设置好mysql以便运行时自动进行初始化。
配置文件路径:/src/main/resources/bootstrap.yml在此文件中找到datasource
mysql的配置信息修改IP地址为mysql所在机器的IP调整用户密码。本文中为本地即localhost或者用127.0.0.1用户为root密码为root。
### 运行后端
确认启动了Mysql服务
然后运行后端程序
## 前端
### 下载源码
新建文件夹C:\\vsproj用于存放前端项目源码
下载源码在vscode使用【ctrl】+【\`】或者【Terminal】-\>【New
Terminal】。用cd命令进入相应的文件夹。
执行git clone https://gitee.com/anji-plus/report.git拉代码。
### 设置环境
调整配置文件配置文件路径REPORT-UI/config/dev.env.js调整BASE_API后URL地址中的IP、端口。若都在同一台电脑直接使用IP127.0.0.1端口使用默认9095。
连接后端的IP改为后端API代码所在的IP、所使用的端口。
### 编译运行
在vscode使用【ctrl】+【\`】或者【Terminal】-\>【New
Terminal】。用cd命令进入前端代码文件夹执行如下命令
命令一cd C:\\vsproj\\report\\report-ui
命令二npm init -y
命令三npm install
命令四npm run dev
命令四执行后启动了前端在浏览器中输入http://localhost:9528/\#/login
## 启动
启动顺序:确保数据库启动、确保后端启动、最后启动前端
1确保mysql已经启动
2运行后端代码
3运行前端代码
4浏览器输入http://localhost:9528/\#/login
用户admin
密码123456
# 错误
## 问题一
遇到Error creating bean with name 'flywayInitializer' defined in class path
resource解决办法
将这个Resolved
locally后面的**版本号复制**下来,连着符号一起复制,然后找到你数据库中的**flyway_schema
\_history**这个表,在最下面那一行数据中把刚刚复制的版本号替换进去就可以了。
## 问题二
问题现象:报表设计界面中看不到图表,
查看日志Access denied for user 'ajreport'@'localhost' (using password: YES)
在系统【数据源】中调整设置将IP、用户、密码等调整为在用的。
默认用户ajreport密码ajreport
改为初始化时的用户root密码root