desktop6:Extension (in Package/Extensions)

  • Article

Declares an extensibility point for the desktop application.

Element hierarchy

<Package>

    <Extensions>

         <desktop6:Extension>

Syntax

<desktop6:Extension
  Category = 'A string that can have one of the following values: "windows.mutablePackageDirectories" or "windows.customInstall".'
  Executable = 'An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  ( desktop6:MutablePackageDirectories
  | desktop6:CustomInstall )?

</desktop6:Extension>

Key

? optional (zero or one)

Attributes and elements

Attributes

Attribute Description Data type Required Default value
Category The category of the extension. A string that can have one of the following values: windows.mutablePackageDirectories or windows.customInstall. Yes
Executable The default launch executable. An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used. No
EntryPoint The activatable class ID. An optional string with a value 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. No
RuntimeType The runtime provider. This attribute is used typically when there are mixed frameworks in an app. An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *. No
StartPage The web page that handles the extensibility point. An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No
uap10:TrustLevel Specifies the trust level of the extension. An optional string that can have one of the following values: appContainer or mediumIL. No
uap10:RuntimeBehavior Specifies the run time behavior of the extension. An optional string that can have one of the following values: windowsApp, packagedClassicApp, or win32App. No
uap10:HostId Specifies the ID of the host runtime for the extension. An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter. No
uap10:Parameters Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity. An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. No

Child elements

Child element Description
MutablePackageDirectories Enables your desktop application to specify one or more folders where users can modify the installation files for your application (for example, to install mods).
CustomInstall Enables your desktop application to specify one or more additional installer files (.exe or .msi) that are installed with your desktop application. For example, this is useful for applications that bundle a 3rd party redistributable component.

Parent elements

Parent element Description
Extensions (type: CT_PackageExtensions) Defines one or more extensibility points for the package.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 version 1903 (Build 18362)