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 :

• Le validateur de version de base de référence valide votre projet de bibliothèque par rapport à une version précédemment stable et publiée de votre package.
• Le validateur de runtime compatible vérifie que vos assemblys d’une implémentation spécifiques au runtime sont compatibles entre eux et avec les assemblys au moment de la compilation.
• Le validateur de framework infrastructure compatible vérifier que le code compilé sur un framework peut s’exécuter sur tous les autres dans un package multicible.

Supprimer les avertissements de compatibilité

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