使用NuGet发布自己的.NET NuGet 包( .NET Standard & Windows)

发布自己的nuget包

STEP 1:获取API Key

首先,你需要到NuGet上注册一个新的账号,然后在My Account页面,获取一个API Key,或者是自建服务器上生成一个API Key(我没有自建服务器,所以这个过程我不太清楚,直接问你们公司的IT要呗)

STEP 2:部署本地NuGet.exe

NuGet有个命令行工具:NuGet.exe,通过该工具,在CMD中通过命令行可以实现你要的所有功能。

为了方便使用,请设置机器的PATH环境变量,自己选一个路径把NuGet.exe放里面,然后把该路径注册的PATH环境变量,重启计算机。

STEP 3:设置API Key

在cmd命令行工具中使用以下命令设置NuGet API Key:

> setApiKey <my_api_key>

设置了这个API Key后你的计算机会吧该key记住,在后面进行推送的时候会使用该key进行验证操作

STEP 4:开发自己的类库(Class Library)

我开发的是一个C#的类库,开发完成后在Properties下的AssemblyInfo.cs里面吧相关信息完善,打包的时候nuget会获取这里面的信息,然后编译生成该项目

STEP 5:打包(生成清单文件)

打开CMD窗口,通过cd命令切换到*.csproj(我的是NuGet.lyh.Practice.csproj)目录下,通过以下命令生成打包的清单文件

> nuget spec

执行完你会看到NuGet.lyh.Practice.csproj目录下多了一个NuGet.lyh.Practice.nuspec文件。

手动打开NuGet.lyh.Practice.nuspec文件,把需要替换的信息替换掉,不需要的tag全部删掉,注意里面的$xxx$宏,这些就是引用了AssemblyInfo.cs中的设置值,在编译产生package的时候,会使用AssemblyInfo.cs中的相应值进行替换。

注意两点:

1、$description$使用AssemblyDescriptionAttribute的值进行替换,在产生package之前,一定要记得先编译项目,否则会提示$description$找不到的错误;

2、releaseNotes如果没有,就直接删掉这个节点,如果有,则填入自己的内容,不要使用默认内容,否则会在下一步产生警告信息。

STEP 6:打包(生成*.nupkg包)

在cmd窗口中使用如下命令打包生成*.nupkg包

nuget pack NuGet.lyh.Practice.csproj

nuget pack NuGet.lyh.Practice.csproj –IncludeReferencedProjects    打包时包含引用的项目

nuget pack NuGet.lyh.Practice.csproj -Prop Configuration=Release   打包release的dll,默认打包的是debug目录下的dll

执行完成后会发现多了一个NuGet.lyh.Practice.1.0.1.nupkg文件,到这里就成功的生成了nupkg包了

STEP 7:发布自己的类库

如果你执行了步骤三,你的ApiKey已经记在系统中了,使用如下命令就可以将*.nupkg包推送到nuget.org服务器了

> nuget push NuGet.lyh.Practice.1.0.1.nupkg –Source nuget.org (步骤三,你的ApiKey已经记在系统中)

> nuget push NuGet.lyh.Practice.1.0.1.nupkg {ApiKey} –Source nuget.org  (明确指定ApiKey)

如果你是自建了服务器的话把Source参数nuget.org 修改成你自己的服务器地址就行了

比如我们公司的服务器nuget地址是http://192.1.1.1:1000/nuget那么我使用下面这条命令进行推送

> nuget.exe push {package file} {apikey} -Source http://192.1.1.1:1000/nuget

同一个名字同一个版本的包只能推送一次哦

在批处理命令中实现自动打包并推送到nuget服务器

@echo off
::项目名称和程序集名称(经常是同样的名字,但是也可能不一样,看你自己项目设置)
set ProjectName={替换成你项目名字}
set AssemblyName={替换成你打包程序及名字}
::Nuget发布的账号密码,中间用英文冒号隔开(account:password)
set ApiKey= {替换成你的ApiKey}
::发布模式 Release/Debug
set PublishMode=Release
::Nuget发布地址
set SourceUrl=nuget.org

::这里开始禁止修改
del %AssemblyName%.*.nupkg /F /Q
nuget pack %ProjectName%.csproj -Build -Prop Configuration=%PublishMode%
nuget push %AssemblyName%.*.nupkg -Source %SourceUrl% -ApiKey %ApiKey%
del %AssemblyName%.*.nupkg /F /Q

在Gitlab的CI脚本中实现自动打包并推送到nuget服务器

在yml脚本开头先定义这些变量

variables:  
  DeployPrjName: {你的项目名字}
  DeployAssemblyName: {你要打包的程序及名字}
  ApiKey: {你的ApiKey}
  PublishMode: Release
  SourceUrl: nuger.orgt

在yml脚本deploy stage中加上这样一个job就能实现在mster分支推送过去后自动打包并推送道你的nuget服务器发布了

deployJob:
  stage: deploy
  tags:
  - Windows
  - VisualStudio
  only:
  - master
  script:
  - echo "starting deploy"
  - cd "%DeployPrjName%"
  - del %DeployAssemblyName%.*.nupkg
  - C:\tools\nuget.exe pack %DeployPrjName%.csproj -Build -Prop Configuration=%PublishMode%
  - C:\tools\nuget.exe push %DeployAssemblyName%.*.nupkg -Source %SourceUrl% -ApiKey %ApiKey%
  - rmdir /s  /q bin
  - rmdir /s  /q obj 
  - del %DeployAssemblyName%.*.nupkg /F /Q 
  dependencies:
  - buildJob

C#程序设置版本自动更新

项目>属性>应用程序>程序集信息(I)中将版本号最后一位或最后两位修改成*即可,如下图所示

image

应为只有版本号更新了nuget才能推送成功,所以这个步骤非常必要

获取NuGet包

在C#项目 引用 上右键选择 管理NuGet程序包 跳出如下界面,在界面上选择一下程序包源就可以搜索浏览对应源位置的nuget包了,如下图所示。(我的包是推送到公司服务器,大多数时候大家推送到nuget.org,所以程序包源默认都是选择nuget.org)

image

怎样设置添加自己公司的程序包源或者是本地磁盘上的离线*.nupkg文件呢?

在程序包源右边的设置按钮弹出如下窗口,在这里设置Nuget包源位置并点击更新就行了。

image

Nuget包的三种不同来源

1.nuget.org

这是默认就有的

2.你公司自建服务器

将包源位置设置你你公司服务器url即可,如上图中程序包源MyCompany项设置

3.本地硬盘离线包文件

在上图中包源位置设置时,点击黄色高亮的“…”按钮,浏览找到你的nuget包(*.nupkg)所在目录,将包源位置设置为该目录即可

 

在没有网络的情况下用户怎样还原依赖的Nuget包

在没有网络的情况下Visual studio无法连接到Nuget包数据源服务器,会导致无法恢复Nuget包产生找不到引用项的问题。该问题可以在其他有网络的计算机上获取Nuget包,拷贝过来放在你计算机上某个位置,在包源列表中添加一项,把包源位置设置为该目录即可。Visual Studio在恢复nuget包的时候再尝试遍历你的包源列表,直到获取到该包为止。

获取Nuget包文件

方法一:

在已经安装了该包的solution下找到packages文件夹,Nuget包文件就在这里,直接拷贝即可

方法二:

在有网络的地方,打开cmd命令行输入以下命令下载包文件

      nuget install SeeSharpTools.JXI.Debug -Source {Source url} -DirectDownload

参考

Microsoft Note:创建 NuGet 包

Microsoft Note:快速入门:使用 Visual Studio 创建和发布 NuGet 包(仅限 .NET Standard 和 Windows)

Microsoft Note:.nuspec 引用

Microsoft Note:NuGet CLI 参考

https://docs.microsoft.com/zh-cn/nuget/tools/nuget-exe-cli-reference

https://blog.csdn.net/huwei2003/article/details/53116851

https://msdn.microsoft.com/zh-cn/magazine/hh547106.aspx

https://www.cnblogs.com/xcsn/p/6258005.html

NuGet 使用问题 Source parameter was not specified.

使用NUget发布自己的dll(转)

发布自己的类库到NuGet

Vs自定nuget push菜单

原文地址:https://www.cnblogs.com/lyh523329053/p/10145116.html