本文首发于 码友网 -- 《NuGet是什么?为什么.NET项目中会有NuGet?如何使用NuGet程序包?》

概述

大家好,我是专注.NET开发的码友网创建者Rector

在.NET应用程序编程开发中,开发者通常使用类库来管理、维护属于同一分类的程序代码,以便代码的重用。一般情况下,处于同一类库的所有类都位于同一程序集。

这些类库被编译器编译后会生成扩展名为.dll的动态链接库文件,你可以在其它项目中通过引用的方式导入这些.dll程序集并使用其中被封装的类及成员。

但随着项目越来越大、越来越多,使用手动引用.dll动态链接库的方式让程序包管理和维护变得非常困难。在这种情况下,NuGet程序包管理工具便应运而生。

NuGet程序包就好比前端开发中的npm包,Java开发中的Maven或者Gradle,它们都是管理自己语言领域的程序依赖包的工具。负责控制程序包版本,维护包与包之间的依赖,有了包管理工具,你可以快速地安装包,还原包等。

在正式接触NuGet程序包工具前,先来一步一步回顾.NET项目中程序包引入的进化历。

引入程序集的方式

引入程序集的方式有多种,如:

  • 程序集在同一个解决方案,直接引用项目
  • 程序集在本地磁盘,浏览.dll文件引入
  • NuGet程序包管理工具安装

1.引用项目方式

假如当前有一个名为NugetDemo.Payment的类库项目和一个名为ConsoleApp的控制台应用程序,现需要在ConsoleApp项目中通过引用项目的方式引入NugetDemo.Payment,方法如下:

1.右键单击依赖项,点击添加项目引用,如图:

2.在弹出的引用管理器窗口中选中NugetDemo.Payment,点击确定,如图:

3.Visual Studio将把选中的项目添加到当前项目的依赖项->项目列表,如图:

2.浏览文件方式

还是在ConsoleApp项目中,假如有另外一个支付宝的程序集,如图:

1.还是按归引用项目的方式,右键单击依赖项,点击添加项目引用

2.在弹出的引用管理器窗口选中浏览,如图:

3.再点击右下角的浏览按钮,在文件资源管理器中找到刚才准备的Ali.Alipay.dll文件,如图:

4.选择后点击右下角的添加按钮,将自动回到如下界面:

5.选中刚才浏览的Ali.Alipay.dll,最后点击右下角的确定按钮,Visual Studio将会把这个.dll文件添加到当前项目的依赖项->程序集列表中,如图:

无可厚非,以上的两种引用程序集的方式在结果上是没有问题的。但这种方式只适合个人项目,当你的团队成员或者团队项目达到一定量级之后,程序集的管理、维护、版本控制等问题会让你头疼。

到最后,你可能不知道当前引用的程序集是哪个版本?在哪里可以找到正确的程序集版本?它们之间的依赖关系是怎么样的?如果共享程序集?

有了NuGet程序包之后,这些问题就迎刃而解。

NuGet程序包

NuGet程序包是微软为.NET(包括.NET Core)平台提供的程序集共享包。

简单地说,NuGet包是一个扩展名为.nupkg的ZIP文件,其中包含了已编译代码(.dll)与该代码相关的其他文件,以及包版本号等信息的描述信息。

开发人员可以创建代码共享的程序包并将其发布到公共或私有主机。包使用者从合适的主机获得这些包,将它们添加到他们的项目中,然后在他们的项目代码中调用包的功能。然后NuGet自己处理所有中间细节(包括安装、卸载、依赖关系维护,版本控制等)。

微软官方为公共的.NET共享程序包提供专门的公有托管服务,地址为: https://www.nuget.org/

目前有超过25万的程序包被分享在这里,如图:

NuGet除了支持公共的nuget.org主机外还支持私有主机,所以你可以搭建个人或者公司内部的NuGet私有服务器,以达到内部分享程序包的目的。

NuGet程序包的安装和卸载

管理NuGet程序包的方式有多种,其中最常用的分别为:一、通过NuGet包管理器;二、通过命令行管理。其中NuGet包管理器是Visual Studio或者Rider这样的集成开发环境才具备的客户端管理工具。

下面以Visual Studio 2022 预览版(17.0.0 Preview 3.1)为例演示。

NuGet包管理器

安装NuGet

假如当前有一个基于.NET 5的控制台应用程序,结构如下:

现需要在这个控制台中安装Newtonsoft.Json以便进行json序列化和反序列化操作。那么,我们可以通过右键依赖项 -> 管理NuGet程序包来打开NuGet包管理器,如下图:

然后选择浏览选项卡,并在搜索框中键入关键词,在搜索结果中选中需要安装的程序包,最后点击右侧的安装按钮,如下:

在弹出的对话框中,点击确定按钮:

Visual Studio将自动下载选中的程序包及其依赖包,并将其添加到当前项目的依赖项中,如下图:

现在,可以在这个ConsoleApp1项目中调用Newtonsoft.Json组件所有可访问的功能了,以下示例演示了利用Newtonsoft.Json将一个json字符串反序列化成实体对象,代码如下:

using Newtonsoft.Json;

class Program
{
    static void Main(string[] args)
    {
        // 模拟一个JSON字符串
        var json = "{\"id\":1,\"name\":\"Rector\",\"age\":18}";
        // 调用JsonConvert.DeserializeObject<T>()泛型方法反序列化
        var person = JsonConvert.DeserializeObject<Person>(json);
        Console.WriteLine(person.ToString());
        Console.ReadKey();
    }
}
/// <summary>
/// 定义一个与JSON字符串字段匹配的实体类
/// </summary>
public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public short Age { get; set; }
    /// <summary>
    /// 重写ToString()方法
    /// </summary>
    /// <returns></returns>
    public override string ToString()
    {
        return $"id:{Id},name:{Name},age:{Age}";
    }
}

运行结果如下图:

NuGet包版本管理

NuGet包有版本之分,不同的版本以版本号作为标识,比如上面安装的Newtonsoft.Json程序包,安装的时候选择了当前的最新版本(13.0.1),如图:

这个下拉列表列出了Newtonsoft.Json程序包所有可用的版本号,通过选择不同版本号即可安装不同版本的Newtonsoft.Json程序包,也可以通过这个版本下拉列表实现NuGet程序包版本的升/降级

比如,当前我们已经安装了版本13.0.1,那么,选择任意一个比它版本号小的即为降级,比如这里选择降级为12.0.3,点击更新按钮即可完成降级。

同理,选择任意一个比当前版本号大的版本,即可完成升级版本的操作。

NuGet包卸载

有安装就有卸载,假如某个项目不再需要某个NuGet程序包,则可以通过NuGet包管理器中的卸载按钮来一键卸载掉指定的NuGet程序包(其依赖的程序包也会被一并卸载),如图:

卸载Newtonsoft.Json包后,上面演示的反序列化示例代码在编译报错了,如图:

NuGet命令行

除了NuGet包管理器外,还可使用NuGet命令行来安装。

首先,打开NuGet的官网: https://www.nuget.org/ ,在搜索框中键入要查找的NuGet包关键字(这里演示Newtonsoft),点击搜索按钮,如图:

在搜索结果列表中点击符合要求的程序包(Newtonsoft.Json),如图:

进入到Newtonsoft.Json的详情页面,此页面展示了程序包的详细信息,如:命令行、依赖、被其他项目使用列表,历史版本列表,基本信息等等,如图:

程序包管理器控制台命令

安装NuGet包

首先,演示程序包管理器控制台,复制其中的程序包管理器控制台命令:

Install-Package Newtonsoft.Json -Version 13.0.1

在Visual Studio中,打开程序包管理器控制台,如图:

将命令粘贴在程序包管理器控制台中,并将默认项目设置为当前项目(如果一个解决方案中有多个项目时,需仔细检查此下拉框选中的项目),按键执行命令。

命令执行结果如图:

程序包管理器控制台命令方式安装NuGet程序包成功。

更新NuGet包

程序包管理器控制台中,同样可以更新NuGet包。

你可以获取检查当前项目已安装包是否有新版本,命令如下:

Get-Package -updates

更新指定包到指定版本,命令如下:

Update-Package Newtonsoft.Json -Version 13.0.1

更新项目的指定包到指定版本,命令如下:

Update-Package Newtonsoft.Json -Version 13.0.1 -ProjectName ConsoleApp1

更新当前解决方案的所有程序包到最新版本,命令如下:

Update-Package

卸载NuGet包

程序包管理器控制台中,还可以卸载NuGet包。

卸载默认项目的指定程序包,命令如下:

Uninstall-Package Newtonsoft.Json

卸载默认项目的指定程序包,同时卸载未使用的依赖包,命令如下:

Uninstall-Package Newtonsoft.Json -RemoveDependencies

强制卸载默认项目的指定程序包(即使其他程序包依赖于它),命令如下:

Uninstall-Package Newtonsoft.Json -Force

.NET CLI管理NuGet包

要使用.NET CLI工具,需要安装.NET Core SDK。如果已安装Visual Studio 2017及以上版本,则.NET CLI工具会自动安装。

安装Nuget包

使用.NET CLI安装Newtonsoft.Json包的命令如下:

dotnet add package Newtonsoft.Json --version 13.0.1

命令执行如下:

卸载Nuget包

卸载Newtonsoft.Json包的命令如下:

dotnet remove package Newtonsoft.Json

下一篇介绍《1分钟极速搭建基于BaGet的轻量级私有Nuget程序包服务器》

如有什么问题,欢迎评论区留言反馈。

如果你觉得本文有价值,请来个三连(点赞,收藏,评论)吧,谢谢。

03-05 15:10