Možnosti oříznutí

Vlastnosti a položky nástroje MSBuild popsané v tomto článku ovlivňují chování oříznutých, samostatných nasazení. Některé z možností zmínky ILLink, což je název základního nástroje, který implementuje oříznutí. Další informace o základním nástroji najdete v dokumentaci k trimmeru.

V .NET Core 3.0 jsme zavedli oříznutí PublishTrimmed . Ostatní možnosti jsou k dispozici v .NET 5 a novějších verzích.

Povolení oříznutí

• <PublishTrimmed>true</PublishTrimmed>

  Povolte oříznutí během publikování. Toto nastavení také vypne nekompatibilní funkce oříznutí a povolí analýzu oříznutí během sestavování. V aplikacích .NET 8 a novějších umožňuje toto nastavení také generátory zdrojů pro konfiguraci a delegování požadavků.

Toto nastavení umístěte do souboru projektu, abyste zajistili, že se toto nastavení použije nejen během dotnet builddotnet publish.

Toto nastavení také umožňuje analyzátor Roslyn kompatibilní s oříznutím a zakáže funkce nekompatibilní s oříznutím.

Oříznutí členitosti

<TrimMode>full</TrimMode>

<TrimMode>partial</TrimMode>

<ItemGroup>
  <TrimmableAssembly Include="MyAssembly" />
</ItemGroup>

[AssemblyMetadata("IsTrimmable", "True")]

<Target Name="ConfigureTrimming"
        BeforeTargets="PrepareForILLink">
  <ItemGroup>
    <ManagedAssemblyToLink Condition="'%(Filename)' == 'MyAssembly'">
      <IsTrimmable>true</IsTrimmable>
    </ManagedAssemblyToLink>
  </ItemGroup>
</Target>

Kořenová sestavení

Pokud se sestavení neořízne, považuje se za "rooted", což znamená, že se zachová a všechny jeho staticky pochopené závislosti. Další sestavení mohou být "rooted" podle názvu (bez .dll rozšíření):

<ItemGroup>
  <TrimmerRootAssembly Include="MyAssembly" />
</ItemGroup>

Kořenové popisovače

Dalším způsobem, jak určit kořeny pro analýzu, je použití souboru XML, který používá formát popisovače popisovače. Díky tomu můžete kořenit konkrétní členy místo celého sestavení.

<ItemGroup>
  <TrimmerRootDescriptor Include="MyRoots.xml" />
</ItemGroup>

Může například MyRoots.xml za rootovat konkrétní metodu, která je dynamicky přístupná aplikací:

<linker>
  <assembly fullname="MyAssembly">
    <type fullname="MyAssembly.MyClass">
      <method name="DynamicallyAccessedMethod" />
    </type>
  </assembly>
</linker>

Upozornění analýzy

• <SuppressTrimAnalysisWarnings>false</SuppressTrimAnalysisWarnings>

  Povolte upozornění analýzy oříznutí.

Oříznutí odebere IL, které není staticky dostupné. Aplikace, které používají reflexi nebo jiné vzory, které vytvářejí dynamické závislosti, můžou být přerušeny oříznutím. Chcete-li upozornit na takové vzory, nastavte <SuppressTrimAnalysisWarnings> na falsehodnotu . Toto nastavení zobrazí upozornění na celou aplikaci, včetně vlastního kódu, kódu knihovny a kódu architektury.

Analyzátor Roslyn

Nastavení PublishTrimmed v .NET 6+ také umožňuje analyzátor Roslyn, který zobrazuje omezenou sadu upozornění analýzy. Analyzátor můžete také povolit nebo zakázat nezávisle na PublishTrimmed.

• <EnableTrimAnalyzer>true</EnableTrimAnalyzer>

  Povolení analyzátoru Roslyn pro podmnožinu upozornění analýzy oříznutí

Potlačení upozornění

Můžete potlačit jednotlivé kódy upozornění pomocí obvyklých vlastností nástroje MSBuild respektovaných sadou nástrojů, včetně NoWarn, WarningsAsErrors, WarningsNotAsErrorsa TreatWarningsAsErrors. Existuje další možnost, která nezávisle řídí chování upozornění ILLink jako chyby:

• <ILLinkTreatWarningsAsErrors>false</ILLinkTreatWarningsAsErrors>

  Nezacházejte s upozorněními ILLink jako s chybami. To může být užitečné, abyste se vyhnuli globálnímu zpracování upozornění analýzy oříznutí na chyby při zacházení s upozorněními kompilátoru jako s chybami.

Zobrazit podrobná upozornění

V rozhraní .NET 6+ vytvoří analýza oříznutí maximálně jedno upozornění pro každé sestavení, které pochází z PackageReference, označující, že vnitřní hodnoty sestavení nejsou kompatibilní s oříznutím. Můžete také zobrazit jednotlivá upozornění pro všechna sestavení:

• <TrimmerSingleWarn>false</TrimmerSingleWarn>

  Zobrazí všechna podrobná upozornění místo jejich sbalení do jednoho upozornění na každé sestavení.

Odebrání symbolů

Symboly se obvykle oříznou tak, aby odpovídaly oříznutým sestavením. Můžete také odebrat všechny symboly:

• <TrimmerRemoveSymbols>true</TrimmerRemoveSymbols>

  Odeberte symboly z oříznuté aplikace, včetně vložených souborů PDB a samostatných souborů PDB. To platí pro kód aplikace i všechny závislosti, které jsou součástí symbolů.

Sada SDK také umožňuje zakázat podporu ladicího programu pomocí vlastnosti DebuggerSupport. Pokud je podpora ladicího programu zakázaná, oříznutí automaticky odebere symboly (TrimmerRemoveSymbols výchozí hodnota je true).

Střih funkcí knihovny architektury

Několik oblastí funkcí knihoven architektury obsahuje direktivy trimmeru, které umožňují odebrat kód pro zakázané funkce.

Tyto vlastnosti způsobují oříznutí souvisejícího kódu a také zakázání funkcí prostřednictvím souboru runtimeconfig . Další informace o těchto vlastnostech, včetně odpovídajících možností modulu runtimeconfig , naleznete v tématu přepínače funkcí. Některé sady SDK můžou mít výchozí hodnoty pro tyto vlastnosti.

Funkce rozhraní zakázané při oříznutí

Následující funkce nejsou kompatibilní s oříznutím, protože vyžadují kód, na který se staticky neodkazuje. Tyto funkce jsou ve výchozím nastavení zakázané v oříznutých aplikacích.

• <BuiltInComInteropSupport>

  Integrovaná podpora modelu COM je zakázaná.

• <CustomResourceTypesSupport>

  Použití vlastních typů prostředků se nepodporuje. Cesty kódu ResourceManager, které používají reflexi pro vlastní typy prostředků, jsou oříznuté.

• <EnableCppCLIHostActivation>

  Aktivace hostitele C++/CLI je zakázaná.

• <EnableUnsafeBinaryFormatterInDesigntimeLicenseContextSerialization>

  DesigntimeLicenseContextSerializerBinaryFormatter použití serializace je zakázáno.

• <StartupHookSupport>

  Spuštění kódu před Main spuštěním DOTNET_STARTUP_HOOKS není podporováno. Další informace najdete v tématu háček pro spuštění hostitele.