uap:Extension (Windows 10)
Deklariert einen Erweiterungspunkt für die App.
Elementhierarchie
<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>
Schlüssel
? optional (null oder eins)
Attribute und Elemente
Attribute
| Attribut | Beschreibung | Datentyp | Erforderlich | Standardwert |
|---|---|---|---|---|
| Kategorie- | Der Typ des Paketerweiterungspunkts. | Eine Zeichenfolge mit einem der folgenden Werte: 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.personalAssistantLaunchoder windows.voipCall. | Ja | |
| EntryPoint- | Die aktivierbare Klassen-ID. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen länge. Stellt die Aufgabe dar, die die Erweiterung verarbeitet (normalerweise der vollständig namespacequalifizierte Name eines Windows-Runtime-Typs). Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet. | Nein | |
| ausführbare | Die ausführbare Standardstartdatei. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die mit .exeenden muss und diese Zeichen nicht enthalten darf: <, >, :, ", |, ?oder *. Gibt die ausführbare Standarddatei für die Erweiterung an. Wenn nicht angegeben, wird die für die App definierte ausführbare Datei verwendet. Wenn angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben ist, wird der für die App definierte EntryPoint verwendet. |
Nein | |
| RuntimeType- | Der Laufzeitanbieter. Wird in der Regel verwendet, wenn in einer App gemischte Frameworks vorhanden sind. | Eine Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen, die nicht mit einem . beginnen oder enden können oder dort Zeichen enthalten können: <, >, :, ", |, ?oder *. |
Nein | |
| StartPage- | Die Webseite, die den Erweiterungspunkt behandelt. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten können: <, >, :, ", |, ?oder *. |
Nein | |
| ResourceGroup- | Ein optionales Tag zum Gruppieren von Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher). Weitere Informationen finden Sie im Abschnitt Anmerkungen in Application@ResourceGroup. | Eine alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen länge. Muss mit einem Buchstaben beginnen. | Nein | |
| uap10:TrustLevel | Gibt die Vertrauensstufe der Erweiterung an. | Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: appContainer oder mediumIL. | Nein | |
| uap10:RuntimeBehavior | Gibt das Laufzeitverhalten einer Erweiterung an. | Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: windowsApp, packagedClassicAppoder win32App. | Nein | |
| uap10:HostId- | Gibt die ID der Hostlaufzeit für die Erweiterung an. | Eine alphanumerische Zeichenfolge mit einem optionalen Wert zwischen 1 und 255 Zeichen länge. Muss mit einem Buchstaben beginnen. | Nein | |
| uap10:Parameters | Enthält Befehlszeilenparameter, die an die Erweiterung übergeben werden sollen. Wird nur für Desktop-Apps unterstützt. | Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen länge mit einem Nicht-Leerzeichen am Anfang und Ende. | Nein | |
| uap11:Id | Ein Bezeichner für die Erweiterung. Die ID muss für alle Erweiterungen in einem Paket eindeutig sein. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen länge mit einem Nicht-Leerzeichen am Anfang und Ende. | Nein | |
| uap11:Subsystem- | Das Subsystem, das durch die Erweiterung ausgerichtet ist. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Konsolen- oder Windows-. | Nein | |
| uap11:SupportsMultipleInstances | Gibt an, ob Instanzen in verschiedenen Prozessen ausgeführt werden sollen. Der Standardwert ist "false". | Ein optionaler boolescher Wert. | Nein | |
| uap11:ResourceGroup | Ein Tag, mit dem Sie Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher) gruppieren können. Der Wert, den Sie resourceGroup festlegen können, ist formfrei und flexibel. Siehe Application@ResourceGroup. | Eine optionale alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen länge. Muss mit einem Buchstaben beginnen. | Nein | |
| uap11:CurrentDirectoryPath | Gibt das anfangsverzeichnis an, wenn der Anwendungsprozess gestartet wird. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema. | Eine optionale Zeichenfolge, die diese Zeichen nicht enthalten kann: <, >, |, ?oder *. > |
Nein | |
| uap11:Parameters | Das Subsystem, das durch die Erweiterung ausgerichtet ist. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. | Nein | |
| desktop7:CompatMode | Gibt an, ob die Informationen dieser Erweiterung auf klassische Weise bei Windows registriert werden (z. B. entpackte Apps registrieren Typen mit COM über die Registrierung) oder auf neue, bereichsbezogenere Weise. Der Standardwert ist "modern". CompatMode="classic" erfordert die Microsoft.classicAppCompat_8wekyb3d8bbwe-Funktion. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: klassischen oder modernen. | Nein | |
| desktop7:Scope | Gibt an, ob die Registrierungen nur für andere Anwendungen sichtbar sind, die als Benutzer ausgeführt werden, der dieses Paket registriert hat (Benutzer), oder ob sie für alle Benutzer und Dienste auf dem Computer (Computer) sichtbar sind. Der Standardwert ist "user". Scope="machine" erfordert die Microsoft.classicAppCompatElevated_8wekyb3d8bbwe Funktion. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Computer oder Benutzer. | Nein |
Untergeordnete Elemente
| Untergeordnetes Element | Beschreibung |
|---|---|
| uap:AppService- | Deklariert einen App-Erweiterungspunkt vom Typ windows.appService-. Anwendungsverträge sind eine Möglichkeit für eine App, eine Hintergrundaufgabe aufzurufen, die zu einer anderen App gehört; oder für eine Hintergrundaufgabe, die aufgerufen wird, um einen App-Vertrag zu warten, eine Möglichkeit für die Kommunikation mit dem Aufrufer. |
| uap:AppointmentsProvider- | Deklariert einen App-Erweiterungspunkt vom Typ windows.appointmentsProvider. |
| uap:AutoPlayContent | Deklariert einen App-Erweiterungspunkt vom Typ windows.autoPlayContent-. Die App stellt die angegebenen Inhaltsaktionen für die automatische Wiedergabe bereit. |
| uap:AutoPlayDevice | Deklariert einen App-Erweiterungspunkt vom Typ *windows.autoPlayDevice. Die App stellt die angegebenen Geräteaktionen für die automatische Wiedergabe bereit. |
| uap:DialProtocol | Deklariert einen App-Erweiterungspunkt vom Typ windows.dialProtocol*. |
| uap:FileOpenPicker | Deklariert einen App-Erweiterungspunkt vom Typ windows.fileOpenPicker. Mit der App können Benutzer die angegebenen Dateitypen auswählen und öffnen. |
| uap:FileSavePicker | Deklariert einen App-Erweiterungspunkt vom Typ windows.fileSavePicker. Mit der App können Benutzer den Dateinamen, die Erweiterung und den Speicherort für die angegebenen Dateitypen auswählen. |
| uap:FileTypeAssociation | Deklariert einen App-Erweiterungspunkt vom Typ windows.fileTypeAssociation. Eine Dateitypzuordnung gibt an, dass die App für die Verarbeitung von Dateien der angegebenen Typen registriert ist. |
| uap:MediaPlayback- | Deklariert einen App-Erweiterungspunkt vom Typ "mediaPlayback", damit Ihre App deklarieren kann, dass sie die Videotranscodierung durchführt. |
| uap:Protocol- | Deklariert einen App-Erweiterungspunkt vom Typ windows.protocol-. Eine URI-Zuordnung gibt an, dass die App für die Behandlung von URIs mit dem angegebenen Schema registriert ist. |
| uap:ShareTarget- | Deklariert einen App-Erweiterungspunkt vom Typ windows.shareTarget-. Die App kann die angegebenen Dateitypen freigeben. |
| uap:VoipCall | Deklariert einen App-Erweiterungspunkt vom Typ windows.voipCall-, damit Ihre App deklarieren kann, dass sie ein Upgrade von einem Mobilfunkanruf auf einen VoIP-Videoanruf durchführen kann und/oder ob es sich um eine VoIP-App handelt, die das direkte Wählen von Telefonnummern unterstützt. |
| uap:WebAccountProvider- | Deklariert einen App-Erweiterungspunkt vom Typ windows.webAccountProvider. |
Übergeordnete Elemente
| Übergeordnetes Element | Beschreibung |
|---|---|
| Erweiterungen (type:CT_ApplicationExtensions) | Definiert einen oder mehrere Erweiterbarkeitspunkte für die App. |
Bemerkungen
Für die meisten Arten von Erweiterungen muss Extension@ResourceGroup Application@ResourceGroup übereinstimmen (wenn Application@ResourceGroup weggelassen wird, sollte auch Extension@ResourceGroup weggelassen werden).
Für einen benutzeroberflächenbasierten Vertrag: Wenn Extension@ResourceGroup nicht angegeben ist, wird er implizit mit der Anwendung gruppiert; wenn Extension@ResourceGroup nicht mit Application@ResourceGroup übereinstimmt, schlägt die Schemaüberprüfung des Manifests fehl.
Wenn Extension@ResourceGroup für eine Hintergrundaufgabe oder für einen Vertrag, der auf einer Hintergrundaufgabe basiert, nicht angegeben ist, wird sie einer Standardgruppe für alle Hintergrundaufgaben zugeordnet. Hintergrundaufgabenverträge dürfen dieselben Werte wie Application@ResourceGroup angeben.
Für die folgenden Erweiterungen ermöglicht Extension@ResourceGroup, dass die Hintergrundaufgabe, die ausgeführt wird, in verschiedene Prozesse gruppiert werden kann, die unabhängig von anderen Gruppen ressourcen- und lebenszyklusverwaltet werden: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTaskund windows.updateTask.
Wenn das Manifest beispielsweise diese drei Einträge enthält.
<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>
Dann würden die letzten beiden Hintergrundaufgaben in derselben Instanz von backgroundtaskhost.exe aktiviert, wenn sie gleichzeitig aktiviert wurden. Eine separate Instanz von backgroundtaskhost.exe würde jedoch für den ersten Eintrag aufgesprangen werden, da sie über eine andere ResourceGroup verfügt.
Wenn keine ResourceGroup für eine Erweiterung angegeben ist, werden alle Hintergrundaufgaben in derselben Instanz von backgroundtaskhost.exeaktiviert.
Wenn eine dieser Erweiterungen(windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask, oder windows.updateTask) den gleichen Wert des ResourceGroup-Attributs des übergeordneten Application-Elements angibt, das sie im gleichen Prozess wie die Benutzeroberfläche aktiviert werden.
Die folgenden Erweiterungen finden Sie auf der Registerkarte "Deklarationen" der Benutzeroberfläche des Paket-Designers – siehe beschreibungen für jedes dieser Elemente:
- Search: Registriert die App als Suchanbieter. Der indizierte Inhalt der App kann als Suchergebnisse in der globalen Suchumgebung angezeigt werden, die über den Charm "Suchen" gestartet wird. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- CachedFileUpdater: Registriert die App als cached file updater, sodass die App Updates für Dateien, auf die von anderen Microsoft Store-Apps zugegriffen wird, anbieterspezifische Updates zulässt. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- Kameraeinstellungen: Ermöglicht der App, benutzerdefinierte Systemsteuerungen für Webkamerageräte bereitzustellen. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- AccountPictureProvider: Registriert die App als Kontobildanbieter, sodass sie in einem Kontobildmodus gestartet und das Bild des Benutzers ohne zusätzliche Aufforderung festgelegt werden kann. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- PrintTaskSettings: Ermöglicht der App das Ersetzen der grundlegenden Druckeinstellungen. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- LockScreen-: Wenn ein Telefon gesperrt ist, gibt es eine begrenzte Anzahl von Interaktionen, die der Benutzer ausführen kann. In einigen Fällen möchte ein Benutzer einen VoIP-Anruf annehmen können, ohne das Telefon entsperren zu müssen. Dieser Vertrag ermöglicht dies. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- Alarm: Eine Anwendung kann sich als Systemalarm-App deklarieren. Wenn ein Benutzer die Auswahl-UI durchläuft, um seinen Systemalarm festzulegen, können nur Anwendungen ausgewählt werden, die als Systemalarm-Apps deklariert werden. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- BackgroundTasks: Hintergrundaufgaben ermöglichen Es Anwendungen, miteinander zu kommunizieren und eine Anwendung aufzurufen. Um Verträge zum Bereitstellen oder Starten dieser Hintergrundaufgaben zu verwenden, muss eine Anwendung als App-Dienst deklariert werden. In jeder App sind mehrere Instanzen dieser Deklaration zulässig.
- Print3DWorkFlow-: Hersteller von 3D-Druckern können eine universelle Windows-App bereitstellen, um im Dialogfeld "3D-Druck" eine einzigartige Erfahrung zu bieten. Wenn sie dies nicht tun, bietet Windows eine standardmäßige 3D-Druckoberfläche. Pro App ist nur eine Instanz dieser Deklaration zulässig.
- PersonalAssistantLaunch: Ermöglicht einer App die Integration in Cortana. Pro App ist nur eine Instanz dieser Deklaration zulässig.
Anforderungen
| Artikel | Wert |
|---|---|
| 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 |
| Mindestversion des Betriebssystems | Windows 10, Version 1511 (Build 10586) |