应用程序清单

应用程序清单（也称为并行应用程序清单或 融合 清单）是一个 XML 文件，用于描述和标识应用程序应在运行时绑定到的共享和专用并行程序集。 这些应与用于测试应用程序的程序集版本相同。 应用程序清单还可能描述应用程序专用的文件的元数据。

有关 XML 架构的完整列表，请参阅 清单文件架构。

应用程序清单具有以下元素和属性。

文件位置

如果可能，应将应用程序清单作为资源嵌入应用程序 .exe 文件或 .dll. 如果无法执行此作，则可以将应用程序清单文件放置在与 .exe 或 .dll相同的目录中。

有关详细信息，请参阅 安装并行程序集。

文件名

按照约定，应用程序清单应具有与应用的可执行文件相同的名称，扩展名 .manifest 将追加到其中。

例如，引用example.exe或example.dll应使用以下文件名语法的应用程序清单（如果资源 ID 为 1，则可以省略<语法的资源 ID> 段）。

example.exe。<资源 ID>。清单

example.dll。<资源 ID>。清单

元素

元素和属性的名称区分大小写。 元素和特性的值不区分大小写，类型特性的值除外。

集会

容器元素。 其第一个子元素必须是 noInherit 或 assemblyIdentity 元素。 必填。

程序集元素必须位于命名空间urn:schemas-microsoft-com:asm.v1中。 程序集的子元素还必须通过继承或标记在此命名空间中。

程序集元素具有以下属性。

noInherit

在应用程序清单中包含此元素，以设置从清单生成的 激活上下文 ，并带有“no inherit”标志。 如果未在激活上下文中设置此标志，并且激活上下文处于活动状态，则会由同一进程、窗口、窗口过程和 异步过程调用中的新线程继承。 设置此标志可防止新对象继承活动上下文。

noInherit 元素是可选的，通常省略。 大多数程序集不能正确使用无继承激活上下文，因为程序集必须显式设计为管理其自己的激活上下文的传播。 noInherit 元素的使用要求应用程序清单引用的任何依赖程序集在其程序集清单中都有 noInherit 元素。

如果在清单中使用 noInherit ，则它必须是 程序集 元素的第一个子元素。 assemblyIdentity 元素应紧接在 noInherit 元素之后。 如果未使用 noInherit，assemblyIdentity 必须是程序集元素的第一个子元素。 noInherit 元素没有子元素。 它不是 程序集清单中的有效元素。

assemblyIdentity

作为 程序集 元素的第一个子元素， assemblyIdentity 描述并唯一标识拥有此应用程序清单的应用程序。 作为 dependentAssembly 元素的第一个子元素， assemblyIdentity 描述了应用程序所需的并行程序集。 请注意，应用程序清单中引用的每个程序集都需要与所引用程序集自己的程序集清单中的 assemblyIdentity 完全匹配的 assemblyIdentity。

assemblyIdentity 元素具有以下属性。 它没有子元素。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
 ...
<dependency>
   <dependentAssembly>
      <assemblyIdentity
          type="win32"
          name="Microsoft.Windows.Common-Controls"
          version="6.0.0.0"
          processorArchitecture="*"
          publicKeyToken="6595b64144ccf1df"
          language="*"
       />
   </dependentAssembly>
</dependency>
...
</assembly>

兼容性

包含至少一个 应用程序。 它没有属性。 可选。 应用程序清单没有兼容性元素，默认为 Windows 7 上的 Windows Vista 兼容性。

兼容性元素必须位于命名空间urn:schemas-microsoft-com:compatibility.v1中。 兼容性的子元素也必须在此命名空间中，通过继承或标记。

应用程序

包含至少一个 受支持的OS 元素。 从 Windows 10 版本 1903 开始，它还可以包含一个可选的 maxversiontested 元素。 它没有属性。 可选。

supportedOS

支持的OS 元素具有以下属性。 它没有子元素。

maxversiontested

maxversiontested 元素指定应用程序从应用程序支持的最低作系统版本开始测试的 Windows 版本，最高版本。 可在 此处找到完整的版本集。 这供使用 XAML 岛 且未部署在 MSIX 包中的桌面应用程序使用。 Windows 10 版本 1903 及更高版本中支持此元素。

maxversiontested 元素具有以下属性。 它没有子元素。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
...
    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
        <application>
            <!-- Windows 10, version 1903 -->
            <maxversiontested Id="10.0.18362.1"/>
            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
        </application>
    </compatibility>
...
</assembly>

屬地

至少包含一个 dependentAssembly。 它没有属性。 可选。

dependentAssembly

dependentAssembly 的第一个子元素必须是一个 assemblyIdentity 元素，用于描述应用程序所需的并行程序集。 每个 dependentAssembly 必须正好位于一个 依赖项内。 它没有属性。

文件

指定应用程序专用的文件。 可选。

文件元素具有下表中显示的属性。

activatableClass

允许非打包桌面应用使用用户定义的 Windows 运行时 （WinRT） 组件。 Windows 10 版本 1903 及更高版本中支持此元素。 有关详细信息，请参阅 本文。

activatableClass 元素必须位于命名空间urn:schemas-microsoft-com:winrt.v1中。

activatableClass 元素具有以下属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
...
<file name="WinRTComponent.dll">
    <activatableClass
        name="WinRTComponent.MessageHolder"
        threadingModel="both"
        xmlns="urn:schemas-microsoft-com:winrt.v1"
     />
</file>
...
</assembly>

activeCodePage

在 Windows 10 上，此元素强制进程使用 UTF-8 作为进程代码页。 有关详细信息，请参阅 “使用 UTF-8 代码”页。 在 Windows 10 上， activeCodePage 的唯一有效值为 UTF-8。

从 Windows 11 开始，此元素还允许选择旧版非 UTF-8 代码页，或选择特定区域设置的代码页，以便实现旧应用程序兼容性。 强烈建议新式应用程序使用 Unicode。 在 Windows 11 上， activeCodePage 也可以设置为 旧 版或区域设置名称，例如 en-US 或 ja-JP。

• 在配置为 UTF-8 系统活动代码页的计算机上， 旧版 会将进程还原到系统区域设置代码页。 如果系统区域设置没有定义的代码页，则将使用 Windows-1252/437。 旧版代码页设置仅在 Fusion 清单中受支持，并且仅从 Windows 11 开始。
• 提供区域设置名称（如 en-US ）时，将为该区域设置代码页适当地设置进程代码页。 例如，en-US的 Windows-1252 和 437，ja-JP为 932。

此元素首次添加到 Windows 10 版本 1903（2019 年 5 月更新）。 可以在早期 Windows 版本上声明此属性和目标/运行，但必须像往常一样处理旧代码页检测和转换。 此元素没有属性。

以下示例演示如何使用此元素强制当前进程使用 UTF-8 作为进程代码页。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2019/WindowsSettings"> 
      <activeCodePage>UTF-8</activeCodePage> 
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

autoElevate

指定是否启用自动提升。 TRUE 表示它已启用。 它没有属性。 可执行文件必须由 Windows 发布服务器进行数字签名。 供内部使用。

disableTheming

指定是否禁用为 UI 元素提供主题。 TRUE 表示已禁用。 它没有属性。

disableWindowFiltering

指定是否禁用窗口筛选。 TRUE 禁用窗口筛选，以便可以从桌面枚举沉浸式窗口。 disableWindowFiltering 已添加到 Windows 8 中，没有属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2011/WindowsSettings">
      <disableWindowFiltering>true</disableWindowFiltering>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

dpiAware

指定当前进程是否为每英寸点（dpi）感知。

Windows 10 版本 1607： 如果 dpiAwareness 元素存在，则忽略 dpiAware 元素。 如果要为 Windows 10 版本 1607 指定与早期版本的作系统不同的行为，则可以在清单中包含这两个元素。

下表描述了基于 dpiAware 元素的存在及其包含的文本导致的行为。 元素中的文本不区分大小写。

有关 dpi 感知设置的详细信息，请参阅 Windows 上的高 DPI 桌面应用程序开发。

dpiAware 没有属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">
      <dpiAware>true</dpiAware>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

dpiAwareness

指定当前进程是否为每英寸点（dpi）感知。

支持 dpiAwareness 元素的作系统的最低版本为 Windows 10 版本 1607。 对于支持 dpiAwareness 元素的版本， dpiAwareness 将替代 dpiAware 元素。 如果要为 Windows 10 版本 1607 指定与早期版本的作系统不同的行为，则可以在清单中包含这两个元素。

dpiAwareness 元素可以包含单个项或逗号分隔项的列表。 在后一种情况下，将使用作系统识别的列表中的第一个（最左）项。 通过这种方式，可以指定将来 Windows作系统版本支持的不同行为。

下表描述了基于 dpiAwareness 元素的存在及其最左侧识别项中包含的文本导致的行为。 元素中的文本不区分大小写。

有关此元素支持的 dpi 感知设置的详细信息，请参阅 DPI_AWARENESS 和 DPI_AWARENESS_CONTEXT。

dpiAwareness 没有属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">
      <dpiAwareness>PerMonitorV2, unaware</dpiAwareness>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

gdiScaling

指定是否启用 GDI 缩放。 支持 gdiScaling 元素的作系统的最低版本是 Windows 10 版本 1703。

GDI（图形设备接口）框架可以按监视器对基元和文本应用 DPI 缩放，而无需更新应用程序本身。 这对于不再主动更新 GDI 应用程序非常有用。

此元素无法缩放非矢量图形（如位图、图标或工具栏）。 此外，应用程序动态构造的位图中出现的图形和文本也不能由此元素缩放。 有关详细信息，请参阅 改进基于 GDI 的桌面应用中的高 DPI 体验。

可以通过使用DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED值调用 SetThreadDpiAwarenessContext 或 SetProcessDpiAwarenessContext 函数以编程方式更改此设置。

TRUE 表示已启用此元素。 它没有属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2017/WindowsSettings">
      <gdiScaling>true</gdiScaling>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

highResolutionScrollingAware

指定是否启用高分辨率滚动感知。 TRUE 表示它已启用。 它没有属性。

longPathAware

启用长度超过 MAX_PATH 的长路径。 Windows 10 版本 1607 及更高版本中支持此元素。 有关详细信息，请参阅 本文。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns:ws2="http://schemas.microsoft.com/SMI/2016/WindowsSettings">
      <ws2:longPathAware>true</ws2:longPathAware>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

printerDriverIsolation

指定是否启用打印机驱动程序隔离。 TRUE 表示它已启用。 它没有属性。 打印机驱动程序隔离使打印机驱动程序能够在独立于打印后台处理程序运行的进程中运行，从而提高 Windows 打印服务的可靠性。 支持在 Windows 7 和 Windows Server 2008 R2 中启动的打印机驱动程序隔离。 应用可以在其应用清单中声明打印机驱动程序隔离，以将自身与打印机驱动程序隔离，并提高其可靠性。 也就是说，如果打印机驱动程序出错，应用不会崩溃。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2011/WindowsSettings">
      <printerDriverIsolation>true</printerDriverIsolation>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

ultraHighResolutionScrollingAware

指定是否启用超高分辨率滚动感知。 TRUE 表示它已启用。 它没有属性。

msix

指定具有当前应用程序外部位置的包的标识信息（请参阅 通过外部位置打包来授予包标识）。 Windows 10 版本 2004 及更高版本中支持此元素。

msix 元素必须位于命名空间urn:schemas-microsoft-com:msix.v1中。 它具有下表中显示的属性。

<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
  <assemblyIdentity version="1.0.0.0" name="Contoso.PhotoStoreApp"/>
  <msix xmlns="urn:schemas-microsoft-com:msix.v1"
          publisher="CN=Contoso"
          packageName="ContosoPhotoStore"
          applicationId="ContosoPhotoStore"
        />
</assembly>

heapType

替代 要使用的 Win32 堆 API 的默认堆 实现。

• 值 SegmentHeap 指示将使用段堆。 段堆是一种新式堆实现，通常会减少总体内存使用量。 Windows 10 版本 2004（内部版本 19041）及更高版本中支持此元素。
• 将忽略所有其他值。

此元素没有属性。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2020/WindowsSettings">
      <heapType>SegmentHeap</heapType>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

supportedArchitectures

对于仅限 IL 的 .NET Framework 可执行文件，指定应用程序兼容的本机处理器体系结构列表。 可以包含以下一个或多个值，用空格分隔：

• amd64
• arm64

此元素没有属性。

Windows 11 版本 24H2 及更高版本中支持此元素。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
 ...
  <asmv3:application>
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2024/WindowsSettings">
      <supportedArchitectures>amd64 arm64</supportedArchitectures>
    </asmv3:windowsSettings>
  </asmv3:application>
 ...
</assembly>

trustInfo

所有符合 UAC 的应用都应将请求的执行级别添加到应用程序清单。 请求的执行级别指定应用所需的权限。 有关详细信息，请参阅 “用户帐户控制”（UAC）如何影响应用程序。

请求的执行级别是使用 trustInfo 元素的 requestedExecutionLevel 子代的 level 属性指定的。 允许的级别值为：

设置级别 highestAvailable 以确保应用程序成功与属于管理员组成员的用户和未运行的用户一起运行。 如果应用程序只能对系统具有管理访问权限，则使用请求的执行级别 requireAdministrator 标记应用，以确保系统将此程序标识为管理应用并执行必要的提升步骤。

默认情况下，Visual C++链接器将 UAC 片段嵌入到具有执行级别的 asInvoker应用程序的清单中。

requestedExecutionLevel 元素还具有可选的属性 uiAccess。 如果希望应用程序绕过用户界面保护级别，并将输入驱动到桌面上的更高权限窗口，请将其设置为此值 true 。 将此属性设置为 true 仅适用于用户界面辅助功能应用程序。 默认为 false。 可能会应用安全策略设置的其他限制，请参阅 “用户帐户控制：仅提升安装在安全位置的 UIAccess 应用程序”。 有关详细信息，请参阅 辅助技术的安全注意事项。

指定 requestedExecutionLevel 节点将禁用文件和注册表虚拟化。 如果要利用文件和注册表虚拟化实现向后兼容性，则省略 requestedExecutionLevel 节点。

<trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
  <security>
    <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
      <requestedExecutionLevel level="asInvoker" uiAccess="false" />
    </requestedPrivileges>
  </security>
</trustInfo>

示例

下面是名为 MySampleApp.exe的应用程序的应用程序清单的示例。 应用程序使用 SampleAssembly 并行程序集。

<?xml version="1.0" encoding="UTF-8"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity type="win32" name="MyOrganization.MyDivision.MySampleApp" version="6.0.0.0" processorArchitecture="*" />
   <dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32" name="Proseware.Research.SampleAssembly" version="6.0.0.0" processorArchitecture="*" publicKeyToken="0000000000000000" />
      </dependentAssembly>
   </dependency>
   <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
      <application>
         <!-- Windows 10 and Windows 11 -->
         <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
         <!-- Windows 8.1 -->
         <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />
         <!-- Windows 8 -->
         <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />
         <!-- Windows 7 -->
         <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />
         <!-- Windows Vista -->
         <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />
      </application>
   </compatibility>
</assembly>