1. NuGet是什么?
NuGet is a Visual Studio 2010 extension that makes it easy to add, remove, and update libraries and tools in Visual Studio projects that use the .NET Framework. This topic lists documentation that will help you use NuGet packages and create your own.
NuGet 是一个Visual Studio的扩展。在使用Visual Studio开发基于.NET Framework的应用时,NuGet能够令你在项目中添加、移除和更新引用的工作变得更加快捷方便。
这就是说: 我们往往在开发项目里,会使用一些第三方的dll, 如:Newtonsoft.Json.dll (它为我们提供了进行序列化和反序列化解决方案, 很有用,也很稳定,还很有名气)。
但是,我们往往也面临随着项目升级,对这些引入的第三方插件进行升级的可能和必要。
比方说,原本的项目是vs2008 + C# 3.5 实现的,并引入了Newtonsoft.Json.dll 2.0版本, 现在对项目升级成了Vs 2010 + C# 4.0。
如果 你想或者必须将旧版本升级到最新版本才能工作或者仅是保持版本上的一致;同时,Newtonsoft 提供Json.Net对C# 4.0 支持版本,即:Newtonsoft.Json.dll 4.0。
你就需要到官网或者通过Google 去寻找它的最新版本,下载,解压,然后替代等操作。 似乎看上去,也没多少复杂的事情,也习以为常了。谁叫咱引用别人的东西,只能跟着走了,习惯了这样的更新,总比自己写更快吧。
现在,NuGet 将这个过程系统化,令你可以更加方便的查找你要的第三方的dll, 同时,还可以为你提供自动或者手动更新,而无需你在人肉搜索与更新了。
为什么要使用NuGet
简单的说NuGet可以是我们的工作更方便,当我们的项目里要引用到的一些库时候,比如JQuery、Newtonsoft.Json、log4net等,我们需要从网上下载这些库,然后依次拷贝到各个项目中,当有的类库有更新时又不得不再重复一遍很是繁琐 ,这时就可以考虑使用NuGet来帮我们管理和更新这些类库,而且更新类库时会自动添加类库的相关引用,方便至极。当然网上一些我们常用的类库更新频率不是很高而且即便出了新版本我们也没必要总是保持最新,故这点对我们的帮助比较有限,个人认为NuGet最大的好处在于可以搭建自己的类库服务器,想想一下吧,在一些较大些的公司里面有很多的项目,然后其中有一些是整个组,甚至整个公司通用的类库,当这些类库有更新后我们需要依次拷贝到我们的项目,甚至于有时候我们自己都搞不清楚各个项目里的版本是否一致,有时偶尔一两个项目忘了复制更新出现莫名其妙的错误,为此头疼不已,现在有了NuGet,世界从此而不同。
在VS2010中,NUGET管理包需要手动安装,但是在VS2012中,安装的时候就自动帮你集成上去了,所以不需安装
2010中需要安装以上两个包,才可以用哦。
这次的配置NUGET包任务是在2012的,所以直接说主题吧:
1. 首先下载 包包管理器NuGetPackageExplorer,顾名思义,包包管理器可以用来创建新的类库包,也可以浏览已经创建好的类库包
2. 下载完成后,双击NuGetPackageExplorer.application 进行安装,安装完成后会在桌面上生成一个NuGet Package Explorer 的快捷方式
3. 双击NuGet Package Explorer出现启动界面,选择Create a new package(Ctrl+N)创建一个新包
4. 选择菜单Edit>Edit Package Metadata(或者CTRL + K) 编辑包包信息
这里可以编辑类库包的信息和添加类库、程序集的引用解释下几个比较重要的字段
Id:用于定位类库包的唯一标示,如在命令行下执行 Install-Package MyPackage 这里的MyPackage就是包包的Id值
Version:类库的版本号,这里建议和程序集的真实版本号保持一致,以免发生混淆
Dependencies:此类库依赖的程序集,根据实际情况添加依赖类库的Id和版本号,若无留空即可,这里需要注意下填写的依赖类库需要在NuGet服务器上能找到,否则无法完成自动引用添加
Framework assemblies:依赖的Framework 程序集,根据实际需要选择即可,一般无需设置
除以上四项以外其他属性根据实际情况修改即可,若自己用不修改也中,不过为了使用方便还是建议把类库描述(Description)填写下
5. 编辑好包包信息后接下来添加DLL到包包中
可以选择 右键-->Add Existinng File... 选择dll添加,也可以直接拖拽DLL到 Package contents 窗口,此例选择拖拽方式
直接拖拽dll到窗口后,会出现提示:是否将Winista.HtmlParser.dll放到lib 文件夹下,一般我们选择是
6. DLL添加完成后,快捷键Ctrl + K 修改包包信息Id为Winista.HtmlParser,版本号为1.8.0
7. 信息修改和dll都添加完毕后,选择File --> Save(或Ctrl + S)将文件进行保存,默认文件名为Id + 版本号.nupkg
8. 完成保存后如需要发布到网上,选择File--> Publish...(或Ctrl + P)
默认的发布地址是官网,发布 Key需要到官网去注册一个账号,然后就可以得到,这里不在复述,若无需发布直接关闭即可
ps:这里没有讲述如何打包项目文件,一般情况下我们自己将项目文件编译成DLL然后使用图形化界面打包即可满足需求,若实际工作需要高度集成完全自动化操作可自行去研究下官方文档http://docs.nuget.org/
添加DLL默认会添加Lib文件夹,额外的菜单上还有很多.net文件夹,src等文件夹,这些文件夹只是对文件上的一个物理上的划分而已,只是为了帮助我们做好文件分类,没有其他的用途,dll文件可以随便放置,不过为了规范还是建议按照通常习惯来放置。
以上就是配置NUGET包的基本流程,我的问题出现在什么地方?可能大家会觉得这个问题很低端。。好吧,我本身其实就是个菜鸟,这个问题是出现在引用这个NUGET包上,我们还是按照步骤来说
点击添加,进入选择界面,这个时候,我遇到的问题出现了,由于选择源的时候,我每次都定位到了包文件(例:D:6998Package.1.0.0.nupkg),导致引用完成后出现如此的情况
这个问题让我蛋疼不已!
后来才发现,正确的方法是将生成的文件,直接放到一个文件夹中,然后源选择应该直接定位到文件夹,(例如:D:test),这样的话,就大功告成
如此,我们变可以使用自己的NUGET包了