Валидация пакета

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

• Проверяет отсутствие разрушительных изменений между версиями.
• Проверяет, что пакет имеет один и тот же набор общедоступных 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 задания.

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

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

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

См. также

• Свойства проверки пакета