自定义Nuget包的技巧一二

  • A+
所属分类:.NET技术
摘要

背景: 在项目中, 通常会拆分成核心库(Core)和应用(App)两个部分。核心库由专人维护, 不同的App是不同的团队,但都引用了核心库。当核心库需要升级更新时,有的应用会更新,有的不会——可能是没必要,可能是应用本身更新、部署限制条件多。因此,会造成多版本并存的情况。

背景:

在项目中, 通常会拆分成核心库(Core)和应用(App)两个部分。核心库由专人维护, 不同的App是不同的团队,但都引用了核心库。当核心库需要升级更新时,有的应用会更新,有的不会——可能是没必要,可能是应用本身更新、部署限制条件多。因此,会造成多版本并存的情况。

使用NuGet来做多版本的管理和分发是一件普遍接收的事情。Visual Studio 可以直接将csproj项目制作成一个NuGet包, 但是只能包含这个项目本身编译的dll;如果当前项目还引用了其他的csproj项目,这些引用并没有能包含在Nuget包中。

因此,下面我将要解决两个问题:

1) 多个项目生成一个Nuget包

2) 自动递增Nuget包的版本问题

 

技巧:

一,将多个csproj项目生成一个nuget包。

我的思路是这样的,为了减少操作上的麻烦, 我建了一个空的项目Z, 然后这个项目引用了所有其他需要打入包中的类库项目A, B, C…, 当Z项目Build的时候, 就会自动编译A, B, C项目,并且将类库生成到bin目录中。

其次, 使用*.nuspec文件,来描述包中的内容。

 

<?xml version="1.0" encoding="utf-8"?>  <package xmlns="http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">    <metadata>      <id>MyPack.Foundation</id>      <version>1.0.11</version>      <authors> MyPack </authors>      <owners> MyPack </owners>      <requireLicenseAcceptance>false</requireLicenseAcceptance>      <description>[RedPI类库] RedPI.Foundation, 微服务开发框架</description>      <dependencies>        <group targetFramework=".NETStandard2.0">          <dependency id="AutoMapper" version="10.0.0" />          <dependency id="Jaeger" version="0.3.7" />        </group>      </dependencies>    </metadata>    <files>      <file src=".netstandard2.0Company.*.dll" target="libnetstandard2.0" />      <file src=".netstandard2.0Company.*.pdb" target="libnetstandard2.0" />      </files>  </package>

 

 

Nuspec文件上面描述了包的版本、作者等信息,下面描述了包的内容。具体格式不在此赘述,感兴趣的看官可以自行查阅官网。在这里我重点说明下dependency和file。

Dependency是说整个nuget包的依赖,也就是包中所有lib库项目的依赖项的合集。这个很好找, 我的做法就是打开每个csproj文件, 把里面的PackageReference内容拿出来,换下格式就好—— 既有依赖的包名称, 也有版本号。

 

  <ItemGroup>      <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />      <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />    </ItemGroup>

 

File是包的内容文件,使用相对路径,支持使用“*”匹配多个文件。建议项目的类库使用相同的名称前缀, 这样一行描述就够用了。 而且未来如果有新的类库加入, 不需要更新此处。

然后就可以使用Nuget.exe命令进行打包了:

 nuget pack %nuspec% -version %VER% -Symbols -OutputDirectory %rootPath% 

其中%nuspec% 就是我们刚才提到的nuspec文件,

%VER% 是包的版本号,这个接下来我们看看怎么做自动递增

%rootPath% 是本地包文件存放的位置。

 

二,自动递增包的版本号

这个有两种做法,一是先查后增, 二是在CI(持续集成)里搭配BuildNumber实现。后者是我们现在项目中的做法,也比较容易实现。接下来我主要介绍下“先查后增”的做法。

一般项目组要发布自己的Nuget包的话, 都会先搭建自己的Nuget服务器。如果使用Azure Devops Server的话,可以使用其中的Artifact作为自建包源;或者使用Nuget.Server包快速搭建一个自己的asp.net的Nuget服务器。然后可以使用nuget.exe list 指令进行版本查询。具体的过程脚本描述如下:

$addr = 'http://[your nuget server address]/nuget'  $pack = 'jquery'  # package name , eg. jquery #$pack = $(pack)  $currentVer = nuget list $pack -source $addr # $currentVer = nuget list packageid:$pack -source nuget.org  # # $currentVer = 'jquery 3.5.1.5' write-host "Current Version:$currentVer"   $matchs=$currentVer| select-string -AllMatches "[w.]+ ([d+.]+)(d)[-pre]?"   # $matchs.Matches[0].Groups[1].Captures[0].Value # $matchs.Matches[0].Groups[2].Captures[0].Value  $p = $matchs.Matches[0].Groups[1].Captures[0].Value $n = 1+ $matchs.Matches[0].Groups[2].Captures[0].Value  $newVer = "$p$n"

 

其中使用了正则匹配来找到版本号的最小段,然后递增即可。

  

补充一点, 在将包发布到服务器上之前,可以先在本地试试效果,也即将nupkg文件复制到local的目录中, 该目录可以作为nuget源进行引用。

 

最后, 使用nuget.exe push 将包发布到服务器上

nuget push $nupkg -ApiKey {pwd} -Source $addr

 

 

总结:

    包的使用在项目团队中很重要, 如果版本管理不好,容易招惹众怒,要考虑的事情还是挺多的。上面主要介绍了两个技巧,一个是将多个项目打成一个包,另一个是自动获取并递增版本号,希望能对各位看官有所帮助。