Ověření balíčku

Nástroje pro ověřování balíčků umožňují jako vývojář knihovny ověřit, že jsou vaše balíčky konzistentní a dobře vytvořené. Poskytuje následující kontroly:

• Ověřuje, že ve verzích nedošlo k žádným zásadním změnám.
• Ověří, že balíček má stejnou sadu veřejných rozhraní API pro všechny různé implementace specifické pro modul runtime.
• Zachytí jakékoli nedostatky v použitelnosti.

Ověření balíčku můžete spustit buď jako úlohu MSBuild , nebo pomocí globálního nástroje Microsoft.DotNet.ApiCompat.Tool. Pokud vaše aplikace není balitelná, raději použijte ověření sestavení.

Povolení úlohy MSBuild

V projektu .NET povolíte ověření balíčku nastavením EnablePackageValidation vlastnosti na truehodnotu .

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

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

</Project>

EnablePackageValidation spustí po úkolu řadu kontrol Pack . Existuje několik dalších kontrol, které lze spustit nastavením dalších vlastností nástroje MSBuild. Další informace naleznete v tématu Vlastnosti ověření balíčku.

Typy validátoru

V rámci Pack úlohy existují tři různé validátory, které ověřují váš balíček:

• Validátor základní verze ověří projekt knihovny oproti dříve vydané stabilní verzi balíčku.
• Validátor kompatibility runtime ověří, zda jsou sestavení implementace specifické pro runtime kompatibilní navzájem a se sestaveními v době kompilace.
• Validátor kompatibilní architektury ověří, že kód zkompilovaný v jedné rámci může běžet proti všem ostatním v balíčku s cílením na více platforem.

Potlačte upozornění kompatibility

Informace o potlačení upozornění kompatibility naleznete v tématu Jak potlačit.

Viz také

• Vlastnosti ověření balíčku