长话短说, 今天分享如何在nuget.org创建并发布.NET Standard package。
前置
安装勾选.NET Core开发套件的Visual Studio; 安装dotnet Cli
从VS2017开始,dotnet Cli已经自动在.NET开发套件中被安装;使用
SDK-style format
(SDK属性)的.NET Standard项目需要dotnet Cli;nuget.exe Cli用于非SDK样式的项目(通常是.NET Framework)。
创建.NET Standard库项目
配置package属性
项目右键,选择
属性
--->打包
打包
面板只会出现在VSSDK-style
项目,典型如.NET Standard或者.NET Core库项目。
构建时生成Nuget包
:顾名思义,除打包命令,构建时也会自动生成nuget包;标记
:帮助其他人定位你的包,了解包的能力。
给package设定一个唯一id,并填写其他属性。注意这个package id需要在nuget.org全站唯一,我们建议你使用包前缀名来避免重复,比如:${UserName}.PackageName
打包
将配置改为
Release
右键项目--> 打包
如果你没有看到打包命令,你的项目可能不是SDk-style风格的项目,这是要使用 nuget.exe Cli(或者迁移到SDK-style项目,再使用dotnet Cli)。
Visual Studio构建项目并创建
.nupkg
文件,插看输出窗体,获取包文件的路径。
发布包
有了.nupkg文件,你可以从nuget.org获取一个API key(这个Key标记了你这个nuget账户),结合dotnet cli发布包。
获取API Key
登陆nuget.org账户
点击右上角你的账户名字,选择
API keys
创建---> 选择范围--> Push, 在Glob pattern填入*
一旦生成key,请尽早Copy并保存key,这个key将在dotnet Cli命令中用到
尽快保存你的key,如果你再次返回这个页面,你需要重新生成key并Copy.
发布包
转到包含.nupkg文件的目录,执行下面命令
dotnet nuget push AppLogger.1.0.0.nupkg -k qz2jga8pl3dvn2akksyquwcs9ygggg4exypy3bhxy6w6x6 -s https://api.nuget.org/v3/index.json
显示如下结果:
info : Pushing AppLogger.1.0.0.nupkg to 'https://www.nuget.org/api/v2/package'...
info : PUT https://www.nuget.org/api/v2/package/
info : Created https://www.nuget.org/api/v2/package/ 12620ms
info : Your package was pushed.
推送命令中的错误通常表明存在问题 , 如:
您可能忘记了更新项目中的版本号,而尝试发布已经存在的软件包。
您尝试使用主机上已存在的标识符发布程序包时,也会看到错误:名称“ AppLogger”已经存在。
Response status code does not indicate success: 403 (The specified API key is invalid,
has expired, or does not have permission to access the specified package.).
如果您使用的是有效 API key,则此消息表示命名冲突,从以上错误的“权限”部分无法完全看出这一点。更改程序包标识符,重建项目,重新创建.nupkg文件,然后重试push命令。
其他一些包管理的操作,请在nuget包管理中心倒腾。
关注我们
更多技术干货及#副业刚需#
请关注Dotnet Plus公众号
▲
▲
“阅读全文,体验更佳”