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.

XML

<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:

• El Validador de versión de línea de base valida el proyecto de biblioteca con una versión estable publicada previamente del paquete.
• El Validador en tiempo de ejecución compatible valida que los ensamblados de implementación específicos del entorno de ejecución son compatibles entre sí y con los ensamblados en tiempo de compilación.
• El Validador de marco compatible valida que el código compilado en un marco se puede ejecutar en todos los demás en un paquete de varios destinos.

Suprimir advertencias de compatibilidad

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