uap:Extension (Windows 10)

Deklaruje bod rozšiřitelnosti aplikace.

Hierarchie elementů

< >

     <aplikace>

          <application>

               < >

                    <uap:Extension>

Syntax

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. 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 the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (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 = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional 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 -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Klíč

? volitelné (nula nebo jedna)

Atributy a prvky

Atributy

Atribut	Popis	Datový typ	Požadovaný	Výchozí hodnota
kategorie	Typ bodu rozšiřitelnosti balíčku.	Řetězec, který může mít jednu z následujících hodnot: windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.windows.search fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunchnebo windows.voipCall.	Ano
EntryPoint	ID aktivovatelné třídy.	Řetězec s hodnotou v délce 1 až 256 znaků. Představuje úlohu, která zpracovává rozšíření (obvykle 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
spustitelného	Výchozí spustitelný soubor.	Řetězec s hodnotou od 1 do 256 znaků, který musí končit .exea 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
RuntimeType	Zprostředkovatel modulu runtime. Obvykle se používá v kombinaci architektur v aplikaci.	Řetězec s hodnotou od 1 do 255 znaků, který nemůže začínat nebo končit . nebo obsahovat znaky: <, >, :, ", |, ?nebo *.	Ne
startpage	Webová stránka, která zpracovává bod rozšiřitelnosti.	Řetězec s délkou 1 až 256 znaků, který nesmí obsahovat tyto znaky: <, >, :, ", |, ?nebo *.	Ne
ResourceGroup	Volitelná značka používaná k seskupení aktivací rozšíření pro účely správy prostředků (například procesor a paměť). Viz Poznámky oddíl v Application@ResourceGroup.	Alfanumerický řetězec o délce 1 až 255 znaků. Musí začínat písmenem.	Ne
uap10:TrustLevel	Určuje úroveň důvěryhodnosti rozšíření.	Volitelná řetězcová hodnota. Pokud je zadán, může to být jedna z následujících hodnot: appContainer nebo střední.	Ne
uap10:RuntimeBehavior	Určuje chování modulu runtime rozšíření.	Volitelná řetězcová hodnota. Pokud je zadáno, může to být jedna 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 volitelnou hodnotou v délce 1 až 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 pro desktopové aplikace.	Ř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
uap:AppService	Deklaruje bod rozšiřitelnosti aplikace typu windows.appService. Kontrakty aplikací představují způsob, jak aplikace vyvolat úlohu na pozadí, která patří do jiné aplikace; nebo pro úlohu na pozadí vyvolanou službou kontrakt aplikace způsobem, jak komunikovat s volajícím.
uap:AppointmentsProvider	Deklaruje bod rozšiřitelnosti aplikace typu windows.appointmentsProvider.
uap:AutoPlayContent	Deklaruje bod rozšiřitelnosti aplikace typu windows.autoPlayContent. Aplikace poskytuje zadané akce obsahu automatického přehrávání.
uap:AutoPlayDevice	Deklaruje bod rozšiřitelnosti aplikace typu *windows.autoPlayDevice. Aplikace poskytuje zadané akce zařízení automatického přehrávání.
uap:DialProtocol	Deklaruje bod rozšiřitelnosti aplikace typu windows.dialProtocol*.
uap:FileOpenPicker	Deklaruje bod rozšiřitelnosti aplikace typu windows.fileOpenPicker. Aplikace umožňuje uživateli zvolit a otevřít zadané typy souborů.
uap:FileSavePicker	Deklaruje bod rozšiřitelnosti aplikace typu windows.fileSavePicker. Aplikace umožňuje uživateli zvolit název souboru, příponu a umístění úložiště pro zadané typy souborů.
uap:FileTypeAssociation	Deklaruje bod rozšiřitelnosti aplikace typu windows.fileTypeAssociation. Přidružení typu souboru označuje, že aplikace je zaregistrovaná pro zpracování souborů zadaných typů.
uap:MediaPlayback	Deklaruje bod rozšiřitelnosti aplikace typu mediaPlayback, aby aplikace deklarovala, že provádí překódování videa.
uap:Protocol	Deklaruje bod rozšiřitelnosti aplikace typu windows.protocol. Přidružení identifikátoru URI označuje, že aplikace je zaregistrovaná pro zpracování identifikátorů URI se zadaným schématem.
uap:ShareTarget	Deklaruje bod rozšíření aplikace typu windows.shareTarget. Aplikace může sdílet zadané typy souborů.
uap:VoipCall	Deklaruje bod rozšiřitelnosti aplikace typu windows.voipCall, aby vaše aplikace mohl deklarovat, že může provést upgrade z mobilního volání na videohovor VoIP a/nebo jestli se jedná o aplikaci VoIP, která podporuje vytáčení telefonních čísel přímo.
uap:WebAccountProvider	Deklaruje bod rozšiřitelnosti aplikace typu windows.webAccountProvider.

Nadřazené prvky

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

Poznámky

U většiny typů rozšíření musí Extension@ResourceGroup odpovídat Application@ResourceGroup (pokud Application@ResourceGroup vynecháte, Extension@ResourceGroup by se také nemělo vynechat).

Pro kontrakt založený na uživatelském rozhraní: pokud Extension@ResourceGroup není zadán, bude implicitně seskupený s aplikací; pokud Extension@ResourceGroup neodpovídá Application@ResourceGroup manifest se nezdaří ověření schématu.

Pokud Extension@ResourceGroup není zadán pro úkol na pozadí nebo pro kontrakt založený na úkolu na pozadí, bude přidružen k výchozí skupině pro všechny úlohy na pozadí. Kontrakty úloh na pozadí mohou určovat stejné hodnoty jako Application@ResourceGroup.

U následujících rozšíření Extension@ResourceGroup umožňuje seskupit úlohu na pozadí do různých procesů, které budou spravovány nezávisle na prostředcích a životním cyklu jiných skupin: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTaska windows.updateTask.

Například pokud manifest měl tyto tři položky.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Poslední dvě úlohy na pozadí by se aktivovaly do stejné instance backgroundtaskhost.exe pokud byly aktivovány souběžně. Samostatná instance backgroundtaskhost.exe by se však vytvořila pro první položku, protože má jinou skupinu prostředků.

Pokud není pro rozšíření zadána žádná skupina prostředků, všechny úlohy na pozadí jsou aktivovány do stejné instance backgroundtaskhost.exe.

Kromě toho, pokud jedno z těchto rozšíření(windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTasknebo windows.updateTask) určuje stejnou hodnotu atributu ResourceGroup nadřazeného prvku aplikace, který budou aktivovány ve stejném procesu jako uživatelské rozhraní.

Následující rozšíření najdete na kartě deklarací uživatelského rozhraní návrháře balíčků – viz popisy pro každý z těchto prvků:

• Vyhledávací: Zaregistruje aplikaci jako poskytovatele vyhledávání. Indexovaný obsah aplikace se může zobrazit jako výsledky hledání v prostředí globálního vyhledávání spuštěného pomocí ovládacího tlačítka Hledat. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• CachedFileUpdater: Zaregistruje aplikaci jako aktualizátor souborů uložených v mezipaměti, což aplikaci umožňuje zprostředkovatele aktualizací souborů, ke kterým přistupuje jiné aplikace z Microsoft Storu. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• Nastavení fotoaparátu: Umožňuje aplikaci poskytovat vlastní ovládací panely pro zařízení s webovou kamerou. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• AccountPictureProvider: Zaregistruje aplikaci jako poskytovatele obrázků účtu, což umožňuje jeho spuštění v režimu obrázku účtu a nastavení obrázku uživatele bez dalších výzev. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• PrintTaskSettings: Umožňuje aplikaci nahradit základní nastavení tisku. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• Zamykací obrazovka: Pokud je telefon uzamčený, existuje omezené množství interakce, kterou může uživatel provést. V některých případech chce uživatel přijmout hovor VoIP bez odemknutí telefonu. Tato smlouva to umožňuje. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• alarm: Aplikace může deklarovat jako aplikaci System Alarm. Když uživatel projde uživatelským rozhraním výběru a nastaví systémový alarm, můžou být vybrány pouze aplikace deklarované jako System Alarm Apps. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• BackgroundTasks: Úlohy na pozadí umožňují aplikacím vzájemně komunikovat a umožnit, aby jedna aplikace volala jinou. Aby bylo možné pomocí kontraktů poskytnout nebo spustit tyto úlohy na pozadí, musí být aplikace deklarována jako služba App Service. V každé aplikaci je povoleno více instancí této deklarace.
• Print3DWorkFlow: Výrobci 3D tiskáren mohou poskytnout univerzální aplikaci pro Windows, která poskytuje jedinečné prostředí v dialogovém okně 3D tisku. Pokud ne, systém Windows poskytuje výchozí 3D tisk. Pro každou aplikaci je povolena pouze jedna instance této deklarace.
• PersonalAssistantLaunch: Umožňuje aplikaci integrovat s Cortanou. Pro každou aplikaci je povolena pouze jedna instance této deklarace.

Požadavky

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