spring-framework源码编译及导入

环境说明：

时间：2017-09-26

OS name: "mac os x", version: "10.12.4", arch: "x86_64", family: "mac"

Git version：git version 2.11.0 (Apple Git-81)

Maven: Apache Maven 3.3.9

Java version: 1.8.0_121

1. 下载spring-framework源代码

访问spring-framework的Git地址：

　　https://github.com/spring-projects/spring-framework

源码下载URL：

https://github.com/spring-projects/spring-framework.git

git@github.com:spring-projects/spring-framework.git

2. 编译源码

2.1  下载Gradle工具及相关依赖

进入spring-framework下载目录，执行./gradlew

　　

2.2 查看可编译的编译任务

按照指示，可以先查看编译任务有哪些，执行./gradlew tasks

　　

 > Task :tasks

 ------------------------------------------------------------
 All tasks runnable from root project - Spring Framework
 ------------------------------------------------------------

 Build tasks
 -----------
 assemble - Assembles the outputs of this project.
 build - Assembles and tests this project.
 buildDependents - Assembles and tests this project and all projects that depend on it.
 buildNeeded - Assembles and tests this project and all projects it depends on.
 classes - Assembles main classes.
 clean - Deletes the build directory.
 jar - Assembles a jar archive containing the main classes.
 testClasses - Assembles test classes.

 Build scan tasks
 ----------------
 buildScanPublishPrevious - Publishes the data captured by the last build to the build scan server.

 Build Setup tasks
 -----------------
 init - Initializes a new Gradle build.

 Distribution tasks
 ------------------
 depsZip - Builds -dist-with-deps archive, containing everything in the -dist archive plus all runtime dependencies.
 distZip - Builds -dist archive, containing all jars and docs, suitable for community download page.
 docsZip - Builds -docs archive containing api and reference for deployment at http://docs.spring.io/spring-framework/docs.
 schemaZip - Builds -schema archive containing all XSDs for deployment at http://springframework.org/schema.

 Documentation tasks
 -------------------
 api - Generates aggregated Javadoc API documentation.
 asciidoctor - Converts AsciiDoc files and copies the output files and related resources to the build directory.
 dokka - Generates dokka documentation for Kotlin
 groovydoc - Generates Groovydoc API documentation for the main source code.
 javadoc - Generates Javadoc API documentation for the main source code.
 jdiff - Generates a JDiff report

 Help tasks
 ----------
 buildEnvironment - Displays all buildscript dependencies declared in root project 'spring'.
 components - Displays the components produced by root project 'spring'. [incubating]
 dependencies - Displays all dependencies declared in root project 'spring'.
 dependencyInsight - Displays the insight into a specific dependency in root project 'spring'.
 dependencyManagement - Displays the dependency management declared in root project 'spring'.
 dependentComponents - Displays the dependent components of components in root project 'spring'. [incubating]
 help - Displays a help message.
 model - Displays the configuration model of root project 'spring'. [incubating]
 projects - Displays the sub-projects of root project 'spring'.
 properties - Displays the properties of root project 'spring'.
 tasks - Displays the tasks runnable from root project 'spring' (some of the displayed tasks may belong to subprojects).

 IDE tasks
 ---------
 cleanEclipse - Cleans all Eclipse files.
 cleanIdea - Cleans IDEA project files (IML, IPR)
 eclipse - Generates all Eclipse files.
 idea - Generates IDEA project files (IML, IPR, IWS)

 Verification tasks
 ------------------
 check - Runs all checks.
 test - Runs the unit tests.

 Rules
 -----
 Pattern: clean<TaskName>: Cleans the output files of a task.
 Pattern: build<ConfigurationName>: Assembles the artifacts of a configuration.
 Pattern: upload<ConfigurationName>: Assembles and uploads the artifacts belonging to a configuration.

 To see all tasks and more detail, run gradlew tasks --all

 To see more detail about a task, run gradlew help --task <task>

 BUILD SUCCESSFUL in 4s
 1 actionable task: 1 executed

2.3 执行spring的编译任务

上面罗列了很多任务，选择执行build任务，命令如下：./gradlew build

这步会编译整个工程，预计时间为一个多小时，保持网络通畅，就可以去干其他事情了

我这次编译花了53min，编译完成的截图：

　　

2.4 执行导入eclipse的脚本

因为idea可以兼容eclipse的工程，故可以直接执行导入eclipse工程的初始化脚本，当然了，目前也只有eclipse的可用脚本

导入idea只有一个说明文档：import-into-idea.md

准备执行初始化，找到“import-into-eclipse” 的可执行脚本，Windows下是.bat，类Unix系统都是.sh

　　

　　确认本地已经安装了Eclipse开发工具，因为执行这个脚本前需要安装Eclipse，安装完成后

　　执行命令：./import-into-eclipse.sh

　　

　　已经安装了Eclipse，点击Enter键继续，开始第一步编译工具，生成各自工程的metadata文件

　　

　　这步花费时间较长，我本地花费了14min

　　

　　完成后，点击Enter继续，开始第二步工作，导入工程到Eclipse中

　　

　　导入完成后，点击Enter继续，开始第三步工作，生成根目录下的metadata

　　

　　点击Enter继续，开始第四步工作，重新导入工程到Eclipse中

　　至此编译完成并初始化Eclipse工程完成，第五步增加Git支持和分享

　　

　　大功告成，Goodbye！