一、目的:很多时候都在用第三方的Nuget包,现成的轮子可以减少很多工作量,同时我们也可以造轮子供自己和其他人使用,本示例主要演示如何发布dll到Nuget上
二、环境:
Win10、VS2019、nuget.exe、nuget.org 帐户
三、步骤:
1、创建nuget.org 帐户
2、下载nuget.exe
下载地址:https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
将nuget.exe 设置系统环境变量,方便使用命令,也可以不设置,不设置则要使用全路径
3、创建一个程序集
设置程序集描述信息,这些会生成在nuget包中
// 有关程序集的一般信息由以下
// 控制。更改这些特性值可修改
// 与程序集关联的信息。
[assembly: AssemblyTitle("我的标题")]
[assembly: AssemblyDescription("我的说明")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("我的公司")]
[assembly: AssemblyProduct("我的产品")]
[assembly: AssemblyCopyright("Copyright © 2019")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
// 将 ComVisible 设置为 false 会使此程序集中的类型
//对 COM 组件不可见。如果需要从 COM 访问此程序集中的类型
//请将此类型的 ComVisible 特性设置为 true。
[assembly: ComVisible(false)]
// 如果此项目向 COM 公开,则下列 GUID 用于类型库的 ID
[assembly: Guid("70dabedf-1206-4a25-a55a-d54ec5ec14a5")]
// 程序集的版本信息由下列四个值组成:
//
// 主版本
// 次版本
// 生成号
// 修订号
//
//可以指定所有这些值,也可以使用“生成号”和“修订号”的默认值
//通过使用 "*",如下所示:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
确保修改后重新生成程序集
4、生成nuget清单文件(.nuspec
)
主要通过三个命令:nuget spec、nuget pack、nuget push
在解决方案.csject目录下执行cmd命令 nuget spec
示例:
C:\Users\Hebiangu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget spec
已成功创建“hebiangu.nugettest.nuspec”。
此时,在同级目录下生成了一个清单文件,内容如下:
<?xml version="1.0"?>
<package >
<metadata>
<id>$id$</id>
<version>$version$</version>
<title>$title$</title>
<authors>$author$</authors>
<owners>$author$</owners>
<licenseUrl>http://LICENSE_URL_HERE_OR_DELETE_THIS_LINE</licenseUrl>
<projectUrl>http://PROJECT_URL_HERE_OR_DELETE_THIS_LINE</projectUrl>
<iconUrl>http://ICON_URL_HERE_OR_DELETE_THIS_LINE</iconUrl>
<requireLicenseAcceptance>false</requireLicenseAcceptance>
<description>$description$</description>
<releaseNotes>Summary of changes made in this release of the package.</releaseNotes>
<copyright>Copyright 2019</copyright>
<tags>Tag1 Tag2</tags>
</metadata>
</package>
5、执行打包命令,生成.nupkg文件
在解决方案.csject目录下执行cmd命令 nuget pack
示例:
C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget pack
正在尝试从“hebiangu.nugettest.csproj”生成程序包。
MSBuild auto-detection: using msbuild version '16.0.462.64354' from 'D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\bin'.
正在打包“C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\bin\Debug”中的文件。
正在对元数据使用“hebiangu.nugettest.nuspec”。
Successfully created package 'C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\hebiangu.nugettest.1.0.0.nupkg'.
此时在同级目录下会生成一个.nupkg文件,此时打包任务已经完成
6、上传发布Nuget包
首先、获取密钥:登录nuget.org 帐户,在右上角下拉菜单中找到API Key,点击Create创建一个密钥,输入Key Name,输入Glob Pattern 为 *,点击创建,完后点击Copy复制密钥 如: oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q,注意需要自己保存密钥
其次、上传包
在同级目录执行如下命令即可
nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json
hebiangu.nugettest.1.0.0.nupkg :是打包最终生成的.nupkg文件
oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q:是产品密钥,产品密钥需要在注册nuget.org 帐户
示例:
C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json
Pushing hebiangu.nugettest.1.0.0.nupkg to 'https://www.nuget.org/api/v2/package'...
PUT https://www.nuget.org/api/v2/package/
警告: <licenseUrl> element will be deprecated,please consider switching to specifying the license in the package. Learn more: https://aka.ms/deprecateLicenseUrl.
Created https://www.nuget.org/api/v2/package/ 1831ms
Your package was pushed.
以上就是发布的全部过程
注意:
1、创建的 hebiangu.nugettest.1.0.0 名称不能和服务器上已有的包名重复,否则会报403错误,检查方式是到nuget上搜索一下有没有该名称的包
2、上传的包会通过审查,需要等一段时间大概一个小时以内才能搜索到
3、创建一个批处理文件一键发布
创建文件:nuget-push.bat
文件内容如下,将批处理文件放到程序集目录下执行即可一键发布:
cd %~dp0
nuget spec
nuget pack
nuget push hebiangu.nugettest.1.0.0.nupkg oy2leteteymeerertetedc3aufgfool4is6aj5q -Source https://api.nuget.org/v3/index.json
pause
此时在nuget.org和VS中可以搜索并应用自己的包了