Share via


uap:Extension (Windows 10)

Deklariert einen Erweiterbarkeitspunkt für die App.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Anwendung>

              <Erweiterungen>

                   <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 1)

Attribute und Elemente

Attribute

attribute Beschreibung Datentyp Erforderlich Standardwert
Kategorie Der Typ des Paketerweiterungspunkts. Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: 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 oder windows.voipCall. Yes
EntryPoint Die aktivierbare Klassen-ID. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen. Stellt die Aufgabe dar, die die Erweiterung behandelt (normalerweise der voll 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 ausführbare Standardstartdatei. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die mit .exeenden muss und nicht die folgenden Zeichen enthalten kann: <, >, :, ", |, ?oder *. Gibt die standardmäßige ausführbare Datei 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 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 die Zeichen enthält: <, >, :, ", |?, oder *. No
StartPage Die Webseite, die den Erweiterungspunkt behandelt. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die die folgenden Zeichen nicht enthalten darf: <, >, :, ", |?, 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. Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: windowsApp, packagedClassicApp oder win32App. No
uap10:HostId Gibt die ID der Hostruntime für die Erweiterung an. Eine alphanumerische Zeichenfolge mit einem optionalen Wert zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen. No
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 und einem Leerzeichen am Anfang und Ende. No
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 und einem Leerzeichen am Anfang und Ende. No
uap11:Subsystem Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Konsole oder Fenster. No
uap11:SupportsMultipleInstances Gibt an, ob Instanzen in verschiedenen Prozessen ausgeführt werden sollen. Der Standardwert ist „FALSE“. Ein optionaler boolescher Wert. No
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 freiform und flexibel. Siehe Application@ResourceGroup. Eine optionale alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen. No
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 die folgenden Zeichen nicht enthalten kann: <, >, |, ?oder *. > No
uap11:Parameter Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema. Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende. No
desktop7:CompatMode Gibt an, ob die Informationen dieser Erweiterung bei Windows auf klassische Weise (z. B. unpacking apps register types with COM über the registry) oder auf neue, umfassendere Weise bei Windows registriert werden. Der Standardwert ist "modern". CompatMode="classic" erfordert die Microsoft.classicAppCompat_8wekyb3d8bbwe-Funktion . Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: klassisch oder modern. No
desktop7:Bereich Gibt an, ob die Registrierungen nur für andere Anwendungen sichtbar sind, die als Benutzer ausgeführt werden, für den dieses Paket registriert ist (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. No

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
uap:AppService Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appService. Anwendungsverträge sind eine Möglichkeit für eine App, eine Hintergrundaufgabe einer anderen App aufzurufen. oder für eine Hintergrundaufgabe, die aufgerufen wird, um einen App-Vertrag zu warten, eine Möglichkeit, mit dem Aufrufer zu kommunizieren.
uap:AppointmentsProvider Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appointmentsProvider.
uap:AutoPlayContent Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.autoPlayContent. Die App stellt die angegebenen Aktionen zur automatischen Wiedergabe von Inhalten bereit.
uap:AutoPlayDevice Deklariert einen App-Erweiterbarkeitspunkt vom Typ *windows.autoPlayDevice. Die App stellt die angegebenen Geräteaktionen für die automatische Wiedergabe bereit.
uap:DialProtocol Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.dialProtocol*.
uap:FileOpenPicker Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileOpenPicker. Mit der App kann der Benutzer die angegebenen Dateitypen auswählen und öffnen.
uap:FileSavePicker Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileSavePicker. Mit der App kann der Benutzer den Dateinamen, die Erweiterung und den Speicherort für die angegebenen Dateitypen auswählen.
uap:FileTypeAssociation Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileTypeAssociation. Eine Dateitypzuordnung gibt an, dass die App registriert ist, um Dateien der angegebenen Typen zu verarbeiten.
uap:MediaPlayback Deklariert einen App-Erweiterbarkeitspunkt vom Typ mediaPlayback, damit Ihre App deklarieren kann, dass die Videotranscodierung ausgeführt wird.
uap:Protocol Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.protocol. Eine URI-Zuordnung gibt an, dass die App registriert ist, um URIs mit dem angegebenen Schema zu verarbeiten.
uap:ShareTarget Deklariert einen App-Erweiterungspunkt vom Typ windows.shareTarget. Die App kann die angegebenen Dateitypen freigeben.
uap:VoipCall Deklariert einen App-Erweiterbarkeitspunkt 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-Erweiterbarkeitspunkt vom Typ windows.webAccountProvider.

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
Erweiterungen (Typ:CT_ApplicationExtensions) Definiert einen oder mehrere Erweiterbarkeitspunkte für die App.

Hinweise

Bei den meisten Arten von Erweiterungen müssen Extension@ResourceGroup mit 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 nicht für eine Hintergrundaufgabe oder für einen Vertrag angegeben ist, der auf einer Hintergrundaufgabe basiert, 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 ausgeführte Hintergrundaufgabe in verschiedene Prozesse gruppiert wird, die ressourcen- und lebenszyklusunabhängig von anderen Gruppen verwaltet werden: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask und windows.updateTask.

Beispielsweise, wenn das Manifest 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 instance backgroundtaskhost.exe von aktiviert, wenn sie gleichzeitig aktiviert würden. Für den ersten Eintrag wird jedoch ein separater instance von backgroundtaskhost.exe ausgegliedert, da er über eine andere ResourceGroup verfügt.

Wenn keine ResourceGroup für eine Erweiterung angegeben wird, werden alle Hintergrundaufgaben in derselben instance 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, werden sie im selben Prozess wie die Benutzeroberfläche aktiviert.

Die folgenden Erweiterungen finden Sie auf der Registerkarte Deklarationen der Benutzeroberfläche des Paket-Designers. Siehe die Beschreibungen für jedes dieser Elemente:

  • Search: Registriert die App als Suchanbieter. Der indizierte Inhalt der App kann als Suchergebnisse in der globale Suche-Benutzeroberfläche angezeigt werden, die über den Search-Charm gestartet wird. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • CachedFileUpdater: Registriert die App als zwischengespeicherten Dateiupdater, sodass die App Updates für Dateien bereitstellen kann, auf die von anderen Microsoft Store-Apps zugegriffen wird. 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 werden kann 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, die grundlegenden Druckeinstellungen zu ersetzen. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • LockScreen: Wenn ein Telefon gesperrt ist, kann der Benutzer nur eine begrenzte Menge an Interaktion ausführen. In einigen Fällen möchte ein Benutzer einen VoIP-Anruf annehmen können, ohne das Telefon zu entsperren. Dieser Vertrag ermöglicht dies. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • Alarm: Eine Anwendung kann sich selbst als Systemalarm-App deklarieren. Wenn ein Benutzer die Auswahloberfläche durchläuft, um seinen Systemalarm festzulegen, können nur Anwendungen ausgewählt werden, die als Systemalarm-Apps deklariert sind. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • BackgroundTasks: Hintergrundaufgaben ermöglichen Es Anwendungen, miteinander zu kommunizieren und eine Anwendung zum Aufrufen einer anderen zu ermöglichen. Um diese Hintergrundaufgaben mithilfe von Verträgen bereitzustellen oder zu starten, muss eine Anwendung als App Service 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 eine einzigartige Benutzeroberfläche im 3D-Druckdialogfeld zu bieten. Andernfalls bietet Windows eine standardmäßige 3D-Druckumgebung. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • PersonalAssistantLaunch: Ermöglicht die Integration einer App in Cortana. Pro App ist nur eine Instanz dieser Deklaration zulässig.

Anforderungen

Element Wert
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 Version 1511 (Build 10586)