共用方式為

快速入門：開始使用 Azure Artifacts 中的 NuGet 套件

  • 發行項

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

Azure Artifacts 可讓開發人員從摘要和公用登錄等來源發佈和下載 NuGet 套件。 使用 Azure Artifacts，您可以建立下列其中一種摘要：

  • 私人，因此您可以與小組和特定用戶共用套件。
  • 公用，因此您可以公開與因特網上的任何人共用套件。

在此快速入門中，您可了解如何：

  • 建立新的摘要。
  • 設定專案並連線到您的摘要。
  • 發佈 NuGet 套件。
  • 從您的摘要下載套件。

必要條件

建立摘要

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

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

  3. 針對 [ 名稱]，輸入摘要的描述性名稱。

    針對 [可見度]，選取一個選項來指出誰可以檢視摘要內的套件。

    如果您想要包含來自公用來源的套件，請選取 [上游來源] 底下的複選框。

    在 [ 範圍] 中，指定摘要的範圍是專案或組織。

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

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

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

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

  3. 針對 [ 名稱]，輸入摘要的描述性名稱。

    針對 [可見度]，選取一個選項來指出誰可以檢視摘要內的套件。

    如果您想要包含來自公用來源的套件，請選取 [上游來源] 底下的複選框。

    在 [ 範圍] 中，指定摘要的範圍是專案或組織。

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

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

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

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

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

  2. 選取 [ 成品]，然後選取 [ 新增摘要]。

  3. 針對 [ 名稱]，輸入摘要的描述性名稱。

    針對 [可見度]，選取一個選項來指出誰可以檢視摘要內的套件。

    如果您想要包含來自公用來源的套件，請 選取 [透過此摘要 從公用來源使用套件] 選項。

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

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

注意

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

聯機到摘要

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

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

  3. 選取 [ 連接到摘要]，然後從左窗格中選取 [NuGet.exe ]。 如果這是您第一次搭配 Nuget.exe使用 Azure Artifacts，請確定您已安裝所有必要條件。

    顯示連線至摘要之按鈕的螢幕快照。

  4. 請遵循 Project 安裝程式一節中的指示來設定 nuget.config 檔案，並使用 Azure Artifacts 進行驗證。

    螢幕快照，顯示設定項目的畫面指示。

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

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

  3. 選取 [ 連接到摘要]，然後從左窗格中選取 [NuGet.exe ]。

  4. 請遵循 [項目設定] 區段中的指示，聯機到您的摘要。

    此螢幕快照顯示在 Azure DevOps Server 2020 和 2022 中設定 NuGet 項目的畫面指示。

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

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

  3. 選取 [ 連線至摘要]，然後從左窗格中選取 [NuGet ]。

  4. 請遵循指示，將套件來源 URL 新增至 nuget.config。

    螢幕快照，顯示在 Azure DevOps Server 2019 中設定 NuGet 項目的畫面指示。

下載套件

1.取得套件來源 URL

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

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

  3. 從左窗格中選取 [NuGet ]，然後複製您的 套件來源 URL 值。

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

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

  3. 從左窗格中選取 [Visual Studio ]，然後複製您的 [來源 URL]。

    顯示來源 URL 的螢幕快照。

2.設定 Visual Studio

  1. 在 Visual Studio 中，選取 [工具>選項]。

  2. 展開 [NuGet 封裝管理員] 區段，然後選取 [套件來源]。

  3. 輸入摘要的 [名稱] 值和 [來源 URL]，然後選取綠色加號 （+） 以新增來源。

  4. 如果您在摘要中啟用上游來源，請清除 [nuget.org ] 複選框。

  5. 當您完成時，選取 [確定]。

    螢幕快照，顯示在 Windows 中設定 Visual Studio 的選取專案。

3.下載套件

  1. 在 Visual Studio 中，以滑鼠右鍵按兩下您的項目，然後選取 [ 管理 NuGet 套件]。

  2. 選取 [ 瀏覽]，然後從 [套件來源 ] 下拉功能表中選取您的摘要。

    顯示 Visual Studio 中封裝來源選取項目的螢幕快照。

  3. 使用搜尋列來搜尋摘要中的套件。

注意

不支援使用 NuGet 套件總管來搜尋上游來源中的套件。

發佈套件

若要將套件發佈至摘要，請執行下列命令。 您可以輸入自變數的任何字串 ApiKey 。

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

範例：

  • 專案範圍的摘要：

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg

  • 組織範圍的摘要：

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg

注意

ApiKey是必要的，但您可以在發佈至 Azure Artifacts 摘要時使用任何任意值。

相關內容