Validación del paquete

Las herramientas de validación de paquetes le permiten, como desarrollador de bibliotecas, validar que sus paquetes son coherentes y están bien formados. Proporciona las comprobaciones siguientes:

  • Valida que no haya cambios importantes en las versiones.
  • Valida que el paquete tenga el mismo conjunto de API públicas para todas las implementaciones específicas del entorno de ejecución diferentes.
  • Captura cualquier marcador de aplicabilidad.

Puede ejecutar la validación de paquetes como una tarea de MSBuild o mediante la herramienta global Microsoft.DotNet.ApiCompat.Tool. Si la aplicación no es empaquetable, use la validación de ensamblados en su lugar.

Habilitación de la tarea de MSBuild

Puede habilitar la validación de paquetes en el proyecto de .NET estableciendo la propiedad EnablePackageValidation en true.

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

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

</Project>

EnablePackageValidation ejecuta una serie de comprobaciones después de la tarea Pack. Hay algunas comprobaciones adicionales que se pueden ejecutar estableciendo otras propiedades de MSBuild. Para obtener más información, consulte Propiedades de validación de paquetes.

Tipos de validador

Hay tres validadores diferentes que comprueban el paquete como parte de la tarea Pack:

Suprimir advertencias de compatibilidad

Para obtener información sobre cómo suprimir advertencias de compatibilidad, consulte Cómo suprimir.