记录使用 Cake 进行构建并制作 nuget 包

时间:2022-11-12 14:47:45

书接上一回(https://www.cnblogs.com/h82258652/p/4898983.html)?[手动狗头]

前段时间折腾了一下,总算是把我自己的图片缓存控件(https://github.com/h82258652/HN.Controls.ImageEx)发布到了 nuget 上,目前已经进入一个比较稳定的版本了,基本没有很严重的 bug 了。其实核心代码早就写完了,后期主要都在折腾持续集成以及自动构建(包含制作 nuget 包)。持续集成使用了 appveyor,园子里也有不少相关的资料,这里我就不说了。

在制作 nuget 包的过程中,我折腾了很久,最开始打算直接用 appveyor 的自动打包功能,但是在打包 UWP 的包时,打包出来的版本号一直都是 1.0.0,而 WPF 的就没这问题(这个已确认是 appveyor 的 bug,然而好久都还没有修复(lll¬ω¬))。另外包里的 dll 的版本号也不好统一控制,我发一次版本需要发 3 个 nuget 包,每个 nuget 包都有一个 dll,手动折腾版本号那不切实际的。

在经过一番调研之后,我终于发现了一个能满足我需求的工具,Cake,也叫 C# Make,是一个专门用来进行 .net 项目构建的工具。官方网站在此:https://cakebuild.net/

接下来就按着教程开始吧。

记录使用 Cake 进行构建并制作 nuget 包

这个是我项目的根目录。接下来我们在此目录运行 Powershell(可以通过左上角的文件 –> 打开 Windows Powershell 来打开)。然后输入以下命令。

Invoke-WebRequest https://cakebuild.net/download/bootstrapper/windows -OutFile build.ps1

然后敲下回车,稍微等待之后,我们的目录下就会出现一个叫 build.ps1 的文件。

记录使用 Cake 进行构建并制作 nuget 包

接下来我们在该目录创建一个叫 build.cake 的空白文件,这个文件主要就是执行构建的逻辑。

然后在宇宙最强的 IDE,Visual Studio 中进行编写脚本吧,在这里,建议各位看官先安装一个插件:

记录使用 Cake 进行构建并制作 nuget 包

安装之后,Visual Studio 就具备对 .cake 脚本的语法高亮能力(可惜还是没法有语法提示功能/(ㄒoㄒ)/~~)。

使用 Visual Studio 打开 build.cake 之后,先编写个 Hello world 热热身:

var target = Argument("target", "Default");

Task("Default")
.Does(() =>
{
Information("Hello World!");
}); RunTarget(target);

然后保存并运行刚才的 build.ps1。(Powershell 里输入 .\build.ps1

如果运气好的话,那么你应该和我一样碰到了这样的情况:

记录使用 Cake 进行构建并制作 nuget 包

这是由于执行 Powershell 脚本是一直比较危险的操作,所以需要更改权限。

输入如下的脚本:

记录使用 Cake 进行构建并制作 nuget 包

或者可以参考微软的官方文档来修改权限:https://docs.microsoft.com/zh-cn/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-6

接着再次执行脚本,应该就可以看见如下信息。

记录使用 Cake 进行构建并制作 nuget 包

我们的 Hello world 终于跑起来了,热身完毕,接下来开始编写构建脚本。

Cake 脚本是由一个个 Task 串联起来的,我们先定义一些变量和一个叫 Build 的 Task,用于执行构建。

var target = Argument("target", "Default");
var configuration = Argument("configuration", "Release");
var verbosity = Argument("verbosity", Verbosity.Minimal); var solution = "./HN.Controls.ImageEx.sln"; Task("Build")
.Does(() =>
{
if(IsRunningOnWindows())
{
// Use MSBuild
MSBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
else
{
// Use XBuild
XBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
}); Task("Default")
.IsDependentOn("Build"); RunTarget(target);

这里定义了一些变量,configuration 定义为 Release,在 Build Task 里用到,设置为使用 Release 模式。verbosity 表示编译时的信息输入,这里设置为 Minimal,以免输出过多的信息。solution 表示解决方案的路径。然后运行:

记录使用 Cake 进行构建并制作 nuget 包

这样一执行就把这个解决方案构建了一遍。

然后我们开始编写打包的 Task,命名为 Package。修改脚本如下:

var target = Argument("target", "Default");
var configuration = Argument("configuration", "Release");
var verbosity = Argument("verbosity", Verbosity.Minimal);
var version = Argument("version", "1.0.0"); var solution = "./HN.Controls.ImageEx.sln"; Task("Build")
.Does(() =>
{
if(IsRunningOnWindows())
{
// Use MSBuild
MSBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
else
{
// Use XBuild
XBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
}); Task("Package")
.IsDependentOn("Build")
.Does(() =>
{
var nuGetPackSettings = new NuGetPackSettings
{
Version = version
}; var nuspecFiles = GetFiles("./src/*/*.nuspec");
NuGetPack(nuspecFiles, nuGetPackSettings);
}); Task("Default")
.IsDependentOn("Package"); RunTarget(target);

在这里我加了一个 version 的变量,在下面打包 nuget 包的时候会用到,统一每个 nuget 包的版本号。GetFiles("./src/*/*.nuspec") 这个则获取了源文件夹下面的项目下的 nuspec 文件(我这里一个 nuspec 对应一个 csproj,就放到同一个文件夹下了),这个文件的作用是用于描述 nuget 包如何进行打包,具体可以参考本文开头指向的上一篇文章。

执行之后,我们会得到些 nuget 包(当然对于看官你们的项目需要有 nuspec 才行啦):

记录使用 Cake 进行构建并制作 nuget 包

编译、打包都说完了。最后就是版本号的问题。nuget 包的版本在上面已经解决了,现在就是 dll 的版本号比较棘手。在我这三个项目中,WPF 和 UWP 都是传统的项目,都是有一个 AssemblyInfo.cs 的文件,然后里面通过 AssemblyVersionAttribute 来设置 dll 的版本号的。但是我这个 Core 的项目是新类型的项目,并没有 AssemblyInfo.cs 文件,版本号是在 csproj 里设置的。这难道没办法了么,最后通过万能的 Google 和 *,我还是找到了办法。编辑 csproj 文件,并添加下面一节。

记录使用 Cake 进行构建并制作 nuget 包

这样,这个项目的版本号等信息就不会从 csproj 里面读取。我们可以添加自己的 AssemblyInfo.cs 文件进行版本号管理。

现在情况就是每个项目都有自己的 AssemblyInfo.cs 了,如何统一使用一个 AssemblyInfo.cs 文件来管理这几个项目呢?还记得 Visual Studio 有一个添加引用文件的功能么?

记录使用 Cake 进行构建并制作 nuget 包

这样几个项目都通过这种方式引用同一个 AssemblyInfo.cs 文件就行了。

最后的问题就是如何将 AssemblyInfo.cs 里的版本号跟 build.cake 脚本里的版本号保持一致。在查阅 Cake 的官方文档后,我发现有一个能生成 AssemblyInfo 的功能。修改我们的 build.cake 脚本:

var target = Argument("target", "Default");
var configuration = Argument("configuration", "Release");
var verbosity = Argument("verbosity", Verbosity.Minimal);
var version = Argument("version", "1.0.0"); var solution = "./HN.Controls.ImageEx.sln"; Task("Version")
.Does(() =>
{
var file = "./src/SolutionInfo.cs";
CreateAssemblyInfo(file, new AssemblyInfoSettings
{
Version = version,
FileVersion = version,
InformationalVersion = version
});
}); Task("Build")
.IsDependentOn("Version")
.Does(() =>
{
if(IsRunningOnWindows())
{
// Use MSBuild
MSBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
else
{
// Use XBuild
XBuild(solution, configurator =>
configurator.SetConfiguration(configuration)
.SetVerbosity(verbosity));
}
}); Task("Package")
.IsDependentOn("Build")
.Does(() =>
{
var nuGetPackSettings = new NuGetPackSettings
{
Version = version
}; var nuspecFiles = GetFiles("./src/*/*.nuspec");
NuGetPack(nuspecFiles, nuGetPackSettings);
}); Task("Default")
.IsDependentOn("Package"); RunTarget(target);

在 Version Task 中,会生成一个 SolutionInfo.cs 的文件,也就相当于前面的 AssemblyInfo.cs。那现在所有的项目都引用这个文件来进行统一的版本管理就行了。

这样就已经实现了统一版本、构建、打包的一件脚本化了。后续还可以添加上构建完之后执行单元测试以及打包后自动发布到 nuget 的功能,但我自己比较习惯打包完之后本地也测试一下(毕竟 nuget 发了就不能删),所以就暂时不折腾这功能了。

博主图片缓存控件项目的 build.cake 脚本可以参考这里:https://github.com/h82258652/HN.Controls.ImageEx/blob/master/build.cake,虽然配置好了 xunit,但是没有写单元测试就是了,ε=ε=ε=┏(゜ロ゜;)┛

这篇博文主要记录操作步骤,方便以后自己(我还有个微博的库的坑想要填……)。但也希望看完这篇博文的各位,制作一个 nuget 包并不是一件难事,马上行动把珍藏都弄一份 nuget 包,让各位 .net 开发者也机会用上吧。