Validation du package

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

• Vérifie qu’il n’existe aucune modification cassant entre les versions.
• Vérifie que le package a le même ensemble d’API publiques pour toutes les implémentations spécifiques au runtime.
• Intercepte les trous d’applicabilité.

Vous pouvez exécuter la validation du package en tant que tâche MSBuild ou à l’aide de l’outil global Microsoft.DotNet.ApiCompat.Tool. Si votre application n’est pas packable, utilisez plutôt la validation d’assembly .

Activer la tâche MSBuild

Vous activez la validation de package dans votre projet .NET en définissant la EnablePackageValidation propriété 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 Pack tâche. Il existe des vérifications supplémentaires qui peuvent être exécutées en définissant d’autres propriétés MSBuild. Pour 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 Pack tâche :

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

Supprimer les avertissements de compatibilité

Pour plus d’informations sur la suppression des avertissements de compatibilité, consultez Comment supprimer.

Voir aussi

• Propriétés de validation de package