從 NuGet 資源庫使用套件

  • 發行項

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

透過 Azure Artifacts 上游來源，開發人員可以從公用登錄取用套件，例如 nuget.org 和 npmjs.com。 本文將逐步引導您完成設定項目的程式，以及使用命令行從 NuGet 資源庫有效地取用 NuGet 套件。 在本文中，您將學會如何：

  • 啟用摘要的上游來源
  • 將 NuGet 資源庫新增為上游來源
  • 連線 至您的摘要
  • 從 nuget.org 安裝套件

必要條件

在您的摘要上啟用上游來源

如果您沒有摘要，請遵循下列步驟來建立新的摘要，並確定核取上游來源複選框以啟用它們。 如果您已經有摘要，您可以跳至 下一個步驟 ，將 NuGet 資源庫新增為上游來源。

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

  2. 選取 [ 成品]，然後選取 [ 建立摘要 ] 以建立新的摘要。

  3. 輸入摘要的描述性 名稱 ，並定義其 可見度 （指出誰可以在摘要內檢視套件）。 指定摘要的範圍，如果您想要包含來自公用來源的套件，請標示 [上游來源] 複選框。

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

    顯示如何建立需求摘要的螢幕快照。

注意

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

如果您在製作摘要時核取了上游來源複選框，則應該會自動新增 NuGet 資源庫。 如果沒有，請依照下列步驟手動新增它：

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

  2. 選取 [ 成品]，然後選取您的摘要。

  3. 選取齒輪圖示按鈕 齒輪圖示 以流覽至您的 摘要設定。

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

  5. 選取 [公用來源]，然後從下拉功能表中選取 [NuGet 資源庫 ]。

  6. 完成 時選取 [儲存 ]，然後選取 右上角的 [再儲存 一次]，以儲存變更。

注意

nuget.org 的服務索引位置為 https://api.nuget.org/v3/index.json。

要摘要的 連線

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

  2. 選取 [ 成品]，然後選取您的摘要。

  3. 選取要摘要 連線，然後選取 [NuGet.exe]。

  4. 在與 .csproj 或 .sln 檔案相同的資料夾中新增 nuget.config 檔案。 將提供的 XML 代碼段貼到您的檔案中。 如果您使用下列範例，請確定您將佔位元取代為案例的適當值。

    • 組織範圍的摘要：

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

    • 專案範圍的摘要：

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

現在，我們的專案已設定為使用我們的摘要進行驗證，我們現在可以繼續從 NuGet 資源庫上游安裝套件。 在此範例中，我們將安裝 Serilog 診斷記錄連結庫：

  1. 流覽至 位於 https://www.nuget.org/的 NuGet 資源庫。

  2. 搜尋 Serilog 套件，然後選取它以流覽至詳細數據頁面。

  3. 選取 [封裝管理員] 索引標籤，然後複製命令。 在我們的範例中，命令如下所示：

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097

  4. 在 Visual Studio 中開啟您的項目，然後選取 [工具>NuGet 封裝管理員> 封裝管理員 控制台] 以開啟控制台視窗。

  5. 將命令貼到 [封裝管理員 控制台] 視窗中，然後按Enter以安裝您的套件。

注意

若要從上游儲存套件，您必須具有 摘要和上游讀取者（共同作業者） 角色或更高版本。 如需詳細資訊，請參閱 權限。

檢視已儲存的套件

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

  2. 選取 [ 成品]，然後從下拉功能表中選取您的摘要。

  3. 從下拉功能表中選取 NuGet 資源庫來源，以篩選來自此上游的套件。

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

    顯示已從上游儲存之套件的螢幕快照。