[经验分享]NuGet发布自己的Dll(类库包)

什么是Nuget

Nuget是一个.NET平台下的开源的项目，它是Visual Studio的扩展。在使用Visual Studio开发基于.NET Framework的应用时，Nuget能把在项目中添加、移除和更新引用的工作变得更加快捷方便。

详解百科：https://baike.baidu.com/item/NuGet/5296055?fr=aladdin

发布自己的类库包（Library Package）

Step1:在NuGet上注册并获取API Key

官网地址：https://www.nuget.org/

如果已经有登陆的，那么就选择

获取APIKey

建立完成以后，这个下面有个Copy的按钮，点击可以获取到ApiKey

Step2:下载NuGet.exe,配置命令行工具

下载地址：http://nuget.codeplex.com/downloads/get/669083

配置本地电脑环境变量Path路径：

右键我的电脑---->属性---->高级系统设置

配置完成后，使用Win+R键，输入cmd，点击回车，进入命令行

输入nuget后，显示上图信息，即为配置成功。

Step3:配置全局push 源地址

使用下面命令进行配置

 //配置模拟的push源为nuget.org
 nuget config -Set DefaultPushSource=nuget.org

Step4:设置Api Key

使用下面命令进行设置Nuget API Key：

 //将下面my_api_key替换为STEP 1中获得的API Key
 nuget setApiKey my_api_key

Step5:开发自己的类库

源码：

 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.Threading.Tasks;

 namespace DemoDll
 {
     public class Demo
     {
         public string Hello()
         {
             return "Hello";
         }
     }
 }

打开AssemblyInfo.cs文件，设置属性值

 using System.Reflection;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;

 // 有关程序集的一般信息由以下
 // 控制。更改这些特性值可修改
 // 与程序集关联的信息。
 [assembly: AssemblyTitle("")]
 [assembly: AssemblyDescription("")]
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("")]
 [assembly: AssemblyProduct("")]
 [assembly: AssemblyCopyright("Copyright © 2018")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]

 // 将 ComVisible 设置为 false 会使此程序集中的类型
 //对 COM 组件不可见。如果需要从 COM 访问此程序集中的类型
 //请将此类型的 ComVisible 特性设置为 true。
 [assembly: ComVisible(false)]

 // 如果此项目向 COM 公开，则下列 GUID 用于类型库的 ID
 [assembly: Guid("437fac93-d41d-48c4-9e64-dd96c1a0cd8f")]

 // 程序集的版本信息由下列四个值组成:
 //
 //      主版本
 //      次版本
 //      生成号
 //      修订号
 //
 // 可以指定所有值，也可以使用以下所示的 "*" 预置版本号和修订号
 //通过使用 "*"，如下所示:
 // [assembly: AssemblyVersion("1.0.*")]
 [assembly: AssemblyVersion("1.0.0.0")]
 [assembly: AssemblyFileVersion("1.0.0.0")]

Step6:生成nuspec文件，并修改

在命令提示符下，进入xxxx.csproj文件所在目录，然后执行：

 //生成nuspec文件命令
 nuget spec

 //命令提示行提示
 已成功创建“ML.Common.SDK.nuspec”。

使用你习惯使用的文本编辑器打开此文件xxxx.nuspec

 <?xml version="1.0"?>
 <package >
   <metadata>
     <id>$id$</id>
     <version>$version$</version>
     <title>$title$</title>
     <authors>$author$</authors>
     <owners>$author$</owners>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <description>$description$</description>
     <copyright>Copyright 2018</copyright>
     <tags>Tag1 Tag2</tags>
   </metadata>
 </package>

注意事项：

1.$description$使用AssemblyDescriptionAttribute的值进行替换，在产生package之前，一定要记得先编译项目，否则会提示$description$找不到的错误

2.releaseNotes如果没有，就直接删掉这个节点，如果有，则填入自己的内容，不要使用默认内容，否则会在下一步产生警告信息

3.authors节点与description节点不能删除，否则会报错

Step7:生成类库包（Library Package）

在xxxx.csproj的目录下，执行下面命令生成类库包：

注意：NuGet会使用默认的项目配置所产生的程序集进行打包。如果项目默认是Debug，而你需要用Release打包，则使用下面的命令

 //生成类库包
 nuget pack .\ML.Common.SDK.csproj -Prop Configuration=Release

Step8:发布类库包到Nuget.org

通过以下命令发布：

 //发布类库包
 nuget push .\ML.Common.SDK.1.0.0.1.nupkg