Проверка пакета

Средства проверки пакетов позволяют, как разработчик библиотеки, проверить, согласованы ли пакеты и хорошо сформированы. Оно выполняет следующие проверки:

• Проверяет, что в разных версиях нет критических изменений.
• Проверяет, что пакет имеет один и тот же набор общедоступных API для всех различных реализаций, относящихся к среде выполнения.
• Перехватывает все дыры применимости.

Вы можете выполнить проверку пакета как задачу MSBuild, так и с помощью глобального средства Microsoft.DotNet.ApiCompat.Tool. Если приложение не упаковывается, используйте проверку сборки.

Включение задачи MSBuild

Чтобы включить проверку пакетов в проекте .NET, установите для свойства EnablePackageValidation значение true.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
    <EnablePackageValidation>true</EnablePackageValidation>
  </PropertyGroup>

</Project>

EnablePackageValidation выполняет ряд проверок после задачи Pack. Существует несколько дополнительных проверок, которые можно выполнить, установив другие свойства MSBuild. Дополнительные сведения см. в разделе "Свойства проверки пакета".

Типы средств проверки

Существует три разных средства проверки, которые обрабатывают пакет в рамках задачи Pack:

• Средство проверки базовых версий проверяет проект библиотеки на соответствие ранее выпущенной стабильной версии пакета.
• Средство проверки совместимой среды выполнения проверяет, что сборки реализации, связанные со средами выполнения, совместимы друг с другом и со сборками времени компиляции.
• Средство проверки совместимой платформы проверяет, что код, скомпилированный для одной платформы, может выполняться на остальных платформах, для которых предназначен пакет.

Подавление предупреждений о совместимости

Сведения о подавлении предупреждений совместимости см. в разделе "Как отключить".