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

下面我們通過一個(gè).NET Core類庫項(xiàng)目和一個(gè)ASP.NET Core項(xiàng)目，來演示怎么發(fā)布一個(gè)NuGet包，并在項(xiàng)目中引用該NuGet包。

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

using System;
using Newtonsoft.Json;

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

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

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

接下來我們要把類庫項(xiàng)目"Custom.Library.StringUtils"發(fā)布為一個(gè)NuGet包。

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

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

其次每個(gè)NuGet包其實(shí)都有版本號(hào)，我們可以在Package頁面，通過Package version來設(shè)置當(dāng)前NuGet包的版本號(hào)為1.0.0，如下所示：

然后我們就可以發(fā)布我們的.NET Core類庫項(xiàng)目"Custom.Library.StringUtils"為NuGet包了，在項(xiàng)目上點(diǎn)擊發(fā)布（Publish）：

在彈出的配置窗口中選擇一個(gè)發(fā)布目錄，這里我們選擇為本地計(jì)算機(jī)目錄"C:\Local nuget repository"，這個(gè)目錄也會(huì)作為我們后面本地NuGet包管理器的source，實(shí)際上我們還可以選擇一臺(tái)遠(yuǎn)程計(jì)算機(jī)的共享目錄（例如\\192.168.1.105\Remote nuget packages這種網(wǎng)絡(luò)共享目錄）作為NuGet包的source目錄，這樣如果我們的開發(fā)團(tuán)隊(duì)人員是在一個(gè)局域網(wǎng)中，就可以讓每個(gè)開發(fā)人員的Visual Studio從局域網(wǎng)的共享目錄中獲取需要的NuGet包了。

點(diǎn)擊發(fā)布（Publish）后，我們可以在目錄"C:\Local nuget repository"下看到，類庫項(xiàng)目生成的NuGet文件就已經(jīng)存在了：

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

然后再發(fā)布.NET Core類庫項(xiàng)目，我們可以看到在發(fā)布目錄"C:\Local nuget repository"下會(huì)再生成一個(gè)NuGet文件，這次版本號(hào)是2.0.0：

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

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

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

點(diǎn)擊OK按鈕后，我們就將一個(gè)本地目錄設(shè)置為了Visual Studio中NuGet包管理器的source了，就像前面所說我們還可以將一臺(tái)遠(yuǎn)程計(jì)算機(jī)的共享目錄作為source，這樣開發(fā)團(tuán)隊(duì)人員的Visual Studio都可以從該共享目錄中獲取NuGet包了。

現(xiàn)在我們在ASP.NET Core項(xiàng)目"AspNetCore3000Message"中，打開NuGet包管理器：

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

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

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

參考文獻(xiàn)：

How to include XML documentation file in NuGet package built from a project file?

到此這篇關(guān)于.NET Core中創(chuàng)建和使用NuGet包的示例代碼的文章就介紹到這了,更多相關(guān).NET Core 創(chuàng)建和使用NuGet包內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論