desktop8:Extension (在包/扩展中)

声明应用的扩展点。

元素层次结构

<包>

     <扩展>

          <desktop8:Extension>

语法

<desktop8:Extension
  Category = 'A string that can be one of the following values: "windows.mutablePackageDirectories", "windows.userMutablePackageDirectories", or "windows.eventTracing".'
  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.' 
  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 -->
  desktop8:MutablePackageDirectories
  desktop8:UserMutablePackageDirectories
  desktop8:EventTracing

</desktop8:Extension>

属性和元素

属性

属性 描述 数据类型 必填 默认值
类别 扩展的类别。 一个可以具有以下值的字符串:windows.mutablePackageDirectorieswindows.userMutablePackageDirectorieswindows.eventTracing 是的
可执行文件 默认启动可执行文件。 长度在 1 到 256 个字符之间的可选字符串,必须以 .exe 结尾,不能包含以下字符:<>:"|?*。 它指定扩展的默认可执行文件。 如果未指定,则使用为应用定义的可执行文件。 如果指定,则还会使用 EntryPoint 属性。 如果未指定 EntryPoint 属性,则使用为应用定义的 EntryPoint。
EntryPoint 可激活的类 ID。 长度介于 1 到 256 个字符之间的值(表示处理扩展的任务)的可选字符串。 这通常是 Windows 运行时类型的完全命名空间限定名称。 如果未指定 EntryPoint,则改用为应用定义的 EntryPoint。
RuntimeType 运行时提供程序。 当应用中存在混合框架时,通常会使用此属性。 长度介于 1 到 255 个字符之间的可选字符串,长度不能以句点开头或结尾,或包含以下字符:<>:"/\|?*
StartPage 处理扩展点的网页。 长度在 1 到 256 个字符之间的可选字符串,不能包含这些字符:<>:"|?*
uap10:TrustLevel 指定扩展的信任级别。 可以具有以下值之一的可选字符串:appContainermediumIL
uap10:RuntimeBehavior 指定扩展的运行时行为。 可使用以下值之一的可选字符串:windowsApppackagedClassicApp,或 win32App
uap10:HostId 指定扩展的主机运行时的 ID。 长度介于 1 到 255 个字符之间的字母数字字符串。 必须以字母开头。
uap10:Parameters 包含要传递给扩展的命令行参数。 仅支持具有包标识的桌面应用。 一个可选字符串,其长度在 1 到 32767 个字符之间,其开头和结尾有非空格字符。
uap11:Id 扩展的标识符。 ID 对于包中的所有扩展必须是唯一的。 一个可选字符串,其长度介于 1 到 255 个字符之间,其开头和结尾为非空格字符。
uap11:Subsystem 扩展面向的子系统。 一个可选字符串,可以具有以下值之一:控制台窗口
uap11:SupportsMultipleInstances 指定实例是否应在不同的进程中运行。 默认值为 false。 可选的布尔值。
uap11:ResourceGroup 一个标记,可用于将扩展激活组合在一起以进行资源管理(例如 CPU 和内存)。 可以设置 ResourceGroup 的值是自由格式且灵活的。 请参阅 Application@ResourceGroup 一个可选的字母数字字符串,其长度介于 1 到 255 个字符之间。 必须以字母开头。
uap11:CurrentDirectoryPath 指定启动应用程序进程时的初始目录。 此属性支持宏。 有关详细信息,请参阅包清单架构 中的宏。 不能包含以下字符的可选字符串:<>|?*。 >
uap11:Parameters 扩展面向的子系统。 此属性支持宏。 有关详细信息,请参阅包清单架构 中的宏。 一个可选字符串,其长度在 1 到 32767 个字符之间,其开头和结尾有非空格字符。
desktop7:CompatMode 指定此扩展的信息是以经典方式(例如,通过注册表向 COM 注册类型)还是以新的更作用域的方式向 Windows 注册。 默认值为“modern”。 CompatMode=“classic”需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 可选字符串,可以具有以下值之一:经典新式
desktop7:范围 指定注册是否仅对作为已注册此包的用户运行的其他应用程序可见,或者是否对计算机上的所有用户和服务可见。 默认值为“user”。 Scope=“machine”需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 一个可选字符串,可以具有以下值之一:计算机用户

子元素

子元素 描述
desktop8:MutablePackageDirectories 使桌面应用程序能够指定一个或多个文件夹,你可以在其中修改应用程序的安装文件。
desktop8:UserMutablePackageDirectories 使桌面应用程序能够指定一个或多个文件夹,用户可以在其中修改应用程序的安装文件(例如,安装模式)。
desktop8:EventTracing 使桌面应用程序能够实时记录应用程序定义的事件或保存到日志文件中。

父元素

Parent 元素 描述
扩展(在包/应用程序中) 定义应用程序的一个或多个扩展点。

要求

项目 价值
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/8
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
最低 OS 版本 Windows 11 版本 21H2 (内部版本 22000)