Anwendung (Windows 10)

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

Elementhierarchie

<-Paket->

    <Anwendungen>

         <Application>

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 zwischenspeichern (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Bemerkungen

Das Application-Element enthält Attribute, die den Erweiterungspunkten der App gemeinsam sind. Diese Informationen werden von anderen Erweiterbarkeitspunkten verwendet, um Informationen zur App zu erhalten. Attribute Application werden auch als Aktivierungsinformationen beim Start und bei der Verwaltung einer Instanz der App verwendet (mit anderen Worten, sie beschreiben, wie ein Prozess gestartet wird 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 als auch EntryPoint- attribute 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 jedoch über <TargetDeviceFamily MinVersion="10.0.19041.0">oder höher verfügt, wird es nur auf Systemen installiert, die den uap10 Namespace unterstützen. In diesem Fall sollten Sie die Attribute uap10:RuntimeBehavior und uap10:TrustLevel 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 in einem App-Bereich Extension-Element angeben. Wenn sie für Extensionnicht angegeben sind, werden sie vom übergeordneten Applicationgeerbt. Sie geben diese Attribute in Kombinationen an, z. B. EntryPoint-, RuntimeBehavior-und TrustLevel- überlappende Bedeutung haben und in Kombinationen angegeben (und/oder geerbt). Hier sind einige gültige Kombinationen von Aktivierungsinformationenattributen.

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

Wie Sie sehen können, können Sie, wenn Ihr Zielsystem den uap10 Namespace nicht unterstützt, stattdessen das EntryPoint-attribut angeben. Entsprechend entspricht uap10:TrustLevel="appContainer" auf älteren Systemen EntryPoint="windows.partialTrustApplication".

Es ist jedoch redundant, sowohl uap10:RuntimeBehavior/uap10:TrustLevel als auch 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 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 dieselbe Sache wie uap10:RuntimeBehavior="windowsApp". Daher wäre uap10:RuntimeBehavior in diesem Fall redundant, und Sie würden ausführbare und EntryPoint-angeben.

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

Das Festlegen uap10:TrustLevel="mediumIL", während uap10:RuntimeBehavior="windowsApp" die Microsoft.coreAppActivation_8wekyb3d8bbwe benutzerdefinierte Funktion erfordert.

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

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 mehrfach instanziert.
• Wenn die App SupportsMultipleInstances innerhalb des Application-Elements deklariert, muss sie nicht auf Erweiterungsebene deklariert werden (z. B. in einem BackgroundTasks-- oder AppService--Element).
• Die App sollte nur SupportsMultipleInstances für Hintergrundaufgaben, Hintergrundaudio oder App-Dienste deklarieren.
• Konsolen-Apps werden immer mehrfachinstanziert und müssen explizit SupportsMultipleInstancesdeklarieren.
• 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 beide SupportsMultipleInstances und ResourceGroup- im Manifest deklarieren.

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

Anforderungen