前言
闲来无事试着从GitHub上拉取SpringBoot源码。然鹅,在本地IDEA打开后,爆各种编译错误,各种问题。经过反复操作,现在总结一下SpringBoot源码环境搭建的实践,便于后期对于源码的学习。
Github上SpringBoot源码的开源地址:https://github.com/spring-projects/spring-boot
1、环境准备
项目/工具 | 版本 |
SpringBoot | 2.1.x |
maven | 3.5.4 |
JDK | 1.8.0 |
IDEA | 2018.x |
2、Fork源码
这里,我们可以将Git上这个开源的SpringBoot源码项目Fork到自己的Github仓库里。这样,后期自己在上边做笔记,或者各种的测试都可以直接提交到个人的仓库上,随意造作。看截图红框,(1)Fork源码到本地仓库;(2)源码版本选择。
3、Clone源码
将源码的Git地址复制到IDEA中,这里一定要确认已经安装了Maven3.5.0以上的版本,低版本在编译时,Maven插件会报错。
4、配置maven镜像源
为了加速下载所有的依赖 jar 包,我们先找到E:\maven\apache-maven-3.5.4\conf\setting.xml这个文件,然后在mirrors标签里粘贴如下内容。
<mirrors>
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Nexus aliyun</name>
<url> http://maven.aliyun.com/nexus/content/groups/public </url>
</mirror>
</mirrors>
注意:配置完maven镜像源目的是为了后边下载jar包,有时候会下载失败。
5、修改spring-boot项目的pom.xml文件
这里我们先将未编译的源码放在IDEA中看一下,需要修改校验属性。注意,这里先不要在maven的配置中点击clean/install源码,会报错,所有的依赖包都是一片红线。
OK,先在属性标签中加入如下内容:
<disable.checks>true</disable.checks>
源码的结构如下:
接下来,我们需要对拉下来的源码进行编译。
6、编译Spring-Boot源码
进入源码项目所在的根目录,准备编译。
注意:编译执行的过程有一下几种方式,本地所使用的Maven版本:apache-maven-3.5.4。
【方式1】使用mvn clean install 编译项目(跳过测试部分的内容进行编译)
mvn clean install -DskipTests -Pfast
【方式2】使用mvn clean install 编译项目
mvn -Dmaven.test.skip=true clean install
参数说明:
-Dmaven.test.skip=true:表示执行上边这条命令在打包过程中将会忽略testcase,因为源码编译耗时非常漫长,中间也可能会爆一堆异常Error。
【方式3】使用 mvnwrapper 编译项目
先执行:
mvn -N io.takari:maven:wrapper
然后执行:
./mvnw clean install -DskipTests -Pfast
这里,我们采用方式1的指令跳过测试部分进行编译。第一次编译,耗时15min左右,如果编译成功,我们能够看到如下打印信息:
注意:
【1】上边的命令执行编译2.1.x以下版本源码是成功的,但是去编译2.2.x版本源码时一直编译不过,暂时没搞明白咋回事。
【2】配置完maven镜像源后,使用上边命令编译,有时候会下载/编译失败。出现异常就暴力点,直接将本地仓库删干净,重新编译即可。
7、IDEA导入源码及测试
源码导入IDEA后,我们还需要测试一下,记得将IDEA的 Maven 版本选择3.5.4,JDK选8以上的。这里,并没有使用maven默认的仓库,所以勾选使用自定义安装的maven配置文件和本地仓库。
【1】选取项目里的一个单元测试运行一下启动程序。
这里,在spring-boot-tests项目中,随便选了spring-boot-launch-script-tests项目下的LaunchScriptTestApplication.java这个启动类。点击运行,看看启动效果。
可以看到,已经启动成功,说明我们的spring-boot源码已经编译成功。接下来,将创建一个demo项目测试一下。
【2】创建一个子模块demo项目,引入编译的源码进行测试。