示例：在Nuget发布自己的包的步骤

原文:示例：在Nuget发布自己的包的步骤

一、目的：很多时候都在用第三方的Nuget包，现成的轮子可以减少很多工作量，同时我们也可以造轮子供自己和其他人使用，本示例主要演示如何发布dll到Nuget上

二、环境：

Win10、VS2019、nuget.exe、nuget.org 帐户

三、步骤：

1、创建nuget.org 帐户

注册地址 https://www.nuget.org/

2、下载nuget.exe

下载地址：https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

将nuget.exe 设置系统环境变量，方便使用命令，也可以不设置，不设置则要使用全路径

3、创建一个程序集

设置程序集描述信息，这些会生成在nuget包中

// 有关程序集的一般信息由以下





// 控制。更改这些特性值可修改





// 与程序集关联的信息。





[assembly: AssemblyTitle("我的标题")]





[assembly: AssemblyDescription("我的说明")]





[assembly: AssemblyConfiguration("")]





[assembly: AssemblyCompany("我的公司")]





[assembly: AssemblyProduct("我的产品")]





[assembly: AssemblyCopyright("Copyright ©  2019")]





[assembly: AssemblyTrademark("")]





[assembly: AssemblyCulture("")]





 





// 将 ComVisible 设置为 false 会使此程序集中的类型





//对 COM 组件不可见。如果需要从 COM 访问此程序集中的类型





//请将此类型的 ComVisible 特性设置为 true。





[assembly: ComVisible(false)]





 





// 如果此项目向 COM 公开，则下列 GUID 用于类型库的 ID





[assembly: Guid("70dabedf-1206-4a25-a55a-d54ec5ec14a5")]





 





// 程序集的版本信息由下列四个值组成: 





//





//      主版本





//      次版本





//      生成号





//      修订号





//





//可以指定所有这些值，也可以使用“生成号”和“修订号”的默认值





//通过使用 "*"，如下所示:





// [assembly: AssemblyVersion("1.0.*")]





[assembly: AssemblyVersion("1.0.0.0")]





[assembly: AssemblyFileVersion("1.0.0.0")]

确保修改后重新生成程序集

4、生成nuget清单文件(.nuspec )

主要通过三个命令：nuget spec、nuget pack、nuget push

在解决方案.csject目录下执行cmd命令 nuget spec

示例：

C:\Users\Hebiangu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget spec

已成功创建“hebiangu.nugettest.nuspec”。

此时，在同级目录下生成了一个清单文件，内容如下：

<?xml version="1.0"?>





<package >





  <metadata>





    <id>$id$</id>





    <version>$version$</version>





    <title>$title$</title>





    <authors>$author$</authors>





    <owners>$author$</owners>





    <licenseUrl>http://LICENSE_URL_HERE_OR_DELETE_THIS_LINE</licenseUrl>





    <projectUrl>http://PROJECT_URL_HERE_OR_DELETE_THIS_LINE</projectUrl>





    <iconUrl>http://ICON_URL_HERE_OR_DELETE_THIS_LINE</iconUrl>





    <requireLicenseAcceptance>false</requireLicenseAcceptance>





    <description>$description$</description>





    <releaseNotes>Summary of changes made in this release of the package.</releaseNotes>





    <copyright>Copyright 2019</copyright>





    <tags>Tag1 Tag2</tags>





  </metadata>





</package>

5、执行打包命令，生成.nupkg文件

在解决方案.csject目录下执行cmd命令 nuget pack

示例：

C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget pack

正在尝试从“hebiangu.nugettest.csproj”生成程序包。

MSBuild auto-detection: using msbuild version '16.0.462.64354' from 'D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\bin'.

正在打包“C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\bin\Debug”中的文件。

正在对元数据使用“hebiangu.nugettest.nuspec”。

Successfully created package 'C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\hebiangu.nugettest.1.0.0.nupkg'.

此时在同级目录下会生成一个.nupkg文件，此时打包任务已经完成

6、上传发布Nuget包

首先、获取密钥：登录nuget.org 帐户，在右上角下拉菜单中找到API Key，点击Create创建一个密钥,输入Key Name，输入Glob Pattern 为 *，点击创建，完后点击Copy复制密钥 如： oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q，注意需要自己保存密钥

其次、上传包

在同级目录执行如下命令即可

nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json

hebiangu.nugettest.1.0.0.nupkg ：是打包最终生成的.nupkg文件

oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q：是产品密钥，产品密钥需要在注册nuget.org 帐户

示例：

C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json

Pushing hebiangu.nugettest.1.0.0.nupkg to 'https://www.nuget.org/api/v2/package'...

  PUT https://www.nuget.org/api/v2/package/

警告: <licenseUrl> element will be deprecated,please consider switching to specifying the license in the package. Learn more: https://aka.ms/deprecateLicenseUrl.

  Created https://www.nuget.org/api/v2/package/ 1831ms

Your package was pushed.

以上就是发布的全部过程

注意：

1、创建的 hebiangu.nugettest.1.0.0 名称不能和服务器上已有的包名重复，否则会报403错误，检查方式是到nuget上搜索一下有没有该名称的包

2、上传的包会通过审查，需要等一段时间大概一个小时以内才能搜索到

3、创建一个批处理文件一键发布

创建文件:nuget-push.bat

文件内容如下，将批处理文件放到程序集目录下执行即可一键发布:

cd  %~dp0

nuget spec

nuget pack

nuget push  hebiangu.nugettest.1.0.0.nupkg oy2leteteymeerertetedc3aufgfool4is6aj5q -Source https://api.nuget.org/v3/index.json

pause

此时在nuget.org和VS中可以搜索并应用自己的包了