desktop8:Extension (v balíčku nebo rozšířeních)

Deklaruje bod rozšiřitelnosti aplikace.

Hierarchie elementů

> balíčku<

     > rozšíření<

          <desktop8:Extension>

Syntax

<desktop8:Extension
  Category = 'A string that can be one of the following values: "windows.mutablePackageDirectories", "windows.userMutablePackageDirectories", or "windows.eventTracing".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child Elements -->
  desktop8:MutablePackageDirectories
  desktop8:UserMutablePackageDirectories
  desktop8:EventTracing

</desktop8:Extension>

Atributy a prvky

Atributy

Atribut	Popis	Datový typ	Požadovaný	Výchozí hodnota
kategorie	Kategorie rozšíření.	Řetězec, který může mít jednu z následujících hodnot: windows.mutablePackageDirectories, windows.userMutablePackageDirectoriesnebo windows.eventTracing.	Ano
spustitelného	Výchozí spustitelný soubor.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který musí končit .exe a nesmí obsahovat tyto znaky: <, >, :, ", |, ?nebo *. Určuje výchozí spustitelný soubor rozšíření. Pokud není zadaný, použije se spustitelný soubor definovaný pro aplikaci. Pokud je zadána, entrypoint vlastnost je také použita. Pokud tato vlastnost EntryPoint není zadaná, použije se položka definovaná pro aplikaci.	Ne
EntryPoint	ID aktivovatelné třídy.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který představuje úkol zpracovávající rozšíření. Obvykle se jedná o plně kvalifikovaný název oboru názvů typu Prostředí Windows Runtime. Pokud není zadaný EntryPoint, použije se místo toho PoložkaPoint definovaný pro aplikaci.	Ne
RuntimeType	Zprostředkovatel modulu runtime. Tento atribut se obvykle používá v případě, že v aplikaci existují smíšené architektury.	Volitelný řetězec s hodnotou od 1 do 255 znaků, který nemůže začínat nebo končit tečkou nebo obsahovat tyto znaky: <, >, :, ", /, \, |, ?nebo *.	Ne
startpage	Webová stránka, která zpracovává bod rozšiřitelnosti.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který nesmí obsahovat tyto znaky: <, >, :, ", |, ?nebo *.	Ne
uap10:TrustLevel	Určuje úroveň důvěryhodnosti rozšíření.	Volitelný řetězec, který může mít jednu z následujících hodnot: appContainer nebo středníil .	Ne
uap10:RuntimeBehavior	Určuje chování běhu rozšíření.	Volitelný řetězec, který může mít jednu z následujících hodnot: windowsApp, packagedClassicAppnebo win32App.	Ne
uap10:HostId	Určuje ID modulu runtime hostitele pro rozšíření.	Alfanumerický řetězec s hodnotou od 1 do 255 znaků. Musí začínat písmenem.	Ne
uap10:Parameters	Obsahuje parametry příkazového řádku pro předání rozšíření. Podporuje se jenom u desktopových aplikací, které mají identitu balíčku.	Volitelný řetězec s hodnotou od 1 do 32767 znaků s jiným než prázdným znakem na začátku a konci.	Ne
uap11:Id	Identifikátor rozšíření. ID musí být jedinečné pro všechna rozšíření v balíčku.	Volitelný řetězec s hodnotou od 1 do 255 znaků s jiným než prázdným znakem na začátku a konci.	Ne
uap11:Subsystem	Subsystém cílený rozšířením.	Volitelný řetězec, který může mít jednu z následujících hodnot: konzoly nebo windows.	Ne
uap11:SupportsMultipleInstances	Určuje, jestli se instance mají spouštět v různých procesech. Výchozí hodnota je false.	Volitelná logická hodnota.	Ne
uap11:ResourceGroup	Značka, kterou můžete použít k seskupení aktivací rozšíření pro účely správy prostředků (například procesoru a paměti). Hodnota, kterou můžete nastavit ResourceGroup, je volná a flexibilní. Viz Application@ResourceGroup.	Volitelný alfanumerický řetězec s hodnotou od 1 do 255 znaků. Musí začínat písmenem.	Ne
uap11:CurrentDirectoryPath	Určuje počáteční adresář při spuštění procesu aplikace. Tento atribut podporuje makra. Další informace najdete v tématu Makra ve schématu manifestu balíčku.	Volitelný řetězec, který nesmí obsahovat tyto znaky: <, >, |, ?nebo *. >	Ne
uap11:Parameters	Subsystém cílený rozšířením. Tento atribut podporuje makra. Další informace najdete v tématu Makra ve schématu manifestu balíčku.	Volitelný řetězec s hodnotou od 1 do 32767 znaků s jiným než prázdným znakem na začátku a konci.	Ne
desktop7:CompatMode	Určuje, jestli se informace o tomto rozšíření registrují v systému Windows klasickými způsoby (např. rozbalené aplikace registrují typy pomocí modelu COM prostřednictvím registru) nebo v nových vymezených způsobech. Výchozí hodnota je "moderní". CompatMode="classic" vyžaduje schopnost Microsoft.classicAppCompat_8wekyb3d8bbwe.	Volitelný řetězec může mít jednu z následujících hodnot: klasické nebo moderní.	Ne
desktop7:Rozsah	Určuje, jestli jsou registrace viditelné jenom pro jiné aplikace spuštěné jako uživatel, který má tento balíček zaregistrovaný (uživatel), nebo jestli jsou viditelné všem uživatelům a službám na počítači (počítači). Výchozí hodnota je "user". Scope="machine" vyžaduje Microsoft.classicAppCompatElevated_8wekyb3d8bbwe schopnost.	Volitelný řetězec, který může mít jednu z následujících hodnot: počítač nebo uživatele.	Ne

Podřízené prvky

Podřízený prvek	Popis
desktop8:MutablePackageDirectories	Umožňuje desktopové aplikaci určit jednu nebo více složek, ve kterých můžete upravit instalační soubory pro vaši aplikaci.
desktop8:UserMutablePackageDirectories	Umožňuje desktopové aplikaci určit jednu nebo více složek, ve kterých můžou uživatelé upravovat instalační soubory pro vaši aplikaci (například pro instalaci mod).
desktop8:EventTracing	Umožňuje desktopové aplikaci protokolovat události definované aplikací v reálném čase nebo ukládat do souboru protokolu.

Nadřazené prvky

Nadřazený prvek	Popis
rozšíření (v balíčku nebo aplikaci)	Definuje jeden nebo více bodů rozšiřitelnosti pro aplikaci.

Požadavky

Položka	Hodnota
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/8
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
minimální verze operačního systému	Windows 11 verze 21H2 (build 22000)