Vlastnosti projektu a automatické inicializátory

Toto téma popisuje vlastnosti projektu, které můžete nastavit v souboru projektu sady Visual Studio (například .csproj ) .vcxproja přizpůsobit tak způsob nasazení aplikace, včetně konfigurace automatických inicializátorů.

Automatické inicializátory v sadě Windows App SDK

V sadě Windows App SDK existuje několik rutin, jejichž úlohou je zajistit, aby byl modul Windows App Runtime správně inicializován. Tyto rutiny se označují jako automatické inicializátory, protože se spouští automaticky před vstupním bodem vaší aplikace a provádějí inicializaci za vás.

Návod

V případě, že vás zajímají technické podrobnosti. V jazyce C++ se implementuje automatický inicializátor se statickým konstruktorem třídy. V jazyce C# se implementuje automatický inicializátor s inicializátorem modulu .NET. Někdy tedy uslyšíte inicializátor modulu , který se používá, když je správný termín automatickým inicializátorem.

Všechny automatické inicializátory jsou ve výchozím nastavení podmíněné, a to na základě konfigurace balení a nasazení vaší aplikace. Tady jsou podrobnosti o nich:

Autoicializátor bootstrapperu (označovaný také jako dynamické závislosti) Tento automaticky inicializátor volá rozhraní API bootstrapperu automaticky při spuštění aplikace. Vyžaduje se pro aplikace závislé na architektuře, aby se zajistilo, že se prostředí Windows App Runtime přidá do grafu balíčku aplikace. Informace oaplikacích Informace o rozbalených (a zabalených) aplikacích najdete v tématu Aplikace pro Windows: balení, nasazení a zpracování.
- Pro zabalenou aplikaci nepotřebujete automaticky inicializátor spouštěcího nástroje nebo dynamické závislosti, protože appxmanifest.xml soubor vyjadřuje závislost architektury. A pro samostatnou aplikaci nepotřebujete automatické inicializátory bootstrapperu ani dynamické závislosti, protože tyto aplikace architekturu nepoužívají.
- Můžete se odhlásit z bootstrapperu nebo dynamických závislostí automaticky inicializátor ve vašem .csproj nebo .vcxproj souboru prostřednictvím <WindowsAppSdkBootstrapInitialize>false</WindowsAppSdkBootstrapInitialize>.
Autoicializátor Deployment Manageru To se vyžaduje pro zabalené aplikace závislé na architektuře, které využívají hlavní/singletonové funkce (například nabízená oznámení), protože appxmanifest.xml soubor nemůže tyto závislosti vyjádřit.
- Pro samostatnou aplikaci nepotřebujete automatický inicializátor Deployment Manageru, protože tyto aplikace nepodporují hlavní nebo singletonové funkce.
- Důležitější informace najdete v části Autoicializátor Deployment Manageru dále v tomto tématu.
Automatická inicializátor aktivace bez registrace To se vyžaduje pro samostatnou aplikaci, aby používala aktivaci windows Runtime bez registrace bez registrace založené na manifestu (WinRT) (UndockedRegFreeWinRT), pokud aplikace běží na nižší úrovni na verzi operačního systému starší než Windows 10. května 2019 Update (verze 1903; kód s názvem 19H1).
- Pro aplikace závislé na architektuře a pro samostatné aplikace, které cílí na Windows 10 verze 1903 nebo novější, nepotřebujete automatický inicializátor aktivace bez registrace. Tyto aplikace se mohou odhlásit prostřednictvím <WindowsAppSdkUndockedRegFreeWinRTInitialize>false</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
Automatický inicializátor kompatibility. To se vyžaduje, aby aplikace používala zařízení pro zahrnutí A/B k řízení chování vydávání servisních verzí. Další informace najdete v tématu RuntimeCompatibilityOptions.
- U aplikací, které nepoužívají zahrnutí A/B (což je výchozí nastavení), nepotřebujete automatický inicializátor kompatibility.

Automatický inicializátor Deployment Manageru

Když se spustí aplikace, která používá sadu Windows App SDK 1.8 nebo novější, spustí se automaticky inicializátor Deployment Manageru ve výchozím nastavení. Ale můžete se z toho odhlásit. Tato část vysvětluje výhody a omezení povolení automatického inicializátoru Deployment Manageru a pomůže vám rozhodnout, zda se chcete odhlásit nebo ne.

Aby vaše aplikace využívala funkce v balíčcích Main/Singleton (například nabízená oznámení): 1. Abyste zajistili nasazení těchto balíčků (protože balíčky Main/Singleton nejsou architektury, ale "hlavní" balíčky, jako jsou aplikace, je nutné použít rozhraní API pro nasazení, aby se tyto balíčky neregistrovaly jako závislosti v manifestu appx vaší aplikace. Místo toho rozhraní API pro nasazení poskytuje funkce pro nasazení těchto balíčků). 2. Vzhledem k 1) vaše aplikace musí inicializovat Správce nasazení tím, že zavolá DeploymentManager.Initialize. Vaše aplikace to může udělat buď automaticky, nebo explicitně, jak uvidíme. 3. Vaše aplikace musí být balíčková aplikace závislá na rozhraní, aby byla závislá na balíčcích Main/Singleton.

Jedním ze způsobů inicializace Správce nasazení je umožnit spuštění automatického inicializátoru Deployment Manageru (viz část Automatické inicializátory v sadě Windows App SDK výše v tomto tématu). Autoicializátor Deployment Manageru za vás volá DeploymentManager.Initialize . Dalším způsobem inicializace Správce nasazení je explicitně voláním DeploymentManager.Initialize.

Pokud vaše aplikace (pomocí sady Windows App SDK 1.8 nebo novější) nepotřebuje balíčky Main/Singleton, měli byste se odhlásit z automatického inicializátoru Deployment Manageru nastavením vlastnosti WindowsAppSdkDeploymentManagerInitialize na false v souboru projektu vaší aplikace.

Pokud vaše aplikace (pomocí sady Windows App SDK 1.8 nebo novější) potřebuje balíčky Main/Singleton, můžete:

Povolit automatickému inicializátoru Deployment Manageru spuštění (což dělá ve výchozím nastavení)
nebo se odhlaste z automatického inicializátoru Deployment Manageru nastavením vlastnosti WindowsAppSdkDeploymentManagerInitialize na false v souboru projektu vaší aplikace. Pak byste sami měli explicitně volat DeploymentManager.Initialize.

Důležité

Pro jakýkoli proces spuštěný v AppContainer, pokud způsobíte, že DeploymentManager.Initialize bude volána, pak vaše aplikace musí deklarovat packageManagementomezenou schopnost v manifestu balíčku.