少有人走的路

　NuGet是一个为大家所熟知的Visual Studio扩展，通过这个扩展，开发人员可以非常方便地在Visual Studio中安装或更新项目中所需要的第三方组件，同时也可以通过NuGet来安装一些Visual Studio的插件等。作为一名开发人员，您可能也会开发一些公共组件以供他人使用，本文将一步步介绍如何以最简单的方式将自己所开发的类库包发布到nuget上，以供更多的人使用。

　　使用NuGet发布自己的类库包（Library Package）步骤：

STEP 1：注册并获取API Key

首先，你需要到NuGet上注册一个新的账号，然后在My Account页面，获取一个API Key，这个过程很简单，我就不作说明了。

STEP 2：下载NuGet.exe

NuGet有个命令行工具：NuGet.exe;为了方便使用，请设置机器的PATH环境变量【exe所在目录】，将NuGet.exe的路径添加到PATH中。

在http://nuget.codeplex.com/releases页面底部找到NuGet.exe，点击下载即可

STEP 3：设置API Key

CMD使用以下命令设置NuGet API Key：

nuget setApiKey <my_api_key>

记得将上面的my_api_key替换为STEP 1中获得的API Key。

public class CastleHelper
{    public static Castle.Core.Pair<int, int> GetIntPair()
    {        return new Castle.Core.Pair<int, int>(20, 30);
    }
}

然后，打开AssemblyInfo.cs文件，将assembly的属性设置好，记得再设置一下AssemblyVersion特性，以指定我们类库的版本。目前我们使用1.0.0.0版本：

[assembly: AssemblyTitle("DaxnetNugetTest")]
[assembly: AssemblyDescription("Daxnet's test of the NuGet.")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("daxnet")]
[assembly: AssemblyProduct("DaxnetNugetTest")]
[assembly: AssemblyCopyright("Copyright © daxnet 2013")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
[assembly: ComVisible(false)]
[assembly: Guid("20662b9f-91de-4515-9c8c-ced3d61589e1")]
[assembly: AssemblyVersion("1.0.0.0")]

全部设置好以后，编译整个项目待用。

STEP 5：产生并修改nuspec

nuspec是NuGet将项目打包成nupkg的输入文件，可以通过nuget spec命令产生。在命令提示符下，进入DaxnetNugetTest.csproj文件所在目录，然后执行：

此时会提示创建成功：

用notepad打开DaxnetNugetTest.nuspec文件，把需要替换的信息替换掉，不需要的tag全部删掉，注意里面的$xxx$宏，这些就是引用了AssemblyInfo.cs中的设置值，在编译产生package的时候，会使用AssemblyInfo.cs中的相应值进行替换。完成编辑后，我们的nuspec文件如下：

<?xml version="1.0"?>
<package >
  <metadata>
    <id>$id$</id>
    <version>$version$</version>
    <title>$title$</title>
    <authors>$author$</authors>
    <owners>$author$</owners>
    <licenseUrl>http://www.apache.org/licenses/LICENSE-2.0.html</licenseUrl>
    <projectUrl>http://apworks.org</projectUrl>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>$description$</description>
    <releaseNotes>First release</releaseNotes>
    <copyright>Copyright 2013</copyright>
  </metadata>
</package>

注意两点：1、$description$使用AssemblyDescriptionAttribute的值进行替换，在产生package之前，一定要记得先编译项目，否则会提示$description$找不到的错误；2、releaseNotes如果没有，就直接删掉这个节点，如果有，则填入自己的内容，不要使用默认内容，否则会在下一步产生警告信息。

STEP 6：产生类库包

同样在DaxnetNugetTest.csproj路径下，使用下面的命令产生NuGet类库包：

nuget pack DaxnetNugetTest.csproj

注意：由于我们的项目通过NuGet引用了Castle.Core，因此，它将会作为一个依赖组件（dependency）打包到产生的nupkg文件中。

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

nuget pack DaxnetNugetTest.csproj -Prop Configuration=Release

STEP 7：发布类库包

现在，通过以下命令发布类库包：

nuget push DaxnetNugetTest.1.0.0.0.nupkg

完成以后，出现以下提示：