基于 Github 平台的 .NET 开源项目模板 – 发布与归档相关

CHANGELOG.md

案例


## [1.0.1.2] - 2023-03-10 
###  myproject2 _ 1.0.1:
- 初步版本 简单实现 还未优化
- fix warning 

## [1.0.2] - 2023-03-10 
 
###  mynuget _ v4.0.0.0:
- 初步版本 简单实现 还未优化
###  xxx.xxx _ v1.2.0:
- 初步版本 简单实现 还未优化
- fix warning 
###  myproject1 _ v3.2.0-beta.2:
- 初步版本 简单实现 还未优化
- fix warning 
###  myproject2 _ 1.0.0:
- 初步版本 简单实现 还未优化
- fix warning

解析

1.0.1.2 / 1.0.2 这两个是主要发版版本, 也就是您 github 页面呈现的 release 版本号.
myproject2 _ 1.0.1 / mynuget _ v4.0.0.0 / myproject2 _ 1.0.0 这些是工程发布版本号, 也就是您要推送到 nuget 上的包名以及版本号.
myproject2/mynuget 等包名必须在工程文件csproj 中指明,即 <PackageId>mynuget</PackageId>.
{package_name} _ v4.0.0.0 / v1.2.0 / v3.2.0-beta.2 这些版本号若带后缀,必须符合 nuget 发版规范, 比如 alpha/beta 等写法.

注意工程必须开启打包功能: <IsPackable>true</IsPackable>

原理

版本号不需要在工程文件中填写,因为模板是以 CHANGELOG.md 的节点版本为主.
比如:在以上案例中, mynuget 即将发布的版本是 v4.0.0.0 , 它将在 CI 环境中被打包成 v4.0.0.0 版本,并推送到 nuget 服务器上.

注意事项

您的 CHANGELOG.md 节点名称必须与您工程文件中打包名匹配, 否则单元测试将不会推送这个包,实际上它也找不到这个包.
可重复推送, 管道功能会检测包版本, 在没有高版本时它将不会推送到服务器.
如果您发布的 CHANGELOG.md 中, 有多个包,但只有一个包能成功推送, 那么管道也会标识成功.

注意 CHAMGELOG.md 改完之后推送到主分支上. 如果需要更改触发条件, 配置文件在.github\workflows\release.yml

发布功能:

1. 发布 github release 信息

管道将根据 CHANGELOG.md 文件的节点版本记录自动发布 release 信息. 请将之前的版本放在注释里或者归档到其他地方,否则发新版时将会携带旧版本的信息.
重复触发管道不会有异常和例外情况,允许重复触发,每次重复触发都将会更新 release.

2. 推送 nuget

管道将根据 CHANGELOG.md 文件最后一个节点, 自动发布 nuget 包(含符号).
重复触发管道不会有异常和例外情况, 允许重复触发.

3. 归档计划

将当前的 {项目名}_VNext 计划归档到具体版本计划, 然后创建一个新的 {项目名}_VNext 计划.
重复触发管道不会有异常和例外情况, 当已存在归档计划时,管道将不会继续运行.

注意,多次触发并不会产生并发问题, 该管道功能中, 3个功能为并发执行, 但多管道运行需要排队.

4. 覆盖率文件上传

覆盖率文件属于同时运行的另一个管道,它将根据 project.yml 节点配置生成覆盖率配置文件.
同为 test 节点, 与单元测试不同, 配置覆盖率上传的选项为: trigger_codecov, 设置为 true 即可.
如果您的覆盖率文件生成需要特定的.NET环境, 您可以在 .github\NMS_TEMPLATE\codecov.yml.template 中进行配置.