使用批处理根据项目工程文件生成Nuget包并发布(支持.NET Core)

时间:2022-08-28 19:21:49

最近在使用之前自己编写的批处理给.NET Core项目打包时出问题了,发现之前的脚本根本不适用了,折腾了半天,总算解决了。因此在这里分享下经验,并且奉上整理好的脚本。

Nuget包这里就不多介绍了,需要了解的请访问:https://docs.microsoft.com/zh-cn/nuget/

下面开始本篇教程。

下载Nuget.exe

下载地址:https://www.nuget.org/

注意下载最新的Nuget.exe,尤其是打包.NET Core项目时。

编写打包脚本

首先我们在解决方案目录下新建一个pack.bat。内容如下:

:: 包搜索字符串
echo %1
:: 项目方案地址
echo %2 :: 删除历史包
del %1 /f /q /a :: 包名称
set nupkg="" :: 打包
nuget Pack %2 -Build -Properties Configuration=Release :: 更新包名称
for %%a in (dir /s /a /b "./%1") do (set nupkg=%%a) :: 推送包
nuget push %nupkg% {your api key} -Source https://www.nuget.org/api/v2/package

如上所示,这里需要传入两个参数。

  • %1:包搜索字符串,比如“Magicodes.Sms.*.nupkg”
  • %2:项目方案路径,比如“Magicodes.Sms/Magicodes.Sms.csproj”,注意:如果是.NET Core项目,请填写项目的“project.json”地址,比如“Magicodes.Sms/project.json”。这个问题折腾了一晚上,后面在GitHub里面找到了提示。

设置包属性

通常我们在搜索Nuget包时,可以看到很多描述或介绍,如下图所示:

使用批处理根据项目工程文件生成Nuget包并发布(支持.NET Core)

如果是普通的.NET 库,我们可以在工程的AssemblyInfo.cs文件中设置:

[assembly: AssemblyTitle("Magicodes.WeChat.SDK")]
[assembly: AssemblyDescription("Magicodes.WeChat.SDK为湖南心莱信息科技有限公司基于微信业务封装的工具包,以便更便捷更简单的调用和使用微信接口,以更好地和自己的业务结合。\n官方网址:http://xin-lai.com \n开源库地址:https://github.com/xin-lai \n博客地址:http://www.cnblogs.com/codelove/ \n交流QQ群(Magicodes开源库交流群):346487194 \n小店地址:https://shop113059108.taobao.com/")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("湖南心莱信息科技有限公司")]
[assembly: AssemblyProduct("Magicodes.WeChat.SDK")]
[assembly: AssemblyCopyright("Copyright © 2016")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]

同时,我们还可以设置自动版本号,即编译时自动迭代版本号:

[assembly: AssemblyVersion("1.0.*")]

如果是.NET Core项目,则需要通过project.json来设置:

{
"authors": [ "湖南心莱信息科技有限公司" ],
"dependencies": {
"NETStandard.Library": "1.6.1"
},
"description": "短信核心库,基于.Net Core。\n官方网址:http://xin-lai.com \n开源库地址:https://github.com/xin-lai \n博客地址:http://www.cnblogs.com/codelove/ \n交流QQ群(Magicodes开源库交流群):346487194 \n小店地址:https://shop113059108.taobao.com/",
"frameworks": {
"net461": {
}
},
"title": "Magicodes.Sms.Core",
"version": "1.0.0-*"
}

.NET Core项目暂时不知如何设置自动版本号,如果有知道的朋友望不吝赐教。目前,.NET Core类库通过批处理打包会出现包属性中文乱码的问题。

调用脚本

首先我们得确认目录结构和相关必须文件位置是否正确,如下所示:

使用批处理根据项目工程文件生成Nuget包并发布(支持.NET Core)

接下来,我们需要编写相应项目的打包调用脚本了,这里以“pack.Magicodes.Sms.bat”为例,内容如下:

call ./pack.bat "Magicodes.Sms.*.nupkg" "Magicodes.Sms/Magicodes.Sms.csproj"
@pause

如果是.NET Core项目,比如以“pack.Magicodes.Sms.Core.bat”为例,内容如下:

call ./pack.bat Magicodes.Sms.Core.*.nupkg "Magicodes.Sms.Core/project.json"
@pause

执行情况:

使用批处理根据项目工程文件生成Nuget包并发布(支持.NET Core)

番外:调用第三方API通知

有时候,如果我们的包是推送到自己的服务器,或者我们希望团队中其他人知道我们推送了吊炸天的包包,但是我们又不想直接很Low的在群里@所有人 ,那么我们可以编写PowerShell脚本来处理。下面是调用纷纭(现在收费了,可以考虑发邮件代替)的例子:

Param (
##开发消息
[string]$url = "https://hook.lesschat.com/incoming/b32181af9434465685901eb5d0a39aa2",
[string]$data = "{""text"": ""这是一条来自于Incoming Webhook的消息。\n并且消息还可以换行。""}",
[string]$username = "",
[string]$password = "",
[string]$responseType="string",
[string]$method="POST"
) try
{
write-host $data -ForegroundColor Green -BackgroundColor Black
###写请求数据
$bytesToPost = [text.encoding]::utf8.getBytes($data)
$wc = new-object net.WebClient ###Content-Type设置为application/json
$wc.Headers.Add("Content-Type","application/json") ### 设置请求凭据
if ($username.Length -gt 0 -and $password.Length -gt 0)
{
$wc.Credentials = New-Object System.Net.NetworkCredential($username,$password)
### Set Cookie
$wc.Headers.add("Cookie", $wc.ResponseHeaders["Set-Cookie"])
}
$responseData = $wc.UploadData($url,$method,$bytesToPost)
$responseStr=[text.encoding]::utf8.getString($responseData)
write-host $responseStr -ForegroundColor Green -BackgroundColor Black
}
catch [System.Net.WebException],[System.Exception]
{
Write-Host "出现异常,推送消息失败" -ForegroundColor Red -BackgroundColor Black
}
finally
{
Write-Host "处理完成" -ForegroundColor White -BackgroundColor Yellow
}

调用代码很简单,在包推送完成后,我们可以编写以下脚本:

set title="%nupkg%包已推送,请更新最新包。"
set data="{"""attachment""":{"""text""": """%title%""","""color""": """#FFFF33""","""fallback""":"""%title%"""}}"
cmd /c powershell -ExecutionPolicy RemoteSigned -noprofile -noninteractive -file "./LesschatIncoming.ps1" -data %data%

尾声

至此,整个批处理生成Nuget包并推送的教程就到这里结束了。通过批处理编写,我们只要双击就可以完成项目的编译打包和发布的过程,同时还可以Show一下脚本,何不美哉!