包验证工具允许你作为库开发人员验证包是否一致且格式良好。 它提供以下检查:
- 验证各个版本之间没有重大更改。
- 验证包是否具有针对所有不同运行时特定实现的相同公共 API 集。
- 捕获任何适用性漏洞。
可以将包验证作为 MSBuild 任务 运行,也可以使用 Microsoft.DotNet.ApiCompat.Tool 全局工具运行。 如果应用无法打包,请改用 程序集验证 。
启用 MSBuild 任务
通过将属性设置为 EnablePackageValidationtrue.NET 项目中启用包验证。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
<EnablePackageValidation>true</EnablePackageValidation>
</PropertyGroup>
</Project>
EnablePackageValidation 在任务后 Pack 运行一系列检查。 可以通过设置其他 MSBuild 属性来运行一些其他检查。 有关详细信息,请参阅 包验证属性。
验证程序类型
有三个不同的验证程序验证包作为任务的一部分 Pack :
- 基线版本验证程序根据以前发布的稳定版本的包验证库项目。
- 兼容的运行时验证程序验证运行时特定的实现程序集是否彼此兼容,以及编译时程序集。
- 兼容的框架验证程序验证是否针对一个框架编译的代码可以针对多目标包中的所有其他框架运行。
禁止显示兼容性警告
有关禁止显示兼容性警告的信息,请参阅 如何禁止显示。