取得Spring Framework的離線資訊

這年頭Spring Framework的離線文件，越來越難取得。記得以前是一個URL，直接下載就行，前幾年，使用了Ant；需要下載了source code之後後再自行編譯。現在由於相關的dependency越來越多，就連deploy的工具與方法，也越來越專業。

目前 【 2014/03/27 】 取得Spring Framework的文檔，流程如下：

0.1 你需要先安裝Maven。

1. 進入Spring 文件首頁，導頁到GitHub。

http://spring.io/docs

圖檔取自Spring Framework 

如果知道Spring文件的GitHub連結，也可以直接連過去。

2. 使用GitHub下載相關程式。

這裡注意需要指定你所想行的版本。如果讀者有使用Git，也可以自行使用Git下載。我則是直接使用Zip下載。

圖檔取自GitHub

3. 使用Gradle產生想要的文件。

Gradle是最幾年興起的檔案部署工具。他的功能與Maven很像。這裡主要是執行gradlew.bat這個檔。請注意這個執行檔多加了一個 "w" 。

執行以下指令:

gradlew api
gradlew reference
gradlew javadoc

於是你可以在 build 目錄中找到reference、api文件。

【 延伸 1】

你可以執行以下指令試試看其他的任務。

gradlew tasks

【延伸2】

在產生reference pdf 文件時，發生OutOfMemory的錯誤。讀者可以在gradlew.bat中更改記憶體參數設定。

set GRADLE_OPTS=-XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=512m %GRADLE_OPTS%