Erweiterung (typ: CT_ApplicationExtensions)

Deklariert einen Erweiterungspunkt für die App.

Elementhierarchie

<Paket>
<Anwendungen>
<Anwendung>
<Erweiterungen>
<Durchwahl>

Syntax

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           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.

           RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attributes

Attribut BESCHREIBUNG Datentyp Erforderlich Standardwert
Kategorie

Der Typ des App-Erweiterbarkeitspunkts.

Dieses Attribut kann einen der folgenden Werte haben:

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
Ja
EntryPoint

Die id der aktivatable-Klasse.

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.

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
Runtimetype

Der Laufzeitanbieter. Dieses Attribut wird in der Regel verwendet, wenn eine App gemischte Frameworks enthält.

Eine Zeichenfolge zwischen 1 und 255 Zeichen, die nicht mit einem Zeitraum beginnen oder enden kann oder die folgende Zeichen enthält: <, >, :, %, ", /, \, |, ?, oder *. Nein
StartPage

Die Webseite, die den Erweiterungspunkt behandelt.

Eine Zeichenfolge zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten darf: <, >, :, %, ", |, ?, oder *. Nein

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
AutoPlayContent

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.autoPlayContent. Die App stellt die angegebenen AutoPlay-Inhaltsaktionen zur Anwendung.

AutoPlayDevice

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.autoPlayDevice. Die App stellt die angegebenen AutoPlay-Geräteaktionen zur Anwendung.

BackgroundTasks

Definiert einen App-Erweiterbarkeitspunkt vom Typ windows.backgroundTasks. Hintergrundaufgaben werden auf einem dedizierten Hintergrundhost ausgeführt. das heißt, ohne Benutzeroberfläche.

FileOpenPicker

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileOpenPicker. Mit der App kann der Benutzer die angegebenen Dateitypen auswählen und öffnen.

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.

FileTypeAssociation

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileTypeAssociation. Eine Dateityp-Zuordnung gibt an, dass die App registriert ist, um Dateien der angegebenen Typen zu verarbeiten.

Protokoll

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.protocol. Eine URI-Zuordnung gibt an, dass die App für die Handhabung von URIs mit dem angegebenen Schema registriert ist.

ShareTarget

Deklariert einen App-Erweiterungspunkt vom Typ windows.shareTarget. Die App kann die angegebenen Dateitypen freigeben.

 

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
Erweiterungen (Typ: CT_ApplicationExtensions)

Definiert einen oder mehrere Erweiterungspunkte für die App.

 

Die folgenden Elemente haben denselben Namen wie dieses Element, aber ihr Inhalt oder ihre Attribute sind anders.

Hinweise

Diese Erweiterungspunkte können nur einmal pro App deklariert werden:

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**Hinweis zu semantischen Regeln für Erweiterungen: **Für jedes Extension-Element werden die folgenden semantischen Regeln in der Manifest-API erzwungen:

Wenn /Application/@StartPage angegeben ist, handelt es sich um eine Windows-App, die JavaScript und die App-Erweiterung verwendet:

  • Kann leer bleiben
  • Kann nur die StartPage angeben.
  • Kann sowohl ausführbare Dateien als auch EntryPoint (optionaler RuntimeType zulässig) angeben, es sei denn, es handelt sich um eine BackgroundTask-Erweiterung. In diesem Fall kann die ausführbare Datei weggelassen werden, und standardmäßig wird die BackgroundTaskHost.exe verwendet.

Wenn /Application/@StartPage nicht angegeben ist, handelt es sich um eine UWP-App, die C# oder VB xaml und die App-Erweiterung verwendet:

  • Kann leer bleiben
  • Kann nur die StartPage angeben.
  • Muss EntryPoint angeben, wenn entweder Executable oder RuntimeType angegeben ist.

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>

Siehe auch

KonzepteApp-Verträge und -Erweiterungen

Anforderungen

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