Comprimere convalida

Gli strumenti di convalida dei pacchetti consentono, come sviluppatore di librerie, di verificare che i pacchetti siano coerenti e ben formati. Fornisce i seguenti controlli:

  • Verifica che non siano presenti modifiche sostanziali tra le versioni.
  • Verifica che il pacchetto abbia lo stesso set di API pubbliche per tutte le implementazioni specifiche del runtime.
  • Cattura eventuali fori di applicabilità.

È possibile eseguire la convalida del pacchetto come attività MSBuild o usando lo strumento globale Microsoft.DotNet.ApiCompat.Tool. Se l'app non è comprimibile, usare la convalida dell'assembly.

Abilitare l'attività MSBuild

È possibile abilitare la convalida del pacchetto nel progetto .NET, impostando la proprietà EnablePackageValidation su true.

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

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

</Project>

EnablePackageValidation esegue una serie di controlli dopo l'attività Pack. Esistono alcuni controlli aggiuntivi che possono essere eseguiti impostando altre proprietà di MSBuild. Per altre informazioni, vedere Proprietà di convalida dei pacchetti.

Tipi di validator

Esistono tre diversi validator che verificano il pacchetto come parte dell'attività Pack:

  • Il validator della versione di base convalida il progetto di libreria rispetto a una versione stabile rilasciata in precedenza del pacchetto.
  • Il validator di runtime compatibile verifica che gli assembly di implementazione specifici del runtime siano compatibili tra loro e con gli assembly in fase di compilazione.
  • Il validator framework compatibile verifica che il codice compilato in un framework possa essere eseguito su tutti gli altri in un pacchetto con più destinazioni.

Eliminare gli avvisi di compatibilità

Per ottenere informazioni sull'eliminazione degli avvisi di compatibilità, vedere la sezione Modalità di eliminazione.