Nuget快捷实践
Nuget快捷实践
简介
本文主要包含三个部分,即创建nuget包、上传nuget包和删除nuget包。旨在引导快速使用nuget打包和使用,并实现对于nuget的简单管理。
本文使用的nuget服务是基于自行搭建的nuget server v3.0.0.0。具体搭建方法可以参考nuget官方的指导教程。
另外文章中还涉及到两个程序:
- Nuget Package Explorer:v4.1.38
- nuget.exe:v4.5.1.4879
本文阅读时间大约为十分钟。
创建nuget包
对于nuget的打包方式的权威指南当然是nuget官方的指导文档。这份文档优点是对于nuget包的结构讲解的很清楚,缺点是不太符合本文的快速实践的意图。针对这个情况也有解决办法,万能的网友们开发了Nuget Package Explorer,目前该项目托管在Github上,安装了Win10系统的可以直接到微软应用商店下载。
打开Nuget Package Explorer后选择新建package,在新建界面中填写必要信息。包括包的Id,版本号,作者,发布说明等。
以上图为例,在新建nuget包时重点填写如下信息:
- Id:包的唯一标识,本文以Company.Application.Model.Lib为例
- Version:当前发布的类库版本号,本文以1.0.0为例
- Title:类库名称
- Authors:作者
- Owners:所有者
- Description:类库描述
- Release Notes:当前版本的发布说明
如果需要添加dll文件,则在右侧的Package Contents空白区域右键,在菜单中选择Add Lib Folder,并在新出现的lib上右键,在菜单中选择“Add Existing File...”。操作界面参考下图。
创建有依赖的nuget包
如果编译类库时如果有的dll是别的nuget包的,最好是将被依赖的nuget包添加到当前nuget包的依赖项中。否则用户同时下载两个类库时,可能出现相同的dll文件被覆盖的情况,以至于难于控制dll的版本,而且容易出现编译问题。
那么如何添加依赖项呢?参考下图的步骤:
在填写类库信息的Package Metadata页最下方有个按钮,点击后弹出相关的编辑页面。下图以标注的形式说明操作顺序:
- 点击
Edit Dependencies
按钮弹出依赖项编辑页面 - 点击Groups旁边的加号按钮,Tip是
Add a new group
,不要编辑Target Framework
编辑框 - 点击依赖项编辑页面下方的小手图标的按钮,Tip是
Select dependency from nuget feed
- 在弹出的
Select package
页面选择相关的依赖项并双击,完成选择 - 使用自己搭建的nuget站点时,
Select package
页面的Package Source可能是http://域名:端口/nuget/
上传nuget包
上传nuget包的方式很简单,在Nuget Package Explorer的File->Publish
菜单,就可以打开nuget上传页面。该页面需要填写两个内容:
- Publish Url:nuget服务器的发布地址,可以在nuget server首页查看到
- Publish key or PAT:发布时验证合法性的密钥,可以跟nuget server的管理员询问得到
删除nuget包
经过上面的几个步骤之后,nuget包就已经完成打包和发布工作了,并且可以提供给其他同事使用。但是如果不小心上传了错误的nuget包,或者在发布后一段时间发现有的nuget包版本存在严重问题,不能提供给其他人使用,而且想要删掉该怎么办呢?
对此Nuget Package Explorer表示无能为力,要完成这个工作可以借助nuget官方提供的nuget.exe工具来完成这个事情。
nuget.exe支持delete命令,详细文档可以参考此处
从官方网站下载nuget.exe在命令行中直接执行nuget.exe
后(不含参数),会列出nuget程序支持的所有命令:
输入nuget help delete
,弹出如下提示:
以本文中上传的nuget包Company.Application.Model.Lib v1.0.0
为例,删除命令是:
nuget delete Company.Application.Model.Lib 1.0.0 -ApiKey xxxx -Source http://ip:port/nuget
执行命令后会弹出提示,提示是否真的需要删除,直接输入y
并回车就ok了。
总结
相对于传统的dll管理方式,使用nuget的方式可以极大的提高方便性并有效的对于依赖项进行版本化的管理。解决方案编译时还能自动下载nuget包的相关内容,有条件的情况下还是尽量使用nuget进行公共文件的管理。