NugetServer 使用指南
为什么要使用Nuget
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 Package
为第三方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
- 查看可用的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
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。