Partage via


Validation de package

Les outils de validation de package vous permettent, en tant de développeur de bibliothèques, de vérifier que vos packages sont cohérents et correctement formés. Ils effectuent les vérifications suivantes :

  • Ils vérifient qu’il n’y a pas de changements cassants entre les versions.
  • Vérifie que le package a le même ensemble d’API publiques pour toutes les différentes implémentations spécifiques au runtime.
  • Permet de détecter les failles d’applicabilité.

Vous pouvez exécuter la validation de package en tant que tâche MSBuild ou à l’aide de l’outil global Microsoft.DotNet.ApiCompat.Tool. Si votre application ne peut pas être ajoutée dans un package, utilisez plutôt la validation d’assembly.

Activer une tâche MSBuild

Vous activez la validation des packages dans votre projet .NET en définissant la propriété EnablePackageValidation sur true.

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

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

</Project>

EnablePackageValidation exécute une série de vérifications après la tâche Pack. D’autres vérifications peuvent être effectuées en définissant d’autres propriétés MSBuild. Pour obtenir plus d’informations, consultez Propriétés de validation de package.

Types de validateurs

Il existe trois validateurs différents qui vérifient votre package dans le cadre de la tâche Pack :

Supprimer les avertissements de compatibilité

Pour obtenir plus d’informations sur la suppression des avertissements de compatibilité, consultez Procédure de suppression.