Možnosti konfigurace modulu runtime pro kompilaci

Tento článek podrobně popisuje nastavení, která můžete použít ke konfiguraci kompilace .NET.

Poznámka:

.NET 6 standardizuje předponu DOTNET_ místo COMPlus_ proměnných prostředí, které konfigurují chování za běhu .NET. Předpona COMPlus_ ale bude i nadále fungovat. Pokud používáte předchozí verzi modulu runtime .NET, měli byste stále používat předponu COMPlus_ pro proměnné prostředí.

Vrstvené kompilace

• Konfiguruje, jestli kompilátor JIT (just-in-time) používá vrstvenou kompilaci. Vrstvené přechody kompilace metody prostřednictvím dvou vrstev:
  • První vrstva generuje kód rychleji (rychlý JIT) nebo načítá předem zkompilovaný kód (ReadyToRun).
  • Druhá úroveň generuje optimalizovaný kód na pozadí ("optimalizace JIT").
• V .NET Core 3.0 a novějších verzích je ve výchozím nastavení povolená vrstvené kompilace.
• V .NET Core 2.1 a 2.2 je ve výchozím nastavení vrstvené kompilace zakázaná.
• Další informace najdete v průvodci vrstvenou kompilací.

	Název nastavení	Hodnoty
runtimeconfig.json	System.Runtime.TieredCompilation	true -Povoleno false -Zakázán
Vlastnost MSBuild	TieredCompilation	true -Povoleno false -Zakázán
Proměnná prostředí	COMPlus_TieredCompilation nebo DOTNET_TieredCompilation	1 -Povoleno 0 -Zakázán

Příklady

runtimeconfig.json soubor:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation": false
      }
   }
}

runtimeconfig.template.json soubor:

{
   "configProperties": {
      "System.Runtime.TieredCompilation": false
   }
}

Soubor projektu:

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

  <PropertyGroup>
    <TieredCompilation>false</TieredCompilation>
  </PropertyGroup>

</Project>

Rychlý JIT

• Konfiguruje, jestli kompilátor JIT používá rychlé JIT. U metod, které neobsahují smyčky a pro které není předkompilovaný kód k dispozici, je rychlý JIT zkompiluje rychleji, ale bez optimalizace.
• Povolení rychlého JIT zkracuje dobu spuštění, ale může vytvořit kód s degradovanými charakteristikami výkonu. Například kód může používat více prostoru zásobníku, přidělit více paměti a běžet pomaleji.
• Pokud je funkce JIT zakázaná, ale je povolená vrstvené kompilace, účastní se vrstvené kompilace pouze předkompilovaný kód. Pokud metoda není předem zkompilována s ReadyToRun, chování JIT je stejné, jako kdyby vrstvené kompilace byla zakázána.
• V .NET Core 3.0 a novějších je ve výchozím nastavení povolený rychlý JIT.
• V .NET Core 2.1 a 2.2 je ve výchozím nastavení rychlý JIT zakázaný.

	Název nastavení	Hodnoty
runtimeconfig.json	System.Runtime.TieredCompilation.QuickJit	true -Povoleno false -Zakázán
Vlastnost MSBuild	TieredCompilationQuickJit	true -Povoleno false -Zakázán
Proměnná prostředí	COMPlus_TC_QuickJit nebo DOTNET_TC_QuickJit	1 -Povoleno 0 -Zakázán

Příklady

runtimeconfig.json soubor:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation.QuickJit": false
      }
   }
}

runtimeconfig.template.json soubor:

{
   "configProperties": {
      "System.Runtime.TieredCompilation.QuickJit": false
   }
}

Soubor projektu:

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

  <PropertyGroup>
    <TieredCompilationQuickJit>false</TieredCompilationQuickJit>
  </PropertyGroup>

</Project>

Rychlé JIT pro smyčky

• Konfiguruje, zda kompilátor JIT používá rychlé JIT u metod obsahujících smyčky.
• Povolení rychlého JIT pro smyčky může zlepšit výkon při spuštění. Dlouho běžící smyčky se ale můžou po dlouhou dobu zaseknout v méně optimalizovaném kódu.
• Pokud je funkce JIT zakázaná, toto nastavení nemá žádný vliv.
• Pokud toto nastavení vynecháte, rychlé JIT se nepoužívá pro metody, které obsahují smyčky. To je ekvivalentní nastavení hodnoty na false.

	Název nastavení	Hodnoty
runtimeconfig.json	System.Runtime.TieredCompilation.QuickJitForLoops	false -Zakázán true -Povoleno
Vlastnost MSBuild	TieredCompilationQuickJitForLoops	false -Zakázán true -Povoleno
Proměnná prostředí	COMPlus_TC_QuickJitForLoops nebo DOTNET_TC_QuickJitForLoops	0 -Zakázán 1 -Povoleno

Příklady

runtimeconfig.json soubor:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation.QuickJitForLoops": false
      }
   }
}

runtimeconfig.template.json soubor:

{
   "configProperties": {
      "System.Runtime.TieredCompilation.QuickJitForLoops": false
   }
}

Soubor projektu:

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

  <PropertyGroup>
    <TieredCompilationQuickJitForLoops>true</TieredCompilationQuickJitForLoops>
  </PropertyGroup>

</Project>

ReadyToRun

• Konfiguruje, jestli modul runtime .NET Core používá předkompilovaný kód pro image s dostupnými daty ReadyToRun. Zakázáním této možnosti se modul runtime vynutí kód architektury JIT-compile.
• Další informace najdete v tématu Připraveno ke spuštění.
• Pokud toto nastavení vynecháte, použije .NET data ReadyToRun, pokud je k dispozici. To je ekvivalentní nastavení hodnoty na 1.

	Název nastavení	Hodnoty
Proměnná prostředí	COMPlus_ReadyToRun nebo DOTNET_ReadyToRun	1 -Povoleno 0 -Zakázán

Optimalizace na základě profilu

Toto nastavení umožňuje dynamickou (vrstvenou) optimalizaci profilu (PGO) v .NET 6 a novějších verzích.

	Název nastavení	Hodnoty
Proměnná prostředí	DOTNET_TieredPGO	1 -Povoleno 0 -Zakázán
Vlastnost MSBuild	TieredPGO	true -Povoleno false -Zakázán

Optimalizace s asistencí profilu (PGO) je místo, kde kompilátor JIT generuje optimalizovaný kód z hlediska typů a cest kódu, které se nejčastěji používají. Dynamické PGO funguje ručně s vrstvenou kompilací pro další optimalizaci kódu na základě další instrumentace, která je zavedená během vrstvy 0.

Příklady

Soubor projektu:

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

  <PropertyGroup>
    <TieredPGO>true</TieredPGO>
  </PropertyGroup>

</Project>