建置

基本編譯與測試

若要建置原始碼,您需要安裝 JDK 17。

Spring Cloud 針對大多數建置相關活動使用 Maven,您應該可以透過複製您感興趣的專案並輸入以下指令快速上手

$ ./mvnw install
您也可以自行安裝 Maven (>=3.3.3) 並在以下範例中使用 mvn 命令來取代 ./mvnw。如果您這麼做,您的本機 Maven 設定未包含 Spring 預發行版本的構件儲存庫宣告,則可能還需要新增 -P spring
請注意,您可能需要透過設定 MAVEN_OPTS 環境變數(值類似 -Xmx512m -XX:MaxPermSize=128m)來增加 Maven 可用的記憶體量。我們嘗試在 .mvn 設定中涵蓋這一點,因此如果您發現必須這樣做才能使建置成功,請提出工單以將設定新增至原始碼控制。

需要中介軟體(即 Redis)進行測試的專案通常需要安裝並執行 [Docker] (www.docker.com/get-started) 的本機執行個體。

文件

spring-cloud-build 模組具有 "docs" Profile,如果您開啟它,它將嘗試使用來自 modules/ROOT/Antora 建置 asciidoc 來源。

作為該過程的一部分,它將尋找 docs/src/main/asciidoc/README.adoc 並處理它,方法是載入所有包含的檔案,但不剖析或呈現它,僅將其複製到 ${main.basedir}(預設為 ${basedir},即專案的根目錄)。如果 README 中有任何變更,則在 Maven 建置後,它將在正確的位置顯示為已修改的檔案。只需提交並推送變更即可。

程式碼操作

如果您沒有 IDE 偏好,我們建議您在使用程式碼時使用 Spring Tools SuiteEclipse。我們使用 m2eclipse eclipse 外掛程式來支援 Maven。其他 IDE 和工具也應該可以正常運作,只要它們使用 Maven 3.3.3 或更高版本。

啟用 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。如果您看到許多與專案中的 POM 相關的不同錯誤,請檢查您是否安裝了最新版本。如果您無法升級 m2e,請將 "spring" Profile 新增到您的 settings.xml。或者,您可以將父 POM 的 "spring" Profile 中的儲存庫設定複製到您的 settings.xml

不使用 m2eclipse 匯入到 Eclipse

如果您不想使用 m2eclipse,可以使用以下命令產生 Eclipse 專案中繼資料

$ ./mvnw eclipse:eclipse

可以從 file 選單中選取 import existing projects 來匯入產生的 Eclipse 專案。