共用方式為


將套件發佈至 NuGet.org

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

NuGet.org 是套件管理員,可讓開發人員共用可重複使用的程序代碼。 NuGet 套件是擴展名為的壓縮檔 .nupkg ,其中包含可在其他專案中取用的已編譯程序代碼。 裝載於 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. 上一個命令的輸出看起來應該像這樣。

    發佈套件輸出