Artifact Registry 支援您使用 Maven 和 Gradle 建構的 Java 套件。
總覽
如要熟悉 Artifact Registry 中的 Java 套件,請試試快速入門。
如要進一步瞭解,請參閱以下資訊:
- 為套件建立 Java 套件存放區。
- 瞭解如何建立遠端和虛擬存放區。
- 請參閱這個存放區使用範例,瞭解如何使用遠端和虛擬存放區。
- 將權限授予將連結至存放區的帳戶。與 Artifact Registry 的常見整合服務帳戶,會針對同一個專案中的存放區提供預設權限。
- 設定工具:
- 為 Maven 或 Gradle 設定驗證機制。
- 如果您想使用 sbt 做為 Scala 和 Java 的建構工具,而非使用 Maven 或 Gradle,則可使用社群建立的 sbt 外掛程式。本文件不會說明 Scala 用戶端的設定或用法。
- 設定 Cloud Build,上傳及下載套件。
- 瞭解如何部署至 Google Cloud 執行階段環境。
- 瞭解如何管理套件。
Maven 快照和發布版本
Maven 會區分 Maven 專案的快照和發布版本。
快照
快照是 Java 專案的預先發布版。快照的版本號碼會包含專案物件模型 (POM) 中的後置字串 -SNAPSHOT
。舉例來說,pom.xml
檔案中的這項設定適用於正在開發中的專案 1.0
版本:
<version>1.0-SNAPSHOT</version>
當您從這個專案發布套件時,Maven 3 會自動在快照版本號碼中附加時間戳記,讓每個快照版本皆為獨一無二。Maven 2 支援非唯一的快照版本,可用於覆寫存放區中現有的快照。這種做法會影響建構的可重現性,因此 Maven 3 不再支援非唯一的快照。
快照可讓您以逐步的方式發布預發布套件的更新版本,而無須每次發布至存放區時,在 Maven 專案中遞增版本編號。在開發期間,其他依附於套件的專案就能從存放區取得 1.0
版本的最新快照。
如要進一步瞭解 Maven 版本號碼語法和排序順序,請參閱版本順序規範。
版本
準備發布套件時,請從 POM 檔案的版本號碼中移除 -SNAPSHOT
字尾,並更新任何依附於套件的專案,以便使用發布版本而非快照版本。
如要列出所有快照依附元件,您可以使用下列指令篩選依附元件樹狀結構:
mvn dependency:tree -Dincludes=:::*-SNAPSHOT
Artifact Registry 版本政策
在 Artifact Registry 中建立 Maven 存放區時,您可以指定 Maven 版本政策:
- 無 - 同時儲存快照和發布套件。這是預設設定。
- 快照:僅儲存快照套件。
- 發布:僅儲存發布套件。
如果您選擇快照版本政策,還可以指定存放區是否允許重複快照版本覆寫存放區中的相符版本。由於 Maven 3 不支援非唯一版本模型,因此建議您使用不重複的版本。