uap3:AppExtension

Artikel
11/11/2023

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>

<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
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)

Freigeben über