uap:Extension (Windows 10)
Declareert een uitbreidbaarheidspunt voor de app.
Elementhiërarchie
<uap:Extension>
Syntaxis
<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>
Sleutel
? optioneel (nul of één)
Kenmerken en elementen
Kenmerken
| Attribuut | Beschrijving | Gegevenstype | Vereist | Standaardwaarde |
|---|---|---|---|---|
| categorie | Het type uitbreidbaarheidspunt van het pakket. | Een tekenreeks met een van de volgende waarden: 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.personalAssistantLaunchof windows.voipCall. | Ja | |
| EntryPoint- | De activeringsbare klasse-id. | Een tekenreeks met een waarde tussen 1 en 256 tekens. Vertegenwoordigt de taak die de extensie verwerkt (normaal gesproken de volledig naamruimte-gekwalificeerde naam van een Windows Runtime-type). Als EntryPoint niet is opgegeven, wordt in plaats daarvan het EntryPoint gebruikt dat voor de app is gedefinieerd. | Nee | |
| uitvoerbare | Het standaard uitvoerbare bestand starten. | Een tekenreeks met een waarde tussen 1 en 256 tekens lang, die moet eindigen op .exeen niet deze tekens mag bevatten: <, >, :, ", |, ?of *. Hiermee geeft u het standaard uitvoerbare bestand voor de extensie. Als dit niet is opgegeven, wordt het uitvoerbare bestand gebruikt dat voor de app is gedefinieerd. Indien opgegeven, wordt ook de eigenschap EntryPoint gebruikt. Als deze Eigenschap van EntryPoint niet is opgegeven, wordt het EntryPoint dat voor de app is gedefinieerd, gebruikt. |
Nee | |
| RuntimeType- | De runtime-provider. Wordt meestal gebruikt wanneer er mixed frameworks in een app zijn. | Een tekenreeks met een waarde tussen 1 en 255 tekens die niet kan beginnen of eindigen met een . of die tekens bevat: <, >, :, ", |, |, ?of *. |
Nee | |
| StartPage- | De webpagina die het uitbreidbaarheidspunt verwerkt. | Een tekenreeks met een waarde tussen 1 en 256 tekens die deze tekens niet mogen bevatten: <, >, :, ", |, ?of *. |
Nee | |
| ResourceGroup- | Een optionele tag die wordt gebruikt om uitbreidingsactiveringen te groeperen voor resourcebeheerdoeleinden (bijvoorbeeld CPU en geheugen). Zie de sectie Opmerkingen in Application@ResourceGroup. | Een alfanumerieke tekenreeks tussen 1 en 255 tekens lang. Moet beginnen met een brief. | Nee | |
| uap10:TrustLevel | Hiermee geeft u het vertrouwensniveau van de extensie. | Een optionele tekenreekswaarde. Indien opgegeven, kan dit een van de volgende waarden zijn: appContainer of mediumIL-. | Nee | |
| uap10:RuntimeBehavior | Hiermee geeft u het runtimegedrag van een extensie. | Een optionele tekenreekswaarde. Indien opgegeven, kan dit een van de volgende waarden zijn: windowsApp, packagedClassicAppof win32App. | Nee | |
| uap10:HostId | Hiermee geeft u de id van de hostruntime voor de extensie. | Een alfanumerieke tekenreeks met een optionele waarde tussen 1 en 255 tekens. Moet beginnen met een brief. | Nee | |
| uap10:Parameters | Bevat opdrachtregelparameters die moeten worden doorgegeven aan de extensie. Alleen ondersteund voor bureaublad-apps. | Een tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde. | Nee | |
| uap11:Id | Een id voor de extensie. De id moet uniek zijn voor alle extensies in een pakket. | Een optionele tekenreeks met een waarde tussen 1 en 255 tekens lang met een niet-witruimteteken aan het begin en einde. | Nee | |
| uap11:Subsystem | Dit kenmerk wordt overgenomen van de syntaxis van de basisextensie en is niet van toepassing op de com4-extensie. Behalve syntactische validatie wordt deze waarde genegeerd. | Een optionele tekenreeks met een van de volgende waarden: console of windows. | Nee | |
| uap11:SupportsMultipleInstances | Hiermee geeft u op of exemplaren in verschillende processen moeten worden uitgevoerd. De standaardwaarde is onwaar. | Een optionele Booleaanse waarde. | Nee | |
| uap11:ResourceGroup | Een tag die u kunt gebruiken om activeringen van extensies te groeperen voor resourcebeheerdoeleinden (bijvoorbeeld CPU en geheugen). De waarde die u ResourceGroup kunt instellen, is vrij en flexibel. Zie Application@ResourceGroup. | Een optionele alfanumerieke tekenreeks met een waarde tussen 1 en 255 tekens. Moet beginnen met een brief. | Nee | |
| uap11:CurrentDirectoryPath | Hiermee geeft u de eerste map op wanneer het toepassingsproces wordt gestart. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie. | Een optionele tekenreeks die deze tekens niet mag bevatten: <, >, |, ?of *. > |
Nee | |
| uap11:Parameters | Dit kenmerk wordt overgenomen van de syntaxis van de basisextensie en is niet van toepassing op de com4-extensie. Behalve syntactische validatie wordt deze waarde genegeerd. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie. | Een optionele tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde. | Nee | |
| desktop7:CompatMode | Hiermee geeft u op of de informatie van deze extensie op klassieke manieren is geregistreerd bij Windows (bijvoorbeeld uitgepakte apps registreren typen met COM via het register) of op nieuwe meer bereikde manieren. De standaardwaarde is 'modern'. CompatMode="classic" vereist de mogelijkheid Microsoft.classicAppCompat_8wekyb3d8bbwe. | Een optionele tekenreeks kan een van de volgende waarden hebben: klassieke of moderne. | Nee | |
| desktop7:Bereik | Hiermee geeft u op of de registraties alleen zichtbaar zijn voor andere toepassingen die worden uitgevoerd als een gebruiker die dit pakket heeft geregistreerd (gebruiker), of dat ze zichtbaar zijn voor alle gebruikers en services op de computer (machine). De standaardwaarde is 'gebruiker'. Scope="machine" vereist de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe mogelijkheid. | Een optionele tekenreeks die een van de volgende waarden kan hebben: machine of gebruiker. | Nee |
Onderliggende elementen
| Onderliggend element | Beschrijving |
|---|---|
| uap:AppService- | Declareert een uitbreidbaarheidspunt van het type windows.appService. Application Contracts zijn een manier voor een app om een achtergrondtaak aan te roepen die hoort bij een andere app; of voor een achtergrondtaak die wordt aangeroepen om een app-contract te onderhouden, een manier om te communiceren met de aanroeper. |
| uap:AppointmentsProvider | Declareert een uitbreidbaarheidspunt van het type windows.appointmentsProvider. |
| uap:AutoPlayContent | Declareert een uitbreidbaarheidspunt van het type windows.autoPlayContent. De app biedt de opgegeven acties voor automatisch afspelen. |
| uap:AutoPlayDevice | Declareert een uitbreidbaarheidspunt van een app van het type *windows.autoPlayDevice. De app biedt de opgegeven acties voor automatisch afspelen van apparaten. |
| uap:DialProtocol | Declareert een uitbreidbaarheidspunt van een app van het type windows.dialProtocol*. |
| uap:FileOpenPicker | Declareert een uitbreidbaarheidspunt van een app van het type windows.fileOpenPicker. Met de app kan de gebruiker de opgegeven typen bestanden kiezen en openen. |
| uap:FileSavePicker | Declareert een uitbreidbaarheidspunt van een app van het type windows.fileSavePicker. Met de app kan de gebruiker de bestandsnaam, extensie en opslaglocatie voor de opgegeven typen bestanden kiezen. |
| uap:FileTypeAssociation | Declareert een uitbreidbaarheidspunt van een app van het type windows.fileTypeAssociation. Een bestandstypekoppeling geeft aan dat de app is geregistreerd voor het verwerken van bestanden van de opgegeven typen. |
| uap:MediaPlayback- | Declareert een uitbreidbaarheidspunt van het type mediaPlayback, zodat uw app kan declareren dat videotranscodering wordt uitgevoerd. |
| uap:Protocol | Declareert een uitbreidbaarheidspunt voor apps van het type windows.protocol. Een URI-koppeling geeft aan dat de app is geregistreerd voor het afhandelen van URI's met het opgegeven schema. |
| uap:ShareTarget- | Declareert een app-extensiepunt van het type windows.shareTarget. De app kan de opgegeven typen bestanden delen. |
| uap:VoipCall- | Declareert een uitbreidbaarheidspunt van een app van het type windows.voipCall zodat uw app kan declareren dat deze een upgrade kan uitvoeren van een mobiel gesprek naar een VoIP-videogesprek en/of het een VoIP-app is die ondersteuning biedt voor het rechtstreeks bellen van telefoonnummers. |
| uap:WebAccountProvider | Declareert een uitbreidbaarheidspunt van het type windows.webAccountProvider. |
Bovenliggende elementen
| Bovenliggend element | Beschrijving |
|---|---|
| extensies (type:CT_ApplicationExtensions) | Definieert een of meer uitbreidbaarheidspunten voor de app. |
Opmerkingen
Voor de meeste typen extensies moet Extension@ResourceGroup overeenkomen met Application@ResourceGroup (als Application@ResourceGroup wordt weggelaten, moet Extension@ResourceGroup ook worden weggelaten).
Voor een op gebruikersinterface gebaseerd contract: als Extension@ResourceGroup niet is opgegeven, wordt deze impliciet gegroepeerd met de toepassing; als Extension@ResourceGroup niet overeenkomt met Application@ResourceGroup, mislukt de schemavalidatie van het manifest.
Als Extension@ResourceGroup niet is opgegeven voor een achtergrondtaak of voor een contract dat is gebaseerd op een achtergrondtaak, wordt deze gekoppeld aan een standaardgroep voor alle achtergrondtaken. Taakcontracten op de achtergrond mogen dezelfde waarden opgeven als Application@ResourceGroup.
Voor de volgende extensies kan Extension@ResourceGroup de achtergrondtaak die wordt uitgevoerd, worden gegroepeerd in verschillende processen die onafhankelijk van andere groepen worden beheerd door resources en levenscyclus: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTasken windows.updateTask.
Als het manifest bijvoorbeeld deze drie vermeldingen bevat.
<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>
Vervolgens worden de laatste twee achtergrondtaken geactiveerd in hetzelfde exemplaar van backgroundtaskhost.exe als ze gelijktijdig zijn geactiveerd. Een afzonderlijk exemplaar van backgroundtaskhost.exe wordt echter voor het eerste item uitgesplitste omdat deze een andere ResourceGroup heeft.
Als er geen ResourceGroup is opgegeven voor een extensie, worden alle achtergrondtaken geactiveerd in hetzelfde exemplaar van backgroundtaskhost.exe.
Als een van deze extensies(windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask, of windows.updateTask) geeft u dezelfde waarde op van het kenmerk ResourceGroup van het bovenliggende toepassingselement dat ze worden geactiveerd in hetzelfde proces als de gebruikersinterface.
De volgende extensies vindt u op het tabblad declaraties van de gebruikersinterface van de pakketontwerper: zie de beschrijvingen voor elk van deze elementen:
- Search: registreert de app als zoekprovider. De geïndexeerde inhoud van de app kan worden weergegeven als zoekresultaten in de algemene zoekervaring die wordt gestart via de charm Zoeken. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- CachedFileUpdater: registreert de app als een updater voor bestanden in de cache, zodat de app updates kan uitvoeren voor bestanden die worden geopend door andere Microsoft Store-apps. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- Camera-instellingen: hiermee kan de app aangepaste besturingspanelen bieden voor webcameraapparaten. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- AccountPictureProvider: registreert de app als accountafbeeldingsprovider, zodat deze kan worden gestart in een accountafbeeldingsmodus en de foto van de gebruiker zonder extra aanwijzingen in te stellen. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- PrintTaskSettings: hiermee kan de app de basiservaring voor afdrukinstellingen vervangen. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- LockScreen-: als een telefoon is vergrendeld, is er een beperkte hoeveelheid interactie die de gebruiker kan uitvoeren. In sommige gevallen wil een gebruiker een VoIP-oproep kunnen beantwoorden zonder de telefoon te ontgrendelen. Dit contract maakt dat mogelijk. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- Alarm: Een toepassing kan zichzelf declareren als systeemalarm-app. Wanneer een gebruiker de selectiegebruikersinterface doorloopt om het systeemalarm in te stellen, kunnen alleen toepassingen die als Systeemalarm-apps worden gedeclareerd, worden geselecteerd. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- BackgroundTasks: met achtergrondtaken kunnen toepassingen met elkaar communiceren en één toepassing inschakelen om een andere aan te roepen. Als u contracten wilt gebruiken om deze achtergrondtaken te leveren of te starten, moet een toepassing worden gedeclareerd als app-service. In elke app zijn meerdere exemplaren van deze declaratie toegestaan.
- Print3DWorkFlow: Fabrikanten van 3D-printers kunnen een Universele Windows-app bieden om een unieke ervaring te bieden in het dialoogvenster 3D-afdruk. Als dat niet zo is, biedt Windows een standaard 3D-afdrukervaring. Er is slechts één exemplaar van deze declaratie toegestaan per app.
- PersonalAssistantLaunch: hiermee kan een app worden geïntegreerd met Cortana. Er is slechts één exemplaar van deze declaratie toegestaan per app.
Eisen
| Item | Waarde |
|---|---|
| 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 |
| minimale versie van het besturingssysteem | Windows 10 versie 1511 (build 10586) |