Sdílet prostřednictvím

Ověření balíčku

  • Článek

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í všechny otvory 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í zabalitelná, použijte místo toho 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 kompatibilního modulu runtime ověří, zda jsou sestavení implementace specifická pro modul runtime kompatibilní s ostatními a 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čení upozornění kompatibility

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