共用方式為

使用來自 Maven Central 的套件

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

使用 Azure Artifacts 上游來源可讓您使用單一饋送來承載您所產生的套件以及來自 Maven Central 等公共註冊表的套件。 當您將上游來源新增至摘要時，Azure Artifacts 會儲存從上游安裝的任何套件複本。 這可確保您的開發環境持續可存取，即使公共註冊表發生中斷也不受影響。 此外，Azure Artifacts 支援各種其他 Maven 上游來源，包括 Google Maven 存放庫、Gradle 外掛程式和 JitPack。

必要條件

注意

Maven 上游來源不支援 Maven 快照集。

啟用上游來源

如果您還沒有資訊流，請遵循這些指示來建立一個資訊流，並確保您勾選 上游來源 複選框來啟用它們。 如果您已經有資料流，請移至 下一個步驟 ，將 Maven Central 新增為上游來源。

  1. 登入您的 Azure DevOps 組織，並流覽至您的專案。

  2. 選取 工件，然後選取 建立提要。

  3. 為您的 Feed 提供 名稱，選擇 Visibility 選項以定義誰可以查看您的套件，若您希望包含來自一般公共來源如 nuget.org 或 npmjs.com的套件，請勾選 [包含來自一般公用來源的套件]，針對 範圍，請決定摘要應限定於您的專案或整個組織。

  4. 完成後，選擇[建立]。

    此螢幕快照顯示在 Azure DevOps Services 中建立新摘要的選項。

  1. 登入您的 Azure DevOps 伺服器，然後移至您的專案。

  2. 選取 [工件]，然後選取 [建立饋送]。

  3. 為您的 Feed 提供 名稱，選擇 Visibility 選項以定義誰可以查看您的套件，若您希望包含來自一般公共來源如 nuget.org 或 npmjs.com的套件，請勾選 [包含來自一般公用來源的套件]，針對 範圍，請決定摘要應限定於您的專案或整個組織。

  1. 完成後，選取建立。

    此螢幕快照顯示在 Azure DevOps 2022 中建立新摘要的選項。

  1. 完成後，選取 建立。

    此螢幕快照顯示在 Azure DevOps 2020 中建立新摘要的選項。

注意

根據預設，新建立的摘要會將其專案的 [建置服務] 值設定為 [摘要] 和 [上游讀取器] （共同作業者）。

新增 Maven Central 上游

如果您在建立摘要時核取了 上游來源 複選框，Maven Central 應該已經新增為上游來源。 如果沒有，您可以使用下列步驟手動新增它：

  1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

  2. 選取 [工件]，然後選取位於右上角的 齒輪圖示，以流覽至您的 動態設定。

  3. 選取 [上游來源]，然後選取 [ 新增上游]。

  4. 選取 [公用來源]，從下拉功能表中選取 [Maven Central]https://repo.maven.apache.org/maven2/，然後選取 [完成時新增]。

    顯示如何新增 Maven 中央上游來源的螢幕快照。

  5. 選取 右上角的 [儲存 ] 以儲存變更。

    顯示如何儲存上游來源的螢幕快照。

從 Maven Central 下載套件

在從 Maven Central 儲存套件之前，請確定您已設定專案以連線到您的饋送。 如果您尚未這麼做，請遵循專案設置中的指示來設定您的 Maven 專案並連線到您的資料饋入。

在此範例中，我們將從 Maven Central 儲存 Kotlin 日期時間庫。

  1. 瀏覽到 Maven Central，網址為 https://mvnrepository.com/。

  2. 搜尋 Kotlin 日期時間函式庫。 選取 Kotlinx Datetime 套件，然後選取您想要安裝的版本。

  3. 從 Maven 標籤頁複製 <dependency> 代碼段。

    <dependency>
    <groupId>org.jetbrains.kotlinx</groupId>
    <artifactId>kotlinx-datetime-jvm</artifactId>
    <version>0.4.1</version>
    <scope>runtime</scope>
</dependency>

  4. 開啟您的pom.xml檔案，將代碼段貼到<dependencies>標籤內，然後儲存檔案。

  5. 從與 pom.xml 檔案相同的路徑執行下列命令，以安裝您的相依性：

    mvn install

備註

若要從上游端儲存套件，您必須具有 Feed 和上游讀取者（協作者） 權限或更高級別。 如需詳細資訊，請參閱 管理許可權 。

檢視已儲存的套件

您可以從下拉功能表中選取 Maven Central 來源，以檢視從上游儲存的套件。

  1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

  2. 選取工件，然後從下拉功能表中選取您的訂閱源。

  3. 從來源下拉功能表中選取 [Maven Central ]，以篩選來自此上游的套件。

  4. 我們在上一個步驟中儲存的 Kotlinx Datetime 套件現在可在資訊流中使用。 當我們執行mvn 安裝命令時，Azure Artifacts 會自動將複本儲存至我們的摘要。

顯示從 Maven Central 儲存之套件的螢幕快照。

提示

如果 Maven 未下載所有相依性，請從專案目錄執行下列命令以重建專案的檔案：mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true