管理 Java 套件

Artifact Registry 支援您使用 Maven 和 Gradle 建構的 Java 套件。

總覽

如要熟悉 Artifact Registry 中的 Java 套件，請試試快速入門。

如要進一步瞭解，請參閱以下資訊：

  1. 為套件建立 Java 套件存放區。
  2. 瞭解如何建立遠端和虛擬存放區。
  3. 請參閱這個存放區使用範例，瞭解如何使用遠端和虛擬存放區。
  4. 將權限授予將連結至存放區的帳戶。與 Artifact Registry 的常見整合服務帳戶，會針對同一個專案中的存放區提供預設權限。
  5. 設定工具：
  6. 瞭解如何管理套件。

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 不支援非唯一版本模型，因此建議您使用不重複的版本。