uap4:Extension
声明应用的扩展点。
元素层次结构
<uap4:Extension>
语法
<uap4:Extension
Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. 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 the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (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 with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string value. If specified, it must be one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
uap11:SupportsMultipleInstances = 'An optional boolean value.'
uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >
<!-- Child elements -->
uap4:SharedFonts
uap4:UserDataTaskDataProvider
uap4:MediaCodec
uap4:ContactPanel
uap4:LoopbackAccessRules
uap4:DevicePortalProvider?
</uap4:Extension>
密钥
? 可选 (零个或一个)
特性和元素
属性
| 属性 | 说明 | 数据类型 | 必须 | 默认值 |
|---|---|---|---|---|
| 类别 | 包扩展点的类型。 | 可以具有以下值之一的字符串： windows.sharedFonts、 windows.userDataTaskDataProvider、 windows.mediaCodec、 windows.contactPanel、 windows.loopbackAccessRules、 windows.devicePortalProvider、 windows.printWorkflowBackgroundTask 或 windows.printWorkflowForegroundTask。 | 是 | |
| EntryPoint | 可激活的类 ID。 | 值长度介于 1 到 256 个字符之间的字符串。 表示处理扩展的任务，通常 (Windows 运行时类型) 的完全命名空间限定名称。 如果未指定 EntryPoint，则改用为应用定义的 EntryPoint。 | 否 | |
| 可执行文件 | 默认启动可执行文件。 | 值长度介于 1 到 256 个字符之间的字符串，必须以 .exe结尾，并且不能包含以下字符：<、>、:、"、|?、 或 *。 指定扩展的默认可执行文件。 如果未指定，则使用为应用定义的可执行文件。 如果指定，则还使用 EntryPoint 属性。 如果未指定该 EntryPoint 属性，则使用为应用定义的 EntryPoint。 |
否 | |
| RuntimeType | 运行时提供程序。 通常在应用中存在混合框架时使用。 | 长度介于 1 到 255 个字符之间的值的字符串，不能以 . 开头或结尾，或包含字符：<、>、:、"|、?、 或 *。 |
否 | |
| StartPage | 处理扩展点的网页。 | 值长度介于 1 到 256 个字符之间的字符串，不能包含以下字符：<、>、:、"、|?、 或 *。 |
否 | |
| ResourceGroup | 一个可选标记，用于将扩展激活组合在一起以进行资源管理 (例如 CPU 和内存) 。 请参阅 Application@ResourceGroup 中的“备注”部分。 | 长度介于 1 到 255 个字符之间的字母数字字符串。 必须以字母开头。 | 否 | |
| uap10：TrustLevel | 指定扩展的信任级别。 | 可选的字符串值。 如果指定，它可以是以下值之一： appContainer 或 mediumIL。 | 否 | |
| uap10：RuntimeBehavior | 指定扩展的运行时行为。 | 可选的字符串值。 如果指定，它可以是以下值之一： windowsApp、 packagedClassicApp 或 win32App。 | 否 | |
| uap10：HostId | 指定扩展的主机运行时的 ID。 | 一个字母数字字符串，其可选值长度介于 1 到 255 个字符之间。 必须以字母开头。 | 否 | |
| uap10：Parameters | 包含要传递给扩展的命令行参数。 仅桌面应用支持。 | 值长度介于 1 到 32767 个字符之间的字符串，开头和结尾处有一个非空格字符。 | 否 | |
| uap11：Id | 扩展的标识符。 对于包中的所有扩展，ID 必须是唯一的。 | 值长度介于 1 到 255 个字符之间的可选字符串，开头和结尾处有一个非空格字符。 | 否 | |
| uap11：Subsystem | 此属性继承自基本扩展语法，不适用于 com4 扩展。 除语法验证外，此值将被忽略。 | 可具有以下值之一的可选字符串： console 或 windows。 | 否 | |
| uap11：SupportsMultipleInstances | 指定实例是否应在不同的进程中运行。 默认值为 false。 | 可选的布尔值。 | 否 | |
| uap11：ResourceGroup | 一个标记，可用于将扩展激活组合在一起以进行资源管理， (例如 CPU 和内存) 。 可以设置的 ResourceGroup 值是自由格式且灵活的。 请参阅 Application@ResourceGroup。 | 值长度介于 1 到 255 个字符之间的可选字母数字字符串。 必须以字母开头。 | 否 | |
| uap11：CurrentDirectoryPath | 指定启动应用程序进程时的初始目录。 此属性支持宏。 有关详细信息，请参阅 包清单架构中的宏。 | 不能包含以下字符的可选字符串： <、 >、 |、 ?或 *。 > |
否 | |
| uap11：Parameters | 此属性继承自基本扩展语法，不适用于 com4 扩展。 除语法验证外，此值将被忽略。 此属性支持宏。 有关详细信息，请参阅 包清单架构中的宏。 | 一个可选字符串，其值长度介于 1 到 32767 个字符之间，开头和结尾处有一个非空格字符。 | 否 | |
| desktop7：CompatMode | 指定此扩展的信息是通过经典方式向 Windows 注册的， (例如，未打包的应用通过注册表) 或通过新的范围更广的方式向 COM 注册类型。 默认值为“modern”。 CompatMode=“classic”需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 | 可选字符串 可以具有以下值之一： classic 或 modern。 | 否 | |
| desktop7：Scope | 指定注册是否仅对以用户 (用户) 注册此包的用户运行的其他应用程序可见，或者是否对计算机上的所有用户和服务可见 (计算机) 。 默认值为“user”。 Scope=“machine”需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 | 可具有以下值之一的可选字符串： machine 或 user。 | 否 |
子元素
| 子元素 | 描述 |
|---|---|
| SharedFonts | 包含要与应用一起使用的共享字体的位置。 |
| UserDataTaskDataProvider | 使应用成为任务的 DataProvider。 |
| MediaCodec | 定义一个扩展，使应用能够从 Microsoft Store 安装媒体编解码器。 |
| ContactPanel | 在 Windows 应用中启用联系人面板。 |
| LoopbackAccessRules | 包含用于启用应用和服务之间通信的环回筛选器的规则。 |
| DevicePortalProvider | 定义用于部署的设备门户提供程序。 |
父元素
| 父元素 | 说明 |
|---|---|
| 扩展 | 定义包的一个或多个扩展点。 |
注解
windows.printWorkflowBackgroundTask 和 windows.printWorkflowForegroundTask 是支持打印方案的空扩展声明。 打印系统最初将调用后台任务入口点以开始处理打印数据，前台任务将在向用户请求更多信息时激活。 后台入口点必须是实现 IBackgroundTask 的类。
要求
| 项 | 值 |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10/4 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| Minimum OS Version | Windows 10版本 1703 (内部版本 15063) |