Edit

uap3:AppExtension

Declares an app extensibility point of type windows.appExtension. This element indicates which categories of extensions the app intends to consume and/or host.

Element hierarchy

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <uap3:Extension>
               └─ <uap3:AppExtension>

Syntax

<uap3:AppExtension
  Name = 'A required string with a value between 2 and 65519 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
  Id = 'A required 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 = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  DisplayName = 'A required string between 1 and 256 characters in length. This string is localizable.'
  Description = 'An optional string between 1 and 2048 characters in length.' >

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

</uap3:AppExtension>

Key

? optional (zero or one)

Attributes

Attribute Description Data type Required Default value
Name The type of extension that the app intends to consume and/or host. A string with a value between 2 and 65519 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only. Yes
Id The entry point by which the host app accesses the extension category instance, if there are multiple entry points. 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. Yes
PublicFolder The folder that the instance declares as the location where a host can have read access to files through a broker. An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No
DisplayName A friendly name for the app extension that can be displayed to users. A string between 1 and 256 characters in length. This string is localizable. Yes
Description The description of the app An optional string between 1 and 2048 characters in length. No

Child elements

Child element Description
uap3:Properties Contains opaque XML that represents custom, extension-specific information that is simply stored and not read by the operating system. The information is only read by the host app.

Parent elements

Parent element Description
uap3:Extension Declares an extensibility point for the app.

Requirements

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

Remarks

Examples

The following example indicates that the app hosts or consumes the low-performance browser extension

<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>
  • Last updated on