共用方式為

將套件發佈至 NuGet.org

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

NuGet.org 是套件管理員，可讓開發人員共用可重複使用的程序代碼。 NuGet 套件是擴展名為的壓縮檔 .nupkg ，其中包含可在其他專案中取用的已編譯程序代碼。 裝載於 NuGet.org 中的套件可供世界各地的所有開發人員使用。

先決條件

  • 任何版本的 Visual Studio 2019 和 .NET Core 工作負載。
  • dotnet CLI。 如果您還沒有它，請安裝 .NET Core SDK。
  • 如果您還沒有免費帳戶，請在 nuget.org 註冊免費帳戶。

建立專案

您可以使用自己的 .NET 專案來建置和產生 NuGet 套件，或建立新的基本 .NET 類別庫，如下所示：

  1. 在 Visual Studio 中，依序選取 [ 檔案]、[ 新增] 和 [ 專案]。

  2. 選取 類別庫 （.NET Standard） 範本，然後選取 [ 下一步]。

  3. 將專案命名為您的方案，然後選取位置以在本機儲存專案。 完成之後，請選取 建立。

    建立類別庫專案

範本類別庫足以建立 NuGet 套件，因此在本教學課程中，我們將使用現有的範本，而且我們不會撰寫任何其他程式碼。

設定併產生套件

  1. 從方案總管中選取您的專案，以滑鼠右鍵按下並選取 [屬性 ]，然後選取 [ 封裝]。

  2. 填寫表單，並確定您的 套件標識碼 是唯一的，否則它可能會與 NuGet.org 上的現有套件衝突。常見的命名慣例類似：Company.Product.Feature。 如果您想要在每次建置項目時產生套件，請選取 [ 建置時產生 NuGet 套件] 複選框。

    設定套件屬性

  3. 從方案總管中選取您的專案，以滑鼠右鍵按兩下 ，然後選取 [ 套件 ] 以產生您的 .nupkg 套件。

    產生套件

  4. 在輸出視窗中檢查pack命令的狀態。

    套件輸出

產生 API 金鑰

既然我們已建立套件 nupkg ，我們幾乎已準備好發佈它，但首先我們需要產生 API 密鑰以連線到 NuGet.org API。

  1. 登入 您的 NuGet.org 帳戶，或如果您尚未登入，請建立帳戶。

  2. 選取您的使用者名稱圖示，然後選取 [API 金鑰]。

  3. 選取 [建立 ]，然後輸入密鑰的名稱。 為您的金鑰提供 推送新套件和套件版本 範圍，然後在 glob 模式欄位中輸入 * 以選取所有套件。 完成之後，請選取 建立。

    建立 API 金鑰

  4. 選取 [複製，並將 API 金鑰儲存在安全的位置。 我們需要此金鑰來發佈 NuGet 套件。

    複製 API 金鑰

將套件發佈至 NuGet.org

您可以使用 Web UI、dotnet CLI 或 nuget.exe CLI 發佈套件。 我們將著重於使用本節中的命令行發佈套件。 您需要套件的名稱、API 金鑰和來源 URL 才能執行此動作。

  1. 以管理員身份開啟命令提示字元後，導航至包含您nupkg 套件的資料夾。

  2. 執行下列命令，將您的套件發佈至 NuGet.org。將佔位元取代為您的套件名稱和 API 金鑰。

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. 上一個命令的輸出看起來應該像這樣。

    發佈套件輸出

  • Last updated on