Anwendung (Paketschema für Windows 8)

Artikel
07/20/2023

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

Elementhierarchie

<Anwendungen>: <Anwendung>

Syntax

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It 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 that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is 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.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Schlüssel

? optional (null oder eins)

& Verwebungsconnector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attributes

Attribut	BESCHREIBUNG	Datentyp	Erforderlich
EntryPoint	Die aktivatable-Klassen-ID, z. B. ""Office. Winword.Class". Bei Desktop-Apps sollte dieser Wert der tatsächliche Einstiegspunkt der ausführbaren Datei sein, z. B. "main", "WinMain" oder "wWinMain". Wenn Sie dieses Attribut angeben, müssen Sie auch das Executable-Attribut angeben. Wenn Sie dieses Attribut angeben, dürfen Sie das StartPage-Attribut nicht angeben.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die den Task darstellt, der die Erweiterung behandeln soll. Dies ist normalerweise der vollständig qualifizierte Namespacename eines Windows-Runtime-Typs. Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet.	Nein
Ausführbare Datei	Die standardmäßige ausführbare Startdatei für die App. Diese Datei muss im Paket vorhanden sein. Wenn Sie dieses Attribut angeben, müssen Sie das EntryPoint-Attribut angeben. Wenn Sie dieses Attribut angeben, dürfen Sie das StartPage-Attribut nicht angeben.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".exe" enden muss und folgende Zeichen nicht enthalten darf: <, >, : , %, ", \|, ? oder *. Sie gibt die ausführbare Standarddatei für die Erweiterung an. Wenn nichts angegeben ist, wird die ausführbare Datei verwendet, die für die App definiert ist. Wenn angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben wird, wird der für die App definierte EntryPoint verwendet.	Nein
Id	Der eindeutige Bezeichner der Anwendung innerhalb des Pakets. Dieser Wert wird manchmal als relative App-ID für das Paket (Package relative app ID, PRAID) bezeichnet. Die ID ist innerhalb des Pakets eindeutig, aber nicht global. In einem anderen Paket im System kann die gleiche ID verwendet werden. Dieselbe ID kann nicht mehr als einmal im selben Paket verwendet werden. Diese Zeichenfolge enthält alphanumerische Felder, die durch Punkte getrennt sind. Jedes Feld muss mit einem ASCII-Buchstaben beginnen. Sie können diese 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". Wenn Sie eine Visual Studio verwenden, 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.	Eine ASCII-Zeichenfolge mit einer Länge von 1 bis 64 Zeichen.	Ja
StartPage	Die STANDARDMÄßIGE HTML-Startseite für die App. Diese Datei muss im Paket vorhanden sein. Wenn Sie dieses Attribut angeben, können Sie weder das EntryPoint-Attribut noch das Executable-Attribut angeben.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten darf: <, >, :, %, ", \|, ?, oder *.	Nein

Untergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
ApplicationContentUriRules	Gibt an, welche Seiten im Webkontext Zugriff auf die Geolocationgeräte des Systems haben (wenn die App über die Berechtigung für den Zugriff auf diese Funktion verfügt) und Zugriff auf die Zwischenablage haben.
Erweiterungen (Typ: CT_ApplicationExtensions)	Definiert einen oder mehrere Erweiterungspunkte für die App.
VisualElements	Beschreibt die visuellen Aspekte der UWP-App: Standardkachel, Logobilder, Text- und Hintergrundfarben, anfängliche Bildschirmausrichtung, Begrüßungsbildschirm und Darstellung der Sperrbildschirmkachel.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Anwendungen	Stellt eine oder mehrere Apps dar, aus denen das Paket besteht.

Hinweise

Das Application-Element enthält Attribute, die den Erweiterungspunkten der App gemeinsam sind. Diese Informationen werden von anderen Erweiterungspunkten verwendet, um Informationen zur App zu erhalten. Darüber hinaus werden Anwendungsattribute beim Start und bei der Verwaltung einer Instanz der App verwendet.

Wenn das StartPage-Attribut angegeben wird, handelt es sich um eine Windows-App, die JavaScript verwendet. Wenn StartPage nicht angegeben ist, müssen sowohl das Executable-Attribut als auch das EntryPoint-Attribut angegeben werden, und es handelt sich um eine UWP-App, die C# oder VB XAML verwendet.

Beispiele

Das folgende Beispiel ist aus dem Paketmanifest eines der SDK-Beispiele entnommen.

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Anforderungen

	Wert
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`