Erweiterung (in Anwendung/Erweiterungen) (Windows 10)
Deklariert einen Erweiterbarkeitspunkt für das Paket.
Elementhierarchie
<Erweiterung>
Syntax
<Extension
Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
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.'
/>
<!-- Child elements -->
BackgroundTasks?
</Extension>
Schlüssel
? optional (null oder 1)
Attribute und Elemente
Attribute
| attribute | BESCHREIBUNG | Datentyp | Erforderlich | Standardwert |
|---|---|---|---|---|
| Kategorie | Der Typ des Paketerweiterbarkeitspunkts. | Kann einer der folgenden Werte sein: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask oder windows.restrictedLaunch. | Yes | |
| EntryPoint | Die aktivierungsfähige Klassen-ID. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge. Stellt die Aufgabe dar, die die Erweiterung behandelt (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. | No | |
| Ausführbare Datei | Die standardmäßige ausführbare Startdatei. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die mit enden .exemuss und nicht die folgenden Zeichen enthalten darf: <, , >, :, ", , |, ?, oder *. Gibt die ausführbare Standarddatei für die Erweiterung an. Falls nicht angegeben, wird die ausführbare Datei verwendet, die für die App definiert ist. Falls angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben wird, wird der für die App definierte EntryPoint verwendet. |
No | |
| 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 Länge, die nicht mit einem . beginnen oder enden kann oder darin Zeichen enthält: <, , :>, , ", |, , ?oder *. |
No | |
| StartPage | Die Webseite, die den Erweiterungspunkt behandelt. | Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die die folgenden Zeichen nicht enthalten kann: <, >, :, ", |, , ?oder *. |
No | |
| ResourceGroup | Ein optionales Tag zum Gruppieren von Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher). Weitere Informationen finden Sie im Abschnitt Hinweise in Application@ResourceGroup. | Eine alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen. | No | |
| 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. | No | |
| uap10:RuntimeBehavior | Gibt das Laufzeitverhalten einer Erweiterung an. Weitere Informationen und Anforderungen finden Sie uap10:RuntimeBehavior im Thema für das Anwendungselement (Windows 10). |
Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: "packagedClassicApp", "win32App" oder "windowsApp". | No | |
| 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. | No | |
| uap10:Parameter | Enthält Befehlszeilenparameter, die an die Erweiterung übergeben werden sollen. Nur für Desktop-Apps unterstützt. | Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende. | No |
Untergeordnete Elemente
| Untergeordnetes Element | Beschreibung |
|---|---|
| BackgroundTasks | Definiert einen App-Erweiterbarkeitspunkt vom Typ windows.backgroundTasks. Hintergrundaufgaben werden in einem dedizierten Hintergrundhost ausgeführt; d. h. ohne Benutzeroberfläche. |
Übergeordnete Elemente
| Übergeordnetes Element | BESCHREIBUNG |
|---|---|
| Erweiterungen (Typ: CT_ApplicationExtensions) | Definiert einen oder mehrere Erweiterbarkeitspunkte für die App. |
Zugehörige Elemente
Die folgenden Elemente haben denselben Namen wie dieses Element, aber ihr Inhalt oder ihre Attribute sind anders.
Hinweise
Wenn Aktivierungsinformationsattribute nicht für die Erweiterung angegeben werden, werden sie von der übergeordneten Anwendung geerbt. Weitere Informationen finden Sie im Abschnitt "Hinweise" für das Application-Element .
Erweiterbarkeitspunkte sind ein Mechanismus, mit dem ein Paket Funktionen in einer vom Betriebssystem definierten Weise hinzufügen kann. Ein Erweiterbarkeitspunkt ist ein Speicherort, an dem sich eine App registrieren kann, um Code auszuführen oder Ressourcen des aktuellen Pakets zu verwenden. Um Funktionen für eine bestimmte App hinzuzufügen, verwenden Sie das untergeordnete Application-Element des Applications-Elements .
Der Windows.certificates-Erweiterbarkeitspunkt kann nicht mehrmals in einem Manifest deklariert werden.
Hinweis
Entweder das EntryPoint- oder StartPage-Attribut ist erforderlich, wenn das Category-Attribut oder windows.preInstalledConfigTask für Versionen von Windows 10 vor Windows 10, Version 1607, ist windows.UpdateTask erforderlich. Ab Windows 10, Version 1607, müssen Sie keinen Wert mehr für EntryPoint oder StartPage angeben, wenn Kategoriewindows.Useist , UpdateTask, oder windows.preInstalledConfigTask nur für Geräte, auf denen Windows 10 Version 1607 oder höher ausgeführt wird.
Weitere Informationen
KonzepteApp-Verträge und -Erweiterungen
Anforderungen
| Element | Wert |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |