NugetServer 使用指南
为什么要使用Nuget
在我们的项目， 存在着一些公共Dll， 这些Dll被大量的项目所引用。同时这些公共dll也同时在进行版本升级， 由于缺乏版本管理，这些Dll会被到处Copy，导致各个项目所应用的版本不一致。
极端的情况是A项目和B项目都引用了一些Common Dll， 他们引用的Common Dll版本还可能不一致， 随着需求的变化，可能在某一天就会出现让A项目依赖B项目的情况。
这时我们就可能陷入dll版本陷阱中。
如果我们有一个好的包管理器， 当管理器中的包升级的时候，依赖这个包的项目可以得到提示，那么我们就可以这简单地让我们的项目始终依赖最新的dll版本， 可以很自然的避免版本陷阱的发生。
在.net的世界里， 这个包管理器就是Nuget
Nuget Server搭建
Nuget Server的搭建十分简单， 微软已经为我们什么都准备好了。
- 在VS中创建一个Empty Web Application
- 选择Tools > Library Package Manager > Package Manager Setting，确认Package Manager的Package Sources已经添加nuget官方源：https://www.nuget.org/api/v2/,
VS2013以上版本应该已经集成。 - 在步骤1新建的Web Application中的Reference上右击， 选择Manage Nuget Package
- 在弹出的对话中， 选择Online Tab， 然后搜索NugetServer， 点击安装
- 修改web.config的requireApiKey=False, 或者设置requireApiKey=true，则必须设置apiKey，否则Push Package会报403错误
至此， 一个NugetServer就搞定了， 很简单吧？赶紧将Server部署起来吧！！！
添加Nuget Server Feed
记得在Nuget Server搭建部分讲的怎么确认nuget官方源是否已添加吗？ 你已经知道怎么添加我们自己的Nuget Server源了吧。
添加好源之后， 只要把我们Nuget Package放到Server根目录的Packages的文件夹下，这个Package就可以被我们使用了
如何制作Nuget Package
在我们的项目里， 有两种dll我们需要利用Nuget来进行版本管理。
- 第三方Dll， 我们没有源码， 为了保证各个项目中引用的版本能够保持一致， 且能够同时得到更新，我们需要Nuget
- 我们自己产生的公共Dll， 大量的项目都在引用这些Dll， 我们也需要Nuget
在制作Nuget Package之前，我们需要下载Nuget.exe。
下载好之后将Nuget.exe存放的目录配置到环境变量里，以便PowerShell能够认识nuget Command
为第三方Dll制作Package
- 新建lib文件夹
- 将需要打包的dll放到lib文件夹下。放到lib文件夹下的目的是在使用Nuget添加引用后dll可以自动地添加到reference中
- 在DOS Console中将目录跳转到lib文件夹所在的目录，执行命令
Nuget Spec xxx.dll - 上一步的命令会生成一个nuspec文件， 需要手动编辑这个文件，制定PackageID， Version等信息
- 执行
Nuget Pack xxx.dll.nuspec即可 - 执行
Nuget Push [PackageID] -s [NugetServerUrl] [ApiKey]推送到Nuget Server了
为Project制作Package
- 将目录跳转到Solution根目录
- 执行命令
Nuget Pack xxx.csproj -Build -Prop Configuration=Release -IncludeReferencedProjects即可生成Package - 执行命令
Nuget Push [PackageID] -s [NugetServerUrl] [ApiKey]推送到Nuget Server了
从Nuget Server引用Package
有两种方式：
- 通过Nuget Package Manager来引用
- 通过命令行来引用
这里讲几个常用命令行的操作， 通过Tools > Nuget Package Manager > Packge Manage Console, 打开Package Manage Console
- 查看可用的Package
Get-Package -AvailablePackage - 安装Package
Install-Package [PackageID] [-Version] - 更新Package
Update-Package - 卸载Package
UnInstall-Package - 清空本地nuget Package Cache
nuget locals all -clear - 这些命令的具体用法，可以通过
Get-Help Command查找帮助
一键打包一键发布
- 制作打包批处理
if exist $1*.nupkg del $1*.nupkg
nuget pack $2 -Build -Prop Configuration=Release -IncludeReferencedProjects -o $1
- 制作上传包文件到nuget server feed的批处理
nuget push $1*.nupkg -s [NugetServerURL] [ApiKey]
将[NugetServerURL]和[ApiKey]替换成你自己的NugetServerFeed地址和key
-
在Visual Studio的Project右键菜单上添加Pack Nuget Package和Publish Nuget Package菜单
- Tools 》External Tools... 添加External Command
- Tools 》 Cutomize... 》Commands 》Context menu... 》Project and Solution Context Menus | Project
- Add Command 》 Tools
- 选择External Command n， n就是你之前添加在External Tools中的External Command的是第几个这里的n就是几
Nuget Server是严格按照版本号来进行包管理的，如果同一个版本号的Package被多次被推送到Nuget Server Feed，后推送的会覆盖之前推送的版本。但是本地引用的Package还是没有更新，原因是因为在引用Nuget Server Feed上的Package的时候，不但会引用到Solution目录的packages目录下，同时也会被缓存在.nuget的公共缓存目录。多次推送一定要清空公共目录缓存，否则Solution下的packages文件夹中的Package不会被更新。
如果一个Solution下面包含的所有Project都要用Nuget来进行包管理，并且它们之间存在依赖关系，则应该按照依赖关系由弱到强的顺序进行打包并Push到Nuget Server。如果Pack的时候选择了IncludeReferencedProjects参数，引用关系强的Project会自动引用依赖关系弱的Project，前提是项目目录下要有nuspec文件，否则会直接将引用项目的dll包含到Package。
