10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)

轻歌漫舞 發表於 2021-9-7 15:38:00

10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)

<h1>前言</h1>
<blockquote>
　　NuGet就是一个包（package）管理平台，确切的说是 .net平台的包管理工具，它提供了一系列客户端用于生成，上传和使用包（package），以及一个用于存储所有包的中心库。
　　对于一个现代化的开发平台，建立一种让开发者创建，分享与使用可复用代码的机制是十分必要的。这种“可复用代码”被打包后的文件通常被称作“包”（package），
对于.NET（包括 .NET Core）平台来说这个机制的实现就是NuGet平台。
　　NuGet的实现均为开源项目，包括了客户端工具，服务器，官方网站以及各语言的文档等。
　　NuGet包的本质是一个以nupkg为后缀的zip压缩文件（你可以将后缀改为.zip后解压查看里面的内容），其中包含了编译后的Dll文件以及其他相关文件。
</blockquote>
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210906165739351-2027069111.png" alt="" loading="lazy">
 
　　　　　　　　　　　　图1：显示nuget包从创建，上传到被使用的流程
对于引用大家都会使用，但是对于创建NuGet引用就不怎么会了，我们下面就介绍怎么打包dll类库到NuGet平台进行引用。
<h1>创建类库方法</h1>
我们首先创建一个可调用的类库，以“繁简体相互转换”为例，当然你也可以创建其他的，比如获取配置文件、http请求帮助类等。
这里使用的环境是vs2019， .NET Core2.1，使用.NET也可以，这里可根据自己的使用环境创建。
注意：类库是什么环境，引用也需要什么环境。（.NET Core和.NET不能相互混用）。
创建一个.NET Core类库项目，命名为“XiongZeUtils”（自定义命名），然后在类库项目下创建一个繁简体项目转换的类，命名为“xzUtils”（自定义）。
注意，繁简体相互转换需要现在NuGet引入包ChineseConverter，然后在类里面引用using Microsoft.International.Converters.TraditionalChineseToSimplifiedConverter，如下：
创建完成后记得需要先编译生成dll文件
<div class="cnblogs_code">
<pre>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;
 }
}
}</pre>
</div>
 创建完成后记得需要先编译生成dll文件
<hr>
<h1>NuGet发布到服务器 </h1>
<h2>1、登录NuGet账号获取API keys</h2>
官网地址：https://www.nuget.org/
如果你有Microsoft 帐户，直接登录即可。如果没有则需去创建一个。
NuGet登录快捷入口：https://www.nuget.org/users/account/LogOn
（注册地址入口比较难找，下面快捷入口直接点击即可注册）
NuGet注册账号快捷入口：https://signup.live.com/?lic=1
备用方案：
<blockquote>
NuGet.org 上的个人帐户：https://docs.microsoft.com/en-us/nuget/nuget-org/individual-accounts
获取您的 API 密钥：https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-visual-studio?tabs=netcore-cli

</blockquote>
 
获取您的 API 密钥
<ol>
<li>
登录您的 nuget.org 帐户或创建一个帐户（如果您还没有）。
有关创建帐户的更多信息，请参阅个人帐户。

</li>
<li>
选择您的用户名（在右上角），然后选择API Keys。

</li>
<li>
选择Create，为您的密钥提供一个名称，选择Select Scopes > Push。为Glob 模式输入 * ，然后选择Create。（有关范围的更多信息，请参见下文。）

</li>
<li>
创建密钥后，选择复制以在 CLI 中检索您需要的访问密钥：
<img src="https://docs.microsoft.com/en-us/nuget/quickstart/media/qs_create-02-apikey.png" alt="将 API 密钥复制到剪贴板" data-linktype="relative-path">

</li>
<li>
重要提示：将您的密钥保存在安全位置，因为您以后无法再次复制该密钥。如果返回 API 密钥页面，则需要重新生成密钥才能进行复制。如果您不想再通过 CLI 推送包，您也可以删除 API 密钥。

</li>

</ol>
范围允许您为不同的目的创建单独的 API 密钥。每个密钥都有其到期时间范围，并且可以限定为特定的包（或 glob 模式）。每个键也适用于特定操作：推送新包和更新、仅推送更新或下架。通过范围界定，您可以为为您的组织管理包的不同人员创建 API 密钥，以便他们仅拥有所需的权限。有关更多信息，请参阅作用域 API 密钥。
 
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907094345841-1195620158.png" alt="" width="1000" height="482" loading="lazy">
 <img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907095316204-2139864730.png" alt="" width="998" height="703" loading="lazy">
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907095634371-860581804.png" alt="" loading="lazy">
 
<hr>
 
<h2>2、下载Nuget.exe并发布项目</h2>
点击下载nuget.exe
<blockquote>
https://www.nuget.org/downloads

</blockquote>
我这里下载的是5.9.1版本的，版本这里没有特别的要求。
这里只有6M多一点，下载太慢了，我把下载好的放在gitee上，大家直接点击下载解压即可。
下载地址1（git）：https://gitee.com/xiongze/nugetexe-file.git
下载地址2（百度网盘）：https://pan.baidu.com/s/1RIbJXzn3aoKWURB_VRjx3w     提取码：xion
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907100437233-2057935479.png" alt="" width="1042" height="450" loading="lazy">
 
 
<hr>
<h2>3、NuGet发布到服务器</h2>
将下载下来的nuget.exe与刚才新建的类库放在同一目录下。
 
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907101936450-1474150939.png" alt="" loading="lazy">
 配置发布信息，并将发布路径指向或拷贝到与刚才新建的类库放在同一目录下。
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907102501840-2120063922.png" alt="" width="1066" height="554" loading="lazy">
 <img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907102631878-1882615259.png" alt="" loading="lazy">
 
①、找到vs对应的开发人员命令提示（不能用cmd直接打开）
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907102941078-1338777454.png" alt="" loading="lazy">
 
 或者 C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907103049129-53554883.png" alt="" loading="lazy">
 
②命令提示定位到Nuget.exe所在的目录
 双击运行 <code>Developer Command Prompt for VS 2019</code>  cd到项目类库的目录
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907103647045-1588119339.png" alt="" loading="lazy">
 
 ③通过命令 nuget setapikey  xxxxx-xxxx-xxx-xxxx-xxxx-xxxx （我们上面nuget copy的key）, 设置API Key
通过命令 nuget setapikey  xxxxx-xxxx-xxx-xxxx-xxxx-xxxx , 设置API Key;
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907104113974-1392806223.png" alt="" loading="lazy">
 
 ④生成xxxx.nuspec文件
nuspec是NuGet将项目打包成nupkg的输入文件，可以通过nuget spec命令产生。 <code>通过命令 nuget spec 生成xxxx.nuspec文件;</code>
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907104714740-1836457853.png" alt="" loading="lazy">
 
 ⑤NuGet发布到服务器
通过命令 nuget.exe push xxxxx.nupkg -Source https://www.nuget.org ，将NuGet发布到服务器。
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907105002477-1090567943.png" alt="" loading="lazy">
 
打包成功后，这里需要等待3-10分钟左右，打包成功后nuget就能查询到我们打包的引用了，如果没有的多等待一下。
<hr>
 
<h1>使用NuGet包</h1>
我们这个时候就可以在NuGet里面搜索到我们的类库了，我们引入进来使用一下。
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907105358920-1247100082.png" alt="" loading="lazy">
 
 在项目中引入我们的nuget包，然后调用得到下面内容
 
<img src="https://img2020.cnblogs.com/blog/1093832/202109/1093832-20210907105924044-1980013888.png" alt="" loading="lazy">
<hr>
<h1>参考文献 </h1>
<ul>
<li> Nuget包发布流程：https://www.52pojie.cn/thread-1434899-1-1.html</li>
<li>
NuGet是什么：https://zhuanlan.zhihu.com/p/36207092
</li>
<li>nuget官网地址：https://www.nuget.org/</li>
</ul>
<table style="height: 149px; background-color: rgba(110, 151, 104, 1); width: 100%" border="2" align="left">
<tbody>
<tr>
<td>
<div style="float: left"> </div>
<div style="float: left; margin: 0 0 0 10px; color: rgba(255, 255, 255, 1)"> 欢迎关注订阅微信公众号【熊泽有话说】，更多好玩易学知识等你来取 
 作者：熊泽-学习中的苦与乐 公众号：熊泽有话说 
 
 出处： https://www.cnblogs.com/xiongze520/p/15234581.html 
 
 创作不易，任何人或团体、机构全部转载或者部分转载、摘录，请在文章明显位置注明作者和原文链接。
  

 </div>
 

 </td>

 </tr>

</tbody>

</table>
 
<img src="https://img2020.cnblogs.com/blog/1093832/202108/1093832-20210823163948985-309495620.png" alt="" width="514" height="239" loading="lazy">
 

</div>
<div id="MySignature" role="contentinfo">
本文来自博客园，作者：熊泽-学习中的苦与乐，转载请注明原文链接：https://www.cnblogs.com/xiongze520/p/15234581.html 
来源：https://www.cnblogs.com/xiongze520/p/15234581.html

頁: [1]

琼殿技术论坛's Archiver

10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)