uap5:Extension

Description

Declares an extensibility point for the app.

Element Hierarchy

<Package>
<Applications>
<Application>
<Extensions>
<uap5:Extension>

Syntax

<uap5:Extension Category       = "windows.userActivity" | "windows.mediaSource" | "windows.videoRendererEffect" | "windows.activatableClass.outOfProcessServer" | "windows.startupTask" | "windows.appExecutionAlias"
                   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 *. 
                   ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. >

  <!-- Child elements -->
  ( uap5:UserActivity
  | uap5:MediaSource
  | uap5:VideoRendererEffect 
  | uap5:ActivatableClass.OutOfProcessServer
  | uap5:StartupTask
  | uap5:AppExecutionAlias )?

</uap5:Extension>

Key

? optional (zero or one)

Attributes

Attribute Description Data type Required
Category The category of the extension. One of the following:
  • windows.userActivity
  • windows.mediaSource
  • windows.videoRendererEffect
  • windows.activatableClass.outOfProcessServer
  • windows.startupTask
  • windows.appExecutionAlias
Yes
Executable The default launch 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. No
EntryPoint The activatable class ID. 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. No
RuntimeType The runtime provider. This attribute is used typically when there are mixed frameworks in an app. A string 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. A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No

Child Elements

Child Element Description
UserActivity Allows an app to opt out of engagement data tracking.
MediaSource Specifies the media source and the app service that it exposes.
VideoRendererEffect Enables activation of video renderer effects in apps.
ActivatableClass.OutOfProcessServer Declares a package extension point of type windows.activatableClass.outOfProcessServer. This enables 3rd party WinRT classes defined in the app package to be called from a Win32 process.
StartupTask Specifies a startup task for your application.
AppExecutionAlias Specifies the application's execution alias to determine the entry point for an app to be activated.

Remarks

Requirements

Namespace

http://schemas.microsoft.com/appx/manifest/uap/windows10/5