.NET Core中怎么創建和使用NuGet包

這篇文章主要講解了“.NET Core中怎么創建和使用NuGet包”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“.NET Core中怎么創建和使用NuGet包”吧！

在.NET Core的項目中，如果我們要在項目中引用其它DLL文件，不建議直接在項目引用中添加DLL文件（雖然在.NET Core項目中也可以這么做），建議是去直接下載DLL文件所屬的NuGet包。這樣最大的好處是我們可以將要引用DLL文件的所有依賴文件也一起引入到項目中，這樣保證了引用文件的完整性，讓其可以正確地運行。

下面我們通過一個.NET Core類庫項目和一個ASP.NET Core項目，來演示怎么發布一個NuGet包，并在項目中引用該NuGet包。

首先我們新建一個.NET Core類庫項目"Custom.Library.StringUtils"，它包含一個簡單的字符串工具類"StringHelper"，用來做簡單的字符串處理：

using System;
using Newtonsoft.Json;

namespace Custom.Library.StringUtils
{
 /// <summary>
 /// 字符串工具類
 /// </summary>
 public static class StringHelper
 {
  /// <summary>
  /// 將字符串轉換為大寫
  /// </summary>
  /// <param name="text">字符串</param>
  /// <returns>大寫的字符串</returns>
  public static string GetUpperString(string text)
  {
   return text.ToUpper();
  }

  /// <summary>
  /// 將一個對象轉換為json字符串
  /// </summary>
  /// <param name="jsonObject">對象</param>
  /// <returns>json字符串</returns>
  public static string ToJson(object jsonObject)
  {
   return JsonConvert.SerializeObject(jsonObject);
  }
 }
}

注意為了演示我們這個.NET Core類庫項目還引用了其它NuGet包，我們在項目中引用和使用了著名的json處理NuGet包：Newtonsoft.Json

接下來我們要把類庫項目"Custom.Library.StringUtils"發布為一個NuGet包。

首先由于我們在項目中寫了很多<summary>注釋，我們肯定希望其它的.NET Core項目引用了我們的NuGet包后，也能得到這些<summary>的提示，所以我們要在項目屬性（Properties）上做一些設置：

在項目的屬性上，我們選中Build頁面，這里有兩個地方要進行設置，首先由于我們是要在發布的NuGet包中生成XMLdocumentation文件，來包含<summary>注釋，所以我們要將Configuration下拉框選擇為All Configurations，這樣我們可以在發布（Release）時也生成XMLdocumentation文件，而不僅僅是在調試（Debug）時才生成。然后我們還要確保XML documentation file這個復選框是勾上的，這樣當我們的.NET Core類庫項目發布后才會生成對應的XML documentation文件：

其次每個NuGet包其實都有版本號，我們可以在Package頁面，通過Package version來設置當前NuGet包的版本號為1.0.0，如下所示：

然后我們就可以發布我們的.NET Core類庫項目"Custom.Library.StringUtils"為NuGet包了，在項目上點擊發布（Publish）：

在彈出的配置窗口中選擇一個發布目錄，這里我們選擇為本地計算機目錄"C:\Local nuget repository"，這個目錄也會作為我們后面本地NuGet包管理器的source，實際上我們還可以選擇一臺遠程計算機的共享目錄（例如\\192.168.1.105\Remote nuget packages這種網絡共享目錄）作為NuGet包的source目錄，這樣如果我們的開發團隊人員是在一個局域網中，就可以讓每個開發人員的Visual Studio從局域網的共享目錄中獲取需要的NuGet包了。

點擊發布（Publish）后，我們可以在目錄"C:\Local nuget repository"下看到，類庫項目生成的NuGet文件就已經存在了：

注意生成的NuGet文件名中是包含版本號的，例如現在如果我們在項目屬性（Properties）中的Package頁面上，將Package version改為2.0.0，如下所示：

然后再發布.NET Core類庫項目，我們可以看到在發布目錄"C:\Local nuget repository"下會再生成一個NuGet文件，這次版本號是2.0.0：

接下來我們就要在另外一個ASP.NET Core項目中來引用我們創建的NuGet包了，為此，我們新建一個ASP.NET Core項目"AspNetCore3000Message"。

首先我們要配置Visual Studio中尋找NuGet包的source，在Visual Studio中選擇Tools > NuGet Package Manager > Package Manager Settings

然后在彈出窗口中選中Package Sources頁面，然后點擊加號新建一個NuGet包source，名稱（Name）為"Local nuget package"，路徑（Source）為我們前面.NET Core類庫項目的發布目錄"C:\Local nuget repository"，如下所示：

點擊OK按鈕后，我們就將一個本地目錄設置為了Visual Studio中NuGet包管理器的source了，就像前面所說我們還可以將一臺遠程計算機的共享目錄作為source，這樣開發團隊人員的Visual Studio都可以從該共享目錄中獲取NuGet包了。

現在我們在ASP.NET Core項目"AspNetCore3000Message"中，打開NuGet包管理器：

然后，我們將右上角的Package source下拉框選擇為All，接著在搜索框中輸入我們前面發布的.NET Core類庫項目名"Custom.Library.StringUtils"，就可以找到我們發布的NuGet包了，由于我們前面發布了兩個版本到發布目錄"C:\Local nuget repository"，所以這里顯示NuGet包的版本也有兩個"1.0.0"和"2.0.0"，另外由于我們在.NET Core類庫項目"Custom.Library.StringUtils"中引用了Newtonsoft.Json這個NuGet包，所以我們這里看到在Dependencies下面顯示我們的NuGet包還依賴于Newtonsoft.Json，這樣在安裝我們的NuGet包Custom.Library.StringUtils時，也會下載和安裝Newtonsoft.Json這個NuGet包，保證了所有依賴的DLL文件都被引用到了ASP.NET Core項目"AspNetCore3000Message"中：

這里我們選擇安裝"2.0.0"版本：

之后我們就可以在ASP.NET Core項目中使用.NET Core類庫項目中的StringHelper類了，并且可以看到<summary>注釋是成功顯示的：

感謝各位的閱讀，以上就是“.NET Core中怎么創建和使用NuGet包”的內容了，經過本文的學習后，相信大家對.NET Core中怎么創建和使用NuGet包這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！