Anwendung (Windows 10)

Stellt eine App dar, die einen Teil oder alle funktionen umfasst, die im Paket bereitgestellt werden.

Elementhierarchie

<Anwendung>

Syntax

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?
  uap11:CurrentDirectoryPath?
  uap11:Parameters?

  <!-- Child elements -->
  uap:ApplicationContentUriRules?
  Extensions?
  uap7:Properties
  uap:VisualElements

</Application>

Schlüssel

? optional (null oder eins)
& Verbinder (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich
EntryPoint	Die aktivierbare Klassen-ID (z. B. "Office.Winword.Class") oder "windows.fullTrustApplication" oder "windows.partialTrustApplication". Wenn Sie EntryPoint angeben, müssen Sie auch das ausführbare Attribut angeben. Wenn Sie EntryPoint angeben, dürfen Sie das StartPage-Attribut nicht angeben.	Eine Zeichenfolge zwischen 1 und 256 Zeichen länge, die die Aufgabe darstellt, die die Erweiterung verarbeitet. Dies ist normalerweise der vollständig namespacequalifizierte Name eines Windows-Runtime-Typs; es kann sich jedoch um einen der speziellen Werte "windows.fullTrustApplication" oder "windows.partialTrustApplication" handeln. Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet.	Nein
ausführbare Datei	Die ausführbare Standardstartdatei für die App. Die angegebene Datei muss im Paket vorhanden sein. In älteren Systemen (ausführliche Informationen finden Sie im Abschnitt "Hinweise"), wenn Sie "Ausführbare Datei" angeben, müssen Sie auch das EntryPoint-Attribut angeben. Wenn Sie "Ausführbare Datei" angeben, dürfen Sie dasStartPage-Attribut nicht angeben.	Eine Zeichenfolge zwischen 1 und 256 Zeichen länge, die mit `.exe` diesen Zeichen enden und darf nicht enthalten: `<`, , , `>`, `:`, `"`, , `\|`, , `?`oder `*`.	Nein
uap10:HostId-	Die App-ID der Host-App für die aktuelle App. Dieses Attribut wird für gehostete Apps verwendet.	Eine alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen länge. Muss mit einem Buchstaben beginnen.	Nein
Id	Der eindeutige Bezeichner der Anwendung innerhalb des Pakets. Dieser Wert wird manchmal als paketrelativer App-Bezeichner (PRAID) bezeichnet. Die ID ist innerhalb des Pakets eindeutig, aber nicht global. Möglicherweise gibt es ein weiteres Paket auf dem System, das dieselbe ID verwendet. Dieselbe ID kann nicht mehrmals im selben Paket verwendet werden. Bei Verwendung einer Visual Studio-Vorlage ist der Standardwert dieses Attributs "App". Entwickler sollten dies manuell im Manifest ändern. Der Bezeichner der App sollte nicht geändert werden, nachdem die App im Microsoft Store veröffentlicht wurde. Dadurch wird die Position der Kachel auf dem Startbildschirm unterbrochen.	Eine ASCII-Zeichenfolge zwischen 1 und 64 Zeichen länge. Diese Zeichenfolge enthält alphanumerische Felder, die durch Punkte getrennt sind. Jedes Feld muss mit einem ALPHABETISCHEN ASCII-Zeichen beginnen. Sie können diese Werte nicht als Feldwerte verwenden: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 und LPT9.	Ja
uap10:Parameters	Enthält Befehlszeilenparameter, die an die App übergeben werden sollen. Wird nur für Desktop-Apps mit Paketidentität unterstützt (siehe Bereitstellungsübersicht).	Eine Zeichenfolge zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende.	Nein
ResourceGroup	Ein 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:RuntimeBehavior	Gibt das Laufzeitverhalten der App an. "packagedClassicApp" – eine Desktop-Brücke-App (Centennial). "win32App" – jede verpackte App, die nicht UWP ist und nicht mit Desktop-Brücke -Verhalten (Centennial) ausgeführt wird. Diese Apps werden manchmal als Winmain, Main oder HWND-basiert bezeichnet. Erfordert ein TrustLevel von "mediumIL". "windowsApp" – eine UWP-App (Universelle Windows-Plattform). Geht immer mit einem TrustLevel von "appContainer". Alle Apps mit einem dieser drei Verhaltensweisen teilen gemeinsame Eigenschaften (einige dieser allgemeinen Eigenschaften werden deklariert `appxmanifest.xml`) und als Prozess mit Paketidentität und Anwendungsidentität ausgeführt. Und Sie können sich diese Apps als in zwei Gruppen vorstellen (auch wenn es drei mögliche Werte für uap10:RuntimeBehavior gibt). Die erste Gruppe von Apps ist UWP-Apps ("windowsApp"); und die zweite Gruppe von Apps ist Windows `.exe`s mit haupt und WinMain (entweder "packagedClassicApp" oder "win32App"). Die zweite Gruppe wird auch als Desktop-Apps bezeichnet.	Eine Zeichenfolge mit einem der folgenden Werte: "packagedClassicApp", "win32App" oder "windowsApp".	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 `*`. Ein beliebiger gültiger URI oder IRI (die Nicht-ASCII-Version eines URI).	Nein
desktop4:Subsystem	Gibt an, ob es sich bei der App um eine UWP-Standard-App oder eine UWP-Konsolen-App handelt.	Eine Zeichenfolge, die eine der folgenden Werte sein kann: Konsole oder Fenster.	Nein
uap10:Subsystem	Gibt an, ob es sich bei der App um eine UWP-Standard-App oder eine UWP-Konsolen-App handelt.	Eine Zeichenfolge, die eine der folgenden Werte sein kann: Konsole oder Fenster.	Nein
desktop4:SupportsMultipleInstances	Gibt die Unterstützung mehrerer separater Instanzen von UWP-Apps an. Weitere Informationen finden Sie im Abschnitt "Hinweise".	Ein boolescher Wert.	Nein
uap10:SupportsMultipleInstances	Gibt die Unterstützung mehrerer separater Instanzen von UWP-Apps an. Weitere Informationen finden Sie im Abschnitt "Hinweise".	Ein boolescher Wert.	Nein
uap10:TrustLevel	Gibt die Vertrauensstufe der App an. "mediumIL": Die App ist voll vertrauenswürdig; der Prozess wird mit einer Integritätsebene des Mediums ausgeführt (siehe obligatorische Integritätssteuerung). Benötigt die eingeschränkte Funktion "Voll vertrauenswürdige Berechtigungsstufe" (siehe App-Funktionsdeklarationen). "appContainer": Die App wird in einem einfachen App-Container ausgeführt (siehe MSIX AppContainer-Apps); der Prozess wird mit einer integritätsarmen Ebene ausgeführt. Es ist auch möglich, dass eine entpackte App in einem AppContainer ausgeführt werden kann.	Eine Zeichenfolge mit einem der folgenden Werte: "mediumIL" oder "appContainer".	Nein
uap16:BaseNamedObjectsIsolation	Aktiviert die BaseNameObject -Isolation (BNO) für die App.	Eine Zeichenfolge, die einen der folgenden Werte sein kann: Paket oder keine.	Nein
uap17:BaseNamedObjectsIsolation	Aktiviert die BaseNameObject -Isolation (BNO) für die App.	Eine Zeichenfolge, die einen der folgenden Werte sein kann: Paket oder keine.	Nein
desktop11:AppLifecycleBehavior	Ermöglicht einer App die Außerkraftsetzung des Lebenszyklusverhaltens, das dem Laufzeitverhalten für die Erweiterung zugeordnet ist. Apps oder Erweiterungen mit einer RuntimeBehavior von "windowsApp" verfügen implizit über AppLifecycleBehavior von "systemManaged", sofern nicht anders angegeben. Apps oder Erweiterungen mit RuntimeBehavior von "packagedClassicApp" oder "win32App" verfügen implizit über AppLifecycleBehavior von "unmanaged", sofern nicht anders angegeben.	Einer der folgenden Werte: "systemManaged" , "unmanaged".	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

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
uap:ApplicationContentUriRules	Gibt an, welche Seiten im Webkontext Zugriff auf die Geolocation-Geräte des Systems haben (wenn die App über die Berechtigung für den Zugriff auf diese Funktion verfügt) und zugriff auf die Zwischenablage.
Erweiterungen (Typ: CT_ApplicationExtensions)	Definiert einen oder mehrere Erweiterbarkeitspunkte für die App.
uap7:Properties	Gibt die Eigenschaften der App an.
uap:VisualElements	Beschreibt die visuellen Aspekte der App: die Standardkachel, Logobilder, Text- und Hintergrundfarben, die Ausrichtung des Anfangsbildschirms, den Begrüßungsbildschirm und die Darstellung der Kachel auf dem Sperrbildschirm.

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
Anträge	Stellt eine oder mehrere Apps dar, die das Paket umfassen.

Bemerkungen

Das Application-Element enthält Attribute, die für die Erweiterungspunkte gelten, die sich auf die App beziehen. Diese Informationen werden von anderen Erweiterbarkeitspunkten verwendet, um Informationen zur App zu erhalten. Anwendungsattribute werden auch als Aktivierungsinformationen beim Starten und Verwalten einer Instanz der App verwendet (mit anderen Worten, sie beschreiben, wie sie einen Prozess starten und mit welchem Verhalten).

Das StartPage-Attribut gilt nur für JavaScript-Apps. Wenn StartPage nicht angegeben ist, müssen sowohl die Attribute "Ausführbare Datei" als auch " EntryPoint " angegeben werden (und dies gilt nur für C#-, C++- oder VB-Apps).

uap10 wurde in Windows 10, Version 2004 (10.0) eingeführt; Build 19041)

Der uap10 Namespace (für uap10:RuntimeBehavior und uap10:TrustLevel) wurde in Windows 10, Version 2004 (10.0) eingeführt. Build 19041). Wenn Ihr Paket auf älteren Systemen installiert wird, müssen Sie eine entsprechende Kombination von Attributen bereitstellen (siehe den folgenden Abschnitt), andernfalls sind die Aktivierungsinformationen unvollständig, und die Installation schlägt fehl.

Wenn Ihr Paket <TargetDeviceFamily MinVersion="10.0.19041.0">jedoch über oder höher verfügt, wird es nur auf Systemen installiert, die den uap10 Namespace unterstützen. In diesem Fall sollten Sie die uap10:RuntimeBehavior und uap10:TrustLevel die Attribute vor den älteren entsprechenden Kombinationen verwenden (siehe den folgenden Abschnitt).

Kombinationen von Aktivierungsinformationenattributen

Sie können Aktivierungsinformationenattribute für das Application-Element angeben; und Sie können sie optional für ein Erweiterungselement im App-Bereich angeben. Wenn sie für die Erweiterung nicht angegeben sind, werden sie von der übergeordneten Anwendung geerbt. Sie geben diese Attribute in Kombinationen an, z. B. EntryPoint, RuntimeBehavior und TrustLevel haben eine überlappende Bedeutung, und sie werden in Kombinationen (und/oder geerbt) angegeben. Hier sind einige gültige Kombinationen von Aktivierungsinformationenattributen.

Ausführbare Datei, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL" oder "appContainer" (standardwert, wenn nicht angegeben)]
Ausführbare Datei, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (weitere Anforderungen finden Sie in der Beschreibung weiter oben in diesem Thema für uap10:RuntimeBehavior).
Ausführbare Datei, EntryPoint="windows.fullTrustApplication" (entspricht uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
Ausführbare Datei, EntryPoint="windows.partialTrustApplication" (entspricht uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
Ausführbare Datei, EntryPoint="<alles andere>"

Wie Sie sehen können, können Sie stattdessen das uap10 angeben, wenn Ihr Zielsystem den Namespace nicht unterstützt. Ebenso ist das Äquivalent von "uap10:TrustLevel="appContainer" auf älteren Systemen EntryPoint="windows.partialTrustApplication".

Es ist jedoch redundant, beide uap10:RuntimeBehavior/uap10:TrustLevel und EntryPoint gleichzeitig anzugeben. Aber wenn Sie dies tun, dann ist es ein Fehler, wenn sie widersprechen.

App-Aktivierungen für die universelle Windows-Plattform (UWP) erfordern EntryPoint. Wenn Sie also "Ausführbare Datei" und "uap10:RuntimeBehavior="windowsApp" (ohne EntryPoint) angeben, ist dies ein Fehler. In diesem Fall würde EntryPoint etwas anderes als "windows.fullTrustApplication" und "windows.partialTrustApplication" angeben; und andere Werte als diese beiden sagen bereits dasselbe wie uap10:RuntimeBehavior="windowsApp". Daher wäre uap10:RuntimeBehavior in diesem Fall redundant, und Sie würden ausführbare Datei und EntryPoint angeben.

Das Festlegen von uap10:RuntimeBehavior="win32App" und uap10:TrustLevel="appContainer" wird nicht unterstützt.

uap10:TrustLevel="mediumIL" Für die Einstellung uap10:RuntimeBehavior="windowsApp" ist die Microsoft.coreAppActivation_8wekyb3d8bbwe benutzerdefinierte Funktion erforderlich.

Dies gilt auch, wenn uap10:TrustLevel="mediumIL" und EntryPoint ein anderer Wert als "windows.fullTrustApplication" oder "windows.partialTrustApplication".

Weitere Informationen zu dieser benutzerdefinierten Funktion finden Sie hier in benutzerdefinierten Funktionen.

Wichtige Hinweise zu Multi-Instancing-Apps

Wenn eine App SupportsMultipleInstances innerhalb des Application-Elements deklariert, werden auch alle Vordergrunderweiterungen mit mehreren Instanzen ausgeführt.
Wenn die App SupportsMultipleInstances innerhalb des Application-Elements deklariert, muss sie nicht auf Der Erweiterungsebene deklariert werden (z. B. in einem BackgroundTasks - oder AppService-Element ).
Die App sollte "SupportsMultipleInstances" nur für Hintergrundaufgaben, Hintergrundaudio oder App-Dienste deklarieren.
Konsolen-Apps werden immer mehrfachinstanziert und müssen "SupportsMultipleInstances" explizit deklarieren.
Apps können die ResourceGroup-Deklaration im Manifest verwenden, um mehrere Hintergrundaufgaben auf demselben Host zu gruppieren. Dies steht in Konflikt mit der Multiinstanzerstellung, bei der jede Aktivierung in einen separaten Host wechselt. Daher kann eine App nicht sowohl SupportsMultipleInstances als auch ResourceGroup im Manifest deklarieren.

Weitere Informationen zur Verwendung des SupportsMultipleInstances-Attributs zur Unterstützung mehrerer separater Instanzen von UWP-Apps finden Sie unter Erstellen einer universellen Windows-App mit mehreren Instanzen.

Anforderungen

Artikel	Wert
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Desktop4-Attribute	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/4`
uap10-Attribute	`http://schemas.microsoft.com/appx/manifest/uap/windows10/10`

Feedback

War diese Seite hilfreich?

Last updated on 2025-08-16