uap3:AppExtension

  • Artikel

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appExtension. Dieses Element gibt an, welche Kategorien von Erweiterungen die App nutzen und/oder hosten möchte.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Anwendung>

              <Erweiterungen>

                   <uap3:Extension>

                        <uap3:AppExtension>

Syntax

<uap3:AppExtension
    Name = 'A string with a value between 2 and 255 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    Id = 'A string with a value between 2 and 39 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    PublicFolder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'A string with a value between 1 and 256 characters in length.'
    Description = 'A string between 1 and 2048 characters in length.' >

  <!-- Child elements -->
  uap3:Properties?

</uap3:AppExtension>

Schlüssel

? optional (null oder 1)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Beschreibung Beschreibung der App Eine Zeichenfolge zwischen 1 und 2048 Zeichen. No
DisplayName Ein Anzeigename für die App-Erweiterung, der Benutzern angezeigt werden kann. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen. Yes
Id Der Einstiegspunkt, über den die Host-App auf die Erweiterungskategorie zugreift, instance, wenn mehrere Einstiegspunkte vorhanden sind. Eine Zeichenfolge mit einem Wert zwischen 2 und 39 Zeichen, die nur aus alphanumerischen Zeichen, Punkten (mit Ausnahme des ersten Zeichens) und Bindestrichen besteht. Yes
Name Der Typ der Erweiterung, die die App nutzen und/oder hosten möchte. Eine Zeichenfolge mit einem Wert zwischen 2 und 255 Zeichen, die nur aus alphanumerischen Zeichen, Punkten (mit Ausnahme des ersten Zeichens) und Bindestrichen besteht. Yes
PublicFolder Der Ordner, den der instance als Speicherort deklariert, an dem ein Host über einen Broker Lesezugriff auf Dateien haben kann. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die die folgenden Zeichen nicht enthalten darf: <, >, :, ", |?, oder *. Yes

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
uap3:Properties Enthält undurchsichtiges XML, das benutzerdefinierte, erweiterungsspezifische Informationen darstellt, die einfach gespeichert und nicht vom Betriebssystem gelesen werden. Die Informationen werden nur von der Host-App gelesen.

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
uap3:Extension Deklariert einen Erweiterbarkeitspunkt für die App.

Beispiele

Im folgenden Beispiel wird angegeben, dass die App die Browsererweiterung mit niedriger Leistung hostet oder nutzt.

<Package
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  
    IgnorableNamespaces="... uap3">
    <Applications>
        <Application>
            <Extensions>
                <uap3:Extension 
                    Category="windows.appExtension">  
                    <uap3:AppExtension
                        Name="com.microsoft.browser.ext"
                        Id="Extension.Low.Performance"
                        PublicFolder="public\lowperf"
                        DisplayName="Low Performance Extension"/>  
                </uap3:Extension>  
              </Extensions>
        </Application>
    </Applications>
</Package>

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
Minimum OS Version Windows 10 Version 1607 (Build 14393)