將套件發佈至 NuGet.org

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

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 模式欄位中輸入 * 以選取所有套件。 完成之後，請選取 [建立]。

   

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

   

將套件發佈至 NuGet.org

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

dotnet CLI

1. 在提升許可權的命令提示字元中，流覽至包含您 nupkg 套件的資料夾。

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

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

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

   

nuget.exe

1. 在提升許可權的命令提示字元中，流覽至包含您 nupkg 套件的資料夾。

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

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

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

   

相關文章

• 在 Visual Studio 中取用 NuGet 套件
• 開始使用 NuGet 套件和 Azure Artifacts
• 使用 Azure Pipelines 發佈 NuGet 套件