uap5:Extension

Deklariert einen Erweiterungspunkt für die App.

Elementhierarchie

<-Paket->

     <Anwendungen>

          <Application>

               <Erweiterungen>

                    <uap5:Extension>

Syntax

<uap5:Extension
  Category = 'A string that can have one of the following values: "windows.userActivity", "windows.mediaSource", "windows.videoRendererEffect", "windows.activatableClass.outOfProcessServer", "windows.startupTask", or "windows.appExecutionAlias".'
  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 -->
  uap5:UserActivity
  uap5:MediaSource
  uap5:VideoRendererEffect 
  uap5:ActivatableClass.OutOfProcessServer
  uap5:StartupTask
  uap5:AppExecutionAlias?

</uap5: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.userActivity, windows.mediaSource, windows.videoRendererEffect, windows.aktivableClass.outOfProcessServer, windows.startupTaskoder windows.appExecutionAlias.	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
UserActivity-	Ermöglicht einer App, die website anzugeben, die dieser Anwendung für die plattformübergreifende UserActivity-Veröffentlichung zugeordnet ist.
MediaSource-	Gibt die Medienquelle und den App-Dienst an, den er verfügbar macht.
VideoRendererEffect-	Aktiviert die Aktivierung von Videorenderereffekten in Apps.
ActivatableClass.OutOfProcessServer	Deklariert einen Paketerweiterungspunkt vom Typ windows.activatableClass.outOfProcessServer. Dadurch können WinRT-Klassen von Drittanbietern, die im App-Paket definiert sind, aus einem Win32-Prozess aufgerufen werden.
StartupTask-	Gibt eine Startaufgabe für Ihre Anwendung an.
AppExecutionAlias	Gibt den Ausführungsalias der Anwendung an, um den Einstiegspunkt für die Aktivierung einer App zu bestimmen.

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
Erweiterungen	Definiert einen oder mehrere Erweiterbarkeitspunkte für das Paket.

Anforderungen

Artikel	Wert
Namespace-	http://schemas.microsoft.com/appx/manifest/uap/windows10/5
uap10-	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Mindestversion des Betriebssystems	Windows 10, Version 1709 (Build 16299)