Convalida del pacchetto

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

• Verifica che non siano presenti modifiche di rilievo tra le versioni.
• Verifica che il pacchetto abbia lo stesso set di API pubbliche per tutte le diverse 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, usa invece la convalida dell'assembly .

Abilitare l'attività MSBuild

Per abilitare la convalida dei pacchetti nel progetto .NET, impostare la EnablePackageValidation proprietà 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 baseline 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 convalida 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 informazioni sull'eliminazione degli avvisi di compatibilità, vedere Come eliminare.

Vedere anche

• Proprietà di convalida dei pacchetti