扩展(在包/扩展中) (Windows 10)

声明包的扩展点。

元素层次结构

<包>

     <扩展>

          <扩展>

语法

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  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 -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

属性和元素

属性

属性 描述 数据类型 必填 默认值
类别 包扩展点的类型。 一个具有以下值的字符串:windows.activatableClass.inProcessServerwindows.activatableClass.outOfProcessServerwindows.activatableClass.proxyStub windows.certificateswindows.publisherCacheFolderswindows.comInterfacewindows.loaderSearchPathOverride 是的
uap10:TrustLevel 指定扩展的信任级别。 可以具有以下值之一的可选字符串:appContainermediumIL
uap10:RuntimeBehavior 指定扩展的运行时行为。 可使用以下值之一的可选字符串:windowsApppackagedClassicApp,或 win32App
uap10:HostId 此值指定扩展的主机运行时的 ID。 长度介于 1 到 255 个字符之间的字母数字字符串。 必须以字母开头。
uap10:Parameters 包含扩展的命令行参数。 长度为 1 到 32767 个字符的字符串,其开头和结尾为非空格字符。
uap11:Id 扩展的标识符。 ID 对于包中的所有扩展必须是唯一的。 一个可选字符串,其长度介于 1 到 255 个字符之间,其开头和结尾为非空格字符。
uap11:Subsystem 此属性继承自基本扩展语法,不适用于 com4 扩展。 除了语法验证之外,此值将被忽略。 一个可选字符串,可以具有以下值之一:控制台窗口
uap11:SupportsMultipleInstances 指定实例是否应在不同的进程中运行。 默认值为 false。 可选的布尔值。
uap11:ResourceGroup 一个标记,可用于将扩展激活组合在一起以进行资源管理(例如 CPU 和内存)。 可以设置 ResourceGroup 的值是自由格式且灵活的。 请参阅 Application@ResourceGroup 一个可选的字母数字字符串,其长度介于 1 到 255 个字符之间。 必须以字母开头。
uap11:CurrentDirectoryPath 指定启动应用程序进程时的初始目录。 此属性支持宏。 有关详细信息,请参阅包清单架构中的 宏。 不能包含以下字符的可选字符串:<>|?*。 >
uap11:Parameters 此属性继承自基本扩展语法,不适用于 com4 扩展。 除了语法验证之外,此值将被忽略。 此属性支持宏。 有关详细信息,请参阅包清单架构中的 宏。 一个可选字符串,其长度在 1 到 32767 个字符之间,其开头和结尾有非空格字符。
desktop7:CompatMode 指定此扩展的信息是以经典方式(例如,通过注册表向 COM 注册类型)还是以新的更作用域的方式向 Windows 注册。 默认值为“modern”。 CompatMode=“classic”需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 可选字符串,可以具有以下值之一:经典新式
desktop7:范围 指定注册是否仅对作为已注册此包的用户运行的其他应用程序可见,或者是否对计算机上的所有用户和服务可见。 默认值为“user”。 Scope=“machine”需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 一个可选字符串,可以具有以下值之一:计算机用户

子元素

子元素 描述
证书 声明 windows.certificates类型的包扩展点。 应用需要指定证书存储中的一个或多个证书。
InProcessServer 声明 windows.activatableClass.inProcessServer类型的包扩展点。 该应用使用一个动态链接库(.dll),该库公开一个或多个可激活类。
OutOfProcessServer 声明 windows.activatableClass.outOfProcessServer类型的包扩展点。 应用使用公开一个或多个可激活类的可执行文件(.exe)。
ProxyStub 声明 windows.activatableClass.proxyStub类型的包扩展点。 代理可以由一个或多个接口组成。
PublisherCacheFolders 声明 windows.publisherCacheFolders类型的包扩展点。 这指定包与同一发布者中的其他包共享的一个或多个文件夹。
com:ComInterface 声明 windows.comInterface类型的包扩展点。
uap6:LoaderSearchPathOverride 声明 windows.loaderSearchPathOverride类型的包扩展点。

父元素

Parent 元素 描述
扩展(类型:CT_PackageExtensions) 定义包的一个或多个扩展点。

以下元素的名称与此元素相同,但内容或属性不同:

言论

扩展点是一种机制,包可以通过该机制以操作系统定义的方式添加功能。 扩展点是应用可以注册以执行代码或使用当前包的资源的位置。 若要为特定应用添加功能,请使用 Applications 元素的 Application 子元素。

windows.certificates 扩展点不能在清单中多次声明。

另请参阅

要求

项目 价值
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10
com http://schemas.microsoft.com/appx/manifest/com/windows10
uap6 http://schemas.microsoft.com/appx/manifest/uap/windows10/10