spring-framework源代码编译

2019-01-12 本文已影响0人 oneape15

环境准备

今天头脑一热，想把spring-framework的源代码编译一下，拿出说干就干的精神开始吧！
Spring Framework使用的是Gradle进行编译的。
编译Spring Framework的前期准备如下：

电脑一台（我这里以MacOS系统为例）；
JDK8 及以上版本；
Git 工具, 直接从github上下载源码；
Gradle 4.0以上版本；

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说实话，对于国内的开发者来说，还不是很友好的。各种资源下载问题，必须通过翻墙来解决。