使用來自Google Maven儲存庫的套件

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

透過 Azure Artifacts,開發者可以啟用上游來源,從公開登錄檔(如 Google Maven Repository)取用套件。 啟用上游來源時,Azure Artifacts 會自動儲存任何由擁有 Feed 及 Upstream Reader (Collaborator) 權限以上權限的使用者安裝到串流的套件副本。 Azure Artifacts 也支援其他 Maven 上游來源,包括 Maven Central、Gradle Plugins 和 JitPack。

必要條件

產品 要求
Azure DevOps - 一個Azure DevOps 組織。
- 一個Azure DevOps 計畫。

建立訂閱源

如果你已經有 Azure Artifacts 訂閱源,請跳到下一節。 否則,請依照以下步驟創建一個新的:

  1. 登入 Azure DevOps,然後導覽到你的專案。

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

  3. 輸入您的名稱為資料源,設定可見度以控制誰可以查看套件,然後選擇資料源的範圍。 選擇 包含來自常見公共來源的套件,以啟用上游來源功能並允許使用公共註冊表。

  4. 選取 [建立] 以完成。

將 Google Maven Repository 加入上游來源

如果你在建立訂閱源時選擇了 「包含來自常見公開來源的套件 」,Google Maven 儲存庫應該已經被加入為上游來源。 如果沒有,你可以依照以下步驟手動新增:

  1. 登入你的 Azure DevOps 組織,然後導覽到你的專案。

  2. 選擇「Artifacts」,然後選擇右上角的gear icon齒輪圖示,開啟訂閱設定。

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

  4. 選擇 「公開來源」,然後選擇 Google Maven Repositoryhttps://maven.google.com/web/index.html()。

  5. 選擇 新增,然後在右上角選擇 儲存 ,以儲存你的變更。

從Google Maven存放庫儲存套件

開始之前,請確保你的 Maven 專案已設定為連接 Azure Artifacts 訂閱源。 如果你還沒這麼做,請依照 專案設定 中的指示設定你的 Maven 專案,並用你的訂閱源進行驗證。

以下範例展示了如何安裝 Multipaz,一個來自 Google Maven Repository 的開源身份框架。

  1. 前往 Google Maven 資料庫 https://maven.google.com。

  2. 搜尋 Multipaz 套件: org.multipaz,然後選擇你想使用的套件和版本。

  3. 複製套件的 群組 ID、 Artifact ID 和 版本 值。

  4. 請將以下片段中的佔位符替換成你剛複製的數值:

    <dependency>
        <groupId>GROUP_ID</groupId>
        <artifactId>ARTIFACT_ID</artifactId>
        <version>VERSION</version>
    </dependency>
    
  5. 打開你的 pom.xml 檔案,把相依性片段貼到該 <dependencies> 區段裡,然後儲存檔案。

  6. 從與你的 pom.xml 檔案相同的路徑中執行以下指令來安裝相依性:

    mvn install
    

當指令完成後,Maven 會透過你的 Azure Artifacts feed 來解決相依性。 如果該套件尚未出現在資料流中,Azure Artifacts 會從 Google Maven 儲存庫取得並儲存一份。 後續安裝則直接從 Azure Artifacts 下載套件,而非公開登錄檔。

備註

你必須具備 Feed 和 Upstream Reader(協作者) 角色或更高,才能從上游儲存封包。 如需更多詳細資訊,請參閱提要角色和權限。

檢視已儲存的套件

從上游安裝套件後,你可以確認 Azure Artifacts 已將副本存入你的串流:

  1. 登入 Azure DevOps,然後導覽到你的專案。

  2. 選取工件,然後從下拉式選單中選取您的饋送。

  3. 從 「來源 」下拉選單中,選擇 Google Maven 儲存庫 ,以查看從上游儲存的套件。

  4. 你在前一節安裝的 Multipaz 套件現在已經在你的動態中出現了。 Azure Artifacts 在執行 mvn 安裝指令時會自動儲存一份副本。

    截圖顯示 Google Maven Repository 的 Multipaz 套件已儲存到動態中。

小提示

如果 Maven 沒有下載所有相依性,請從專案目錄執行以下指令,重新生成專案檔案並下載原始碼與 Javadocs:mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true