uap:Extension (Windows 10)

Deklariert einen Erweiterbarkeitspunkt für die App.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Application>

              <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.'

  <!-- 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

Attributes

attribute 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.personalAssistantLaunch oder 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 behandelt (normalerweise der vollqualifizierte Name eines Windows-Runtime Typs). Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet. Nein
Ausführbare Datei Die ausführbare Standardstartdatei. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen länge, die enden .exemuss, und kann diese Zeichen nicht enthalten: <, :>, ?"|oder .* Gibt die ausführbare Standarddatei für die Erweiterung an. Falls 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 gemischte Frameworks in einer App vorhanden sind. Eine Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen länge, die nicht mit einem . zeichen beginnen oder enden können oder enthalten können: <, >:, ?"|oder .* Nein
StartPage Die Webseite, die den Erweiterungspunkt behandelt. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen länge, 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 " Hinweise " 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, packagedClassicApp oder win32App. Nein
uap10:HostId Gibt die App-ID der Host-App 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. Nur für Desktop-Apps mit einer Paketidentität unterstützt. Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen in Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende. Nein

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 aufzurufen, die zu einer anderen App gehört; oder für eine Hintergrundaufgabe, die aufgerufen wird, um einen App-Vertrag zu verwenden, eine Möglichkeit, mit seinem Anrufer 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 für die automatische Wiedergabe bereit.
uap:AutoPlayDevice Deklariert einen App-Erweiterbarkeitspunkt vom Typ *windows.autoPlayDevice. Die App stellt die angegebenen Aktionen 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 können 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 behandeln.
uap:MediaPlayback Deklariert einen App-Erweiterbarkeitspunkt vom Typ "mediaPlayback", damit Ihre App deklarieren kann, dass sie videotranscodierung ausführt.
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 behandeln.
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 ein Upgrade von einem Mobilfunkanruf auf einen VoIP-Videoanruf ausgeführt werden kann und/oder ob es sich um eine VoIP-App handelt, die die DirekteWahl von Telefonnummern unterstützt.
uap:WebAccountProvider Deklariert einen App-Erweiterbarkeitspunkt vom Typ "windows.webAccountProvider".

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Erweiterungen (type:CT_ApplicationExtensions) Definiert einen oder mehrere Erweiterungspunkte für die App.

Bemerkungen

Für die meisten Arten von Erweiterungen muss Extension@ResourceGroup Application@ResourceGroup entsprechen (wenn Application@ResourceGroup nicht angegeben wird, sollte auch Extension@ResourceGroup weggelassen werden).

Bei einem benutzeroberflächebasierten Vertrag: Wenn Extension@ResourceGroup nicht angegeben wird, wird er implizit mit der Anwendung gruppiert; wenn Extension@ResourceGroup nicht mit Application@ResourceGroup übereinstimmt, schlägt das Manifest die Schemaüberprüfung fehl.

Wenn Extension@ResourceGroup für eine Hintergrundaufgabe oder für einen Vertrag, der auf einer Hintergrundaufgabe basiert, nicht angegeben wird, wird sie einer Standardgruppe für alle Hintergrundaufgaben zugeordnet. Hintergrundaufgabenverträge dürfen dieselben Werte wie Application@ResourceGroup angeben.

Für die folgenden Erweiterungen können Extension@ResourceGroup die Hintergrundaufgabe, die ausgeführt wird, in verschiedene Prozesse gruppiert werden, die unabhängig von anderen Gruppen ressourcen- und lebenszyklusgewaltet werden: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask und windows.updateTask.

Wenn das Manifest beispielsweise diese drei Einträge hatte.

<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 backgroundtaskhost.exe aktiviert werden, wenn sie gleichzeitig aktiviert wurden. Eine separate Instanz von backgroundtaskhost.exe würde jedoch für den ersten Eintrag spuniert werden, da es über eine andere ResourceGroup verfügt.

Wenn keine ResourceGroup für eine Erweiterung angegeben wird, werden alle Hintergrundaufgaben in derselben Instanz von backgroundtaskhost.exeaktiviert.

Darüber hinaus gibt eine dieser Erweiterungen (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask oder windows.updateTask) denselben Wert des ResourceGroup-Attributs des übergeordneten Application-Elements an, 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 die Beschreibungen für jede dieser Elemente:

  • Suche: Registriert die App als Suchanbieter. Der indizierte Inhalt der App kann als Suchergebnisse in der globale Suche-Erfahrung angezeigt werden, die über den Charm "Suche" gestartet wird. Pro App ist nur eine Instanz dieser Deklaration zulässig.
  • CachedFileUpdater: Registriert die App als zwischengespeichertes Dateiupdater, sodass die App Updates für Dateien, auf die von anderen Microsoft Store-Apps zugegriffen wird, auf die zugegriffen werden kann. 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 im 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 beantworten 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 System-Alarm-App deklarieren. Wenn ein Benutzer die Auswahl-Benutzeroberfläche durchläuft, um den System-Alarm festzulegen, können nur Anwendungen ausgewählt werden, die als System-Alarm-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 zum Aufrufen einer anderen Anwendung zu ermöglichen. 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 3D-Druckdialogfeld eine einzigartige Erfahrung zu bieten. Wenn dies nicht der Benutzer der Regel ist, bietet Windows eine standardmäßige 3D-Druckumgebung. 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

Element Wert
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10