环境准备
今天头脑一热,想把spring-framework的源代码编译一下,拿出说干就干的精神开始吧!
Spring Framework使用的是Gradle进行编译的。
编译Spring Framework的前期准备如下:
gradle安装
我们现在使用的maven比较多,这里我简单的介绍一下gradle的安装。
首先,我们到https://services.gradle.org/distributions/ 这个网址上下载一个最新的可安装包;
我们给下载好的zip解压,安装;这里的安装比较简单,只要把zip包触压,然后放到指定目标下,再修改一下配置文件即可。
$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-4.10.2-bin.zip
$ ls /opt/gradle/gradle-4.10.2
LICENSE NOTICE bin getting-started.html init.d lib media
上面我把gradle触压放到了/opt/gradle
下
然后配置PATH
环境参数,Windows的与Linux,MacOS的稍有不同。下面我以Linux&MacOS的配置为例,找到当前用户下的.bash_profile文件,在文件未尾添加如下信息即可:
$ export PATH=$PATH:/opt/gradle/gradle-4.10.2/bin
最终的环境如下:
环境参数图
在此期间,gradle下载花费了近一个小时,有些表示不解~~~
极简方法
使用brew
安装, brew install gradle
接下来的就是等待了
遇到的问题
我本机上已经使用brew安装了一个版本4.10.2的gradle,然后我又手动安装了5.1.1的gradle,然后通过gradle -v
命令查看安装的版本号时,发现一直是brew安装的,其中折腾半天,才搞明白~~
获取源代码
我们直接在github上找到spring的项目组,然后使用git获取spring-framework的源代码到本地:
git clone git@github.com:spring-projects/spring-framework.git
cd spring-framework
现在我们已经把代码git下来了
命令行编译
从命令行进入文件,我这里选择一个比较稳定的分支5.0.x
,你们可以根据喜好,选择主干,或者其他的分支;
运行命令
./gradlew build
结果如下:
- Could not find io.spring.gradle:propdeps-plugin:0.0.8.
- Could not resolve io.spring.gradle:docbook-reference-plugin:0.3.1.
居然失败了~~~
我们看到有依赖的某个组件没一download下来(估计我这里被墙了),那我们换一下gradle的仓库地址
我这里采用了全局配置的方式,在gradle的本地仓库(我电脑上的为~/.gradle
目录)中, 添加阿里的私服地址,配置如下(你可以复制到你的文件中):
allprojects{
repositories {
def ALIYUN_REPOSITORY_URL = 'http://maven.aliyun.com/nexus/content/groups/public'
def ALIYUN_JCENTER_URL = 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
all { ArtifactRepository repo ->
if(repo instanceof MavenArtifactRepository){
def url = repo.url.toString()
if (url.startsWith('https://repo1.maven.org/maven2')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_REPOSITORY_URL."
remove repo
}
if (url.startsWith('https://jcenter.bintray.com/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_JCENTER_URL."
remove repo
}
if (url.startsWith('https://plugins.gradle.org/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_REPOSITORY_URL."
remove repo
}
}
}
maven {
url ALIYUN_REPOSITORY_URL
url ALIYUN_JCENTER_URL
}
}
}
重新运行./gradlew build
,可以了,接下来就是漫长的等待,下载各种依赖jar包
以下是部分运行截图:
建议:
- 如果能翻墙的同学,就翻墙吧,这样你就会省很多麻烦事;
- 运行
./gradlew build
中途会出现多次失败,重复运行准没错;
遇到的问题
- 如果你的gradle是刚安装的,本地仓库相对来说没有下过什么依赖,那么这个编译将持续几个小时(我是晚上10点多开始编译的,等到12点还在下载各种依赖jar包)。
- 中途运行test 脚本时,始终失败,没有办法只能直接跳过测试用例,执行:
./gradlew build -x test
- 期间dokka执行一直出错,原来翻墙的没有打开,打开再次运行就好了;
哭奔相告
spring-framework编译过程一路坎坷,从晚上10点开始就遇到各种问题,最终在第二天早上看到了如下编译成功的界面,哈哈~~~
编译成功
看到了BUILD SUCCESSFUL in 7m 1s
了吧,期中的7m 1s
就不要看了,不知花了多少个7分钟了~~
编译感悟
期间遇到了各种各样的问题,gradle说实话,对于国内的开发者来说,还不是很友好的。各种资源下载问题,必须通过翻墙来解决。
网友评论