構建
基本編譯和測試
要構建原始碼，你需要安裝 JDK 17。
Spring Cloud 大部分構建相關的活動都使用 Maven。克隆你感興趣的專案並輸入以下命令，你應該能很快開始構建：
$ ./mvnw install
你也可以自己安裝 Maven（>=3.3.3），並在下面的例子中用 mvn 命令代替 ./mvnw。如果這樣做，並且你的本地 Maven 設定不包含 Spring 預釋出構件的倉庫宣告，你可能還需要新增 -P spring 引數。 |
請注意，你可能需要透過設定 MAVEN_OPTS 環境變數來增加 Maven 可用的記憶體，其值類似於 -Xmx512m -XX:MaxPermSize=128m。我們試圖在 .mvn 配置中涵蓋這一點，所以如果你發現必須這樣做才能使構建成功，請提出一個議題，以便將這些設定新增到版本控制中。 |
需要中介軟體（例如 Redis）進行測試的專案通常要求本地安裝並執行 [Docker](www.docker.com/get-started)。
文件
spring-cloud-build 模組有一個“docs” profile，如果你啟用它，它會嘗試使用 Antora 從 modules/ROOT/ 構建 asciidoc 原始檔。
作為該過程的一部分，它會查詢 docs/src/main/asciidoc/README.adoc 並透過載入所有包含檔案來處理它，但不進行解析或渲染，只將其複製到 ${main.basedir}（預設為 ${basedir}，即專案根目錄）。如果在 README 中有任何更改，它將在 Maven 構建後作為修改過的檔案出現在正確的位置。只需提交併推送更改即可。
使用程式碼
如果你沒有特定的 IDE 偏好，我們建議你在使用程式碼時使用 Spring Tools Suite 或 Eclipse。我們使用 m2eclipse Eclipse 外掛來支援 Maven。只要使用 Maven 3.3.3 或更高版本，其他 IDE 和工具也應該正常工作。
啟用 Spring Maven Profile
Spring Cloud 專案需要啟用 'spring' Maven profile 以解析 Spring 里程碑和快照倉庫。請使用你偏好的 IDE 來設定此 profile 為活動狀態，否則你可能會遇到構建錯誤。
使用 m2eclipse 匯入到 Eclipse
我們建議在 Eclipse 中使用 m2eclipse Eclipse 外掛。如果你還沒有安裝 m2eclipse，可以從“eclipse marketplace”獲取。
舊版本的 m2e 不支援 Maven 3.3，因此一旦專案匯入到 Eclipse 中，你還需要告訴 m2eclipse 為專案使用正確的 profile。如果你看到許多與專案 POMs 相關的不同錯誤，請檢查你的安裝是否已更新。如果你無法升級 m2e，請將“spring” profile 新增到你的 settings.xml 檔案中。或者，你可以將父 POM 中“spring” profile 的倉庫設定複製到你的 settings.xml 中。 |
