NuGet就是一个包(package)管理平台,确切的说是 .net平台的包管理工具,它提供了一系列客户端用于生成,上传和使用包(package),以及一个用于存储所有包的中心库。
对于一个现代化的开发平台,建立一种让开发者创建,分享与使用可复用代码的机制是十分必要的。这种“可复用代码”被打包后的文件通常被称作“包”(package),
对于.NET(包括 .NET Core)平台来说这个机制的实现就是NuGet平台。
NuGet的实现均为开源项目,包括了客户端工具,服务器,官方网站以及各语言的文档等。
NuGet包的本质是一个以nupkg为后缀的zip压缩文件(你可以将后缀改为.zip后解压查看里面的内容),其中包含了编译后的Dll文件以及其他相关文件。
对于引用大家都会使用,但是对于创建NuGet引用就不怎么会了,我们下面就介绍怎么打包dll类库到NuGet平台进行引用。
我们首先创建一个可调用的类库,以“繁简体相互转换”为例,当然你也可以创建其他的,比如获取配置文件、http请求帮助类等。
这里使用的环境是vs2019, .NET Core2.1,使用.NET也可以,这里可根据自己的使用环境创建。
注意:类库是什么环境,引用也需要什么环境。(.NET Core和.NET不能相互混用)。
创建一个.NET Core类库项目,命名为“XiongZeUtils”(自定义命名),然后在类库项目下创建一个繁简体项目转换的类,命名为“xzUtils”(自定义)。
注意,繁简体相互转换需要现在NuGet引入包ChineseConverter,然后在类里面引用using Microsoft.International.Converters.TraditionalChineseToSimplifiedConverter,如下:
创建完成后记得需要先编译生成dll文件
using Microsoft.International.Converters.TraditionalChineseToSimplifiedConverter;
using System;
namespace XiongZeUtils
{
public static class xzUtils
{
/// <summary>
/// 简体转换为繁体
/// </summary>
/// <param name="str">简体字</param>
/// <returns>繁体字</returns>
public static string GetTraditional(string str)
{
string r = string.Empty;
r = ChineseConverter.Convert(str, ChineseConversionDirection.SimplifiedToTraditional);
return r;
}
/// <summary>
/// 繁体转换为简体
/// </summary>
/// <param name="str">繁体字</param>
/// <returns>简体字</returns>
public static string GetSimplified(string str)
{
string r = string.Empty;
r = ChineseConverter.Convert(str, ChineseConversionDirection.TraditionalToSimplified);
return r;
}
}
}
创建完成后记得需要先编译生成dll文件
如果你有Microsoft 帐户,直接登录即可。如果没有则需去创建一个。
NuGet登录快捷入口:https://www.nuget.org/users/account/LogOn
(注册地址入口比较难找,下面快捷入口直接点击即可注册)
NuGet注册账号快捷入口:https://signup.live.com/?lic=1
备用方案:
NuGet.org 上的个人帐户:https://docs.microsoft.com/en-us/nuget/nuget-org/individual-accounts
获取您的 API 密钥
范围允许您为不同的目的创建单独的 API 密钥。每个密钥都有其到期时间范围,并且可以限定为特定的包(或 glob 模式)。每个键也适用于特定操作:推送新包和更新、仅推送更新或下架。通过范围界定,您可以为为您的组织管理包的不同人员创建 API 密钥,以便他们仅拥有所需的权限。有关更多信息,请参阅作用域 API 密钥。
点击下载nuget.exe
我这里下载的是5.9.1版本的,版本这里没有特别的要求。
这里只有6M多一点,下载太慢了,我把下载好的放在gitee上,大家直接点击下载解压即可。
下载地址1(git):https://gitee.com/xiongze/nugetexe-file.git
下载地址2(百度网盘):https://pan.baidu.com/s/1RIbJXzn3aoKWURB_VRjx3w 提取码:xion
将下载下来的nuget.exe与刚才新建的类库放在同一目录下。
配置发布信息,并将发布路径指向或拷贝到与刚才新建的类库放在同一目录下。
①、找到vs对应的开发人员命令提示(不能用cmd直接打开)
或者C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools
②命令提示定位到Nuget.exe所在的目录
双击运行Developer Command Prompt for VS 2019cd到项目类库的目录
③通过命令 nuget setapikey xxxxx-xxxx-xxx-xxxx-xxxx-xxxx(我们上面nuget copy的key), 设置API Key
通过命令nuget setapikeyxxxxx-xxxx-xxx-xxxx-xxxx-xxxx, 设置API Key;
④生成xxxx.nuspec文件
nuspec是NuGet将项目打包成nupkg的输入文件,可以通过nuget spec命令产生。
通过命令nuget spec生成xxxx.nuspec文件;
⑤NuGet发布到服务器
通过命令nuget.exe push xxxxx.nupkg -Source https://www.nuget.org,将NuGet发布到服务器。
打包成功后,这里需要等待3-10分钟左右,打包成功后nuget就能查询到我们打包的引用了,如果没有的多等待一下。
我们这个时候就可以在NuGet里面搜索到我们的类库了,我们引入进来使用一下。
在项目中引入我们的nuget包,然后调用得到下面内容