应用程序/扩展) (Windows 10) 中的扩展 (
声明包的扩展点。
元素层次结构
<扩展>
语法
<Extension
Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
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.'
/>
<!-- Child elements -->
BackgroundTasks?
</Extension>
密钥
? 可选 (零个或一个)
特性和元素
属性
| 属性 | 说明 | 数据类型 | 必须 | 默认值 |
|---|---|---|---|---|
| 类别 | 包扩展点的类型。 | 可以是以下值之一： windows.backgroundTasks、 windows.preInstalledConfigTask、 windows.updateTask 或 windows.restrictedLaunch。 | 是 | |
| 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 | 指定扩展的运行时行为。 有关详细信息和要求，请参阅 uap10:RuntimeBehaviorApplication (Windows 10) 元素主题中的 。 |
可选的字符串值。 如果指定，它可以是以下值之一：“packagedClassicApp”、“win32App”或“windowsApp”。 | 否 | |
| uap10：HostId | 指定扩展的主机运行时的 ID。 | 一个字母数字字符串，其可选值长度介于 1 到 255 个字符之间。 必须以字母开头。 | 否 | |
| uap10：Parameters | 包含要传递给扩展的命令行参数。 仅桌面应用支持。 | 一个字符串，其值长度介于 1 到 32767 个字符之间，开头和结尾处为非空格字符。 | 否 |
子元素
| 子元素 | 描述 |
|---|---|
| BackgroundTasks | 定义 类型为 windows.backgroundTasks 的应用扩展点。 后台任务在专用后台主机中运行;即，没有 UI。 |
父元素
| 父元素 | 描述 |
|---|---|
| 扩展 (类型：CT_ApplicationExtensions) | 定义应用的一个或多个扩展点。 |
相关元素
以下元素的名称与此元素相同，但内容或属性不同：
注解
如果未在 扩展上指定激活信息属性，则它们继承自父 应用程序。 请参阅 Application 元素的备注部分。
扩展点是一种机制，包可以通过该机制以操作系统定义的方式添加功能。 扩展点是应用可以注册以执行代码或使用当前包的资源的位置。 若要为特定应用添加功能，请使用 Applications 元素的 Application 子元素。
无法在清单中多次声明 windows.certificates 扩展点。
注意
如果 Category 属性为 windows.UpdateTask 或 windows.preInstalledConfigTask ，则对于 Windows 10 版本 1607 之前的 Windows 10 版本，则需要 EntryPoint 或 StartPage 属性。 从 Windows 10 版本 1607 开始，当 Category 为 windows.Use、UpdateTaskwindows.preInstalledConfigTask 或仅面向运行 Windows 10 版本 1607 或更高版本的设备时，不再需要为 EntryPoint 或 StartPage 指定值。
另请参阅
概念应用合约和扩展
要求
| 项 | 值 |
|---|---|
| 命名空间 | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |