Windows下的清单文件，C++项目嵌入清单文件作用

森明帮大于黑虎帮

已于 2024-02-27 15:42:47 修改

阅读量1.1k

点赞数 24

分类专栏： Windows下的api C++ 文章标签： windows c++ 开发语言

于 2024-02-27 15:35:59 首次发布

本文链接：https://blog.csdn.net/qq_44918090/article/details/136323606

版权

C++ 同时被 2 个专栏收录

147 篇文章 175 订阅

订阅专栏

Windows下的api

14 篇文章 0 订阅

订阅专栏

文章目录

1、清单文件的定义和作用
2、C++程序嵌入清单文件的作用
3、举个例子关于C++清单文件

1、清单文件的定义和作用

清单文件（Manifest File）在Windows应用程序开发中扮演着重要的角色。它是一个XML格式的文件，为应用程序提供了一种方式来声明其所需的系统资源和权限，以及其他一些配置信息。清单文件可以被嵌入到应用程序的可执行文件中，或者作为一个外部文件与应用程序一起分发。

定义：
- 清单文件是一个XML文档，它描述了应用程序的元数据和配置信息。这包括应用程序的依赖项（如DLL库），所需的系统权限，兼容性信息，以及应用程序如何与操作系统交互的细节。
作用：
- 权限请求：通过清单文件，应用程序可以请求所需的用户权限级别，如管理员权限。这对于需要访问系统资源或执行特定操作的应用程序尤其重要。
- 依赖管理：清单可以声明应用程序的依赖组件，确保正确版本的组件被加载。
  应用程序兼容性：通过指定兼容的操作系统版本，清单文件可以帮助确保应用程序在不同版本的Windows上能够正确运行。
- 视觉样式和行为：清单文件可以用来启用特定的视觉样式，如Windows XP视觉风格，或配置DPI感知行为。
- 安全性：清单文件还可以被用来提高应用程序的安全性，例如，通过指定安全级别或请求的执行级别。
清单文件使得应用程序开发者能够更精确地控制应用程序的行为和系统交互方式，从而提供更好的用户体验和应用程序性能。在现代Windows应用程序开发中，正确使用清单文件是非常重要的一部分。

2、C++程序嵌入清单文件的作用

在C++程序中，嵌入清单文件的主要目的是确保程序在Windows操作系统上以预期的方式运行。这包括：
- 确保兼容性：通过声明支持的Windows版本，可以减少在不同版本的Windows上运行时可能遇到的兼容性问题。
- 控制用户权限需求：程序可以明确需要的权限级别，如请求管理员权限，这对于执行需要提升权限的操作至关重要。
- 启用现代UI特性：启用系统主题和DPI感知，提供更好的用户体验。
- 避免DLL地狱：通过指定依赖的精确版本，避免因加载错误版本的DLL而导致的程序崩溃或行为异常。
嵌入清单文件是现代C++程序开发的一个重要实践，它有助于提高程序的可用性、兼容性和安全性。在Visual Studio等现代开发环境中，通常提供了工具和选项来自动处理清单文件的嵌入过程，简化了开发者的工作。

3、举个例子关于C++清单文件

<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'>
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
    <security>
      <requestedPrivileges>
        <requestedExecutionLevel level='requireAdministrator' uiAccess='false' />
      </requestedPrivileges>
    </security>
  </trustInfo>
  <asmv3:application xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
    <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">
      <dpiAware>false</dpiAware>
    </asmv3:windowsSettings>
  </asmv3:application>

	<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">   
	 <application>   
	 <!-- Windows 10 -->   
	 <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>  
	 <!-- Windows 8.1/Windows Blue/Server 2012 R2 -->  
	 <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}"/>  
	 <!-- Windows Vista/Server 2008 -->  
	<supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}"/>   
	<!-- Windows 7/Server 2008 R2 -->  
	<supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}"/>  
	<!-- Windows 8/Server 2012 -->  
	<supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>  
	</application>   
	</compatibility> 
</assembly>

这个XML文件是一个应用程序清单文件，它用于Windows操作系统，提供了关于应用程序的元数据。具体到这个文件，它定义了以下几个重要的配置：
- 请求管理员权限：通过这一行，清单文件指示操作系统，该应用程序需要以管理员权限运行。这通常用于那些需要访问系统级资源或执行需要更高权限的操作的应用程序。当设置为requireAdministrator时，如果用户账户控制（UAC）在Windows中启用，操作系统会在程序启动时提示用户提升权限。uiAccess="false"意味着该程序没有申请使用UI自动化权限，这是辅助技术（如屏幕阅读器）使用的一种特殊权限。
- DPI感知配置：通过false这一行，清单文件告知操作系统，该应用程序不支持高DPI（每英寸点数）设置。DPI感知是指应用程序能够根据显示器的DPI设置自适应其用户界面的能力。当设置为false时，表示应用程序不会根据高DPI设置调整其用户界面，而是依赖于操作系统来自动缩放界面以适应高分辨率显示器。这可能导致界面在高DPI显示器上显示模糊。
- Windows 6.0 Style：这部分指定了应用程序依赖的Windows公共控件库的版本。通过指定Microsoft.Windows.Common-Controls版本为6.0.0.0，这使得应用程序能够使用Windows Vista及之后版本的视觉样式。这对于确保应用程序在较新的Windows版本上具有现代外观和感觉非常重要。
- 兼容性声明：compatibility部分声明了应用程序支持的Windows操作系统版本。它通过多个supportedOS元素列出了从Windows Vista到Windows 10的各个Windows版本的支持。这有助于操作系统为应用程序提供最佳的兼容性支持，包括启用特定版本的操作系统特性或兼容性修补。
此清单文件的配置显示了一个需要管理员权限运行且未声明为DPI感知的应用程序，同时它声明了对多个Windows版本的兼容性支持。这样的配置通常用于需要高权限操作的应用程序，并且可能需要在不同的Windows版本上运行，但它可能不会在高DPI显示设备上提供最佳的用户体验。

设置false可能会引起一些问题，特别是在高DPI（每英寸点数）显示器上运行应用程序时。这个设置告诉Windows，你的应用程序不是DPI感知的，也就是说，它不会根据用户的屏幕DPI设置自动调整其用户界面。这会导致几个潜在的问题：

界面模糊：最常见的问题是，应用程序的用户界面可能会在高DPI设置下显示模糊。这是因为Windows会自动缩放不支持高DPI的应用程序，以适应用户的屏幕分辨率，而这种缩放可能会导致图形和文本的模糊。
用户体验不佳：对于期望在现代显示器上获得清晰和精确显示的用户来说，模糊的界面可能会导致不良的用户体验。
布局问题：自动缩放可能还会干扰应用程序界面的布局，导致控件错位或不按预期显示。

为了避免这些问题，现代应用程序开发中推荐使用true或更高级的DPI感知设置（例如，通过指定具体的DPI感知版本或使用PerMonitorV2设置），以确保应用程序可以清晰地显示在各种DPI设置下，同时也能提供更好的用户体验。这要求开发者在设计和测试应用程序时考虑不同的DPI环境，确保用户界面元素可以适应不同的屏幕分辨率和缩放级别。

在Windows应用程序的清单文件中，标签用于指定应用程序对高DPI（每英寸点数）显示器的支持程度。这对于确保应用程序在不同分辨率的屏幕上能够正确显示，特别是在高分辨率显示设备上，非常重要。这里解释一下true和PerMonitorV2的作用：

true：
- 当设置为true时，表示应用程序是DPI感知的，并且会在系统级别被缩放，以匹配系统的DPI设置。这意味着应用程序在启动时会根据系统的DPI设置进行一次性缩放，以适应屏幕的高分辨率。
- 但是，这种方法有个限制：应用程序启动后，如果移动到具有不同DPI设置的第二显示器上，它不会自动调整其DPI缩放。应用程序的UI元素大小和缩放级别将保持不变，可能导致在新显示器上显示不正确。
PerMonitorV2：
- PerMonitorV2是一种更高级的DPI感知模式，它允许应用程序在每个监视器的基础上动态调整其DPI缩放。这意味着，如果一个应用程序从一个显示器拖动到另一个具有不同DPI设置的显示器，应用程序能够自动检测这一变化，并实时调整其UI元素的大小和缩放级别以适应新的DPI。
- 使用PerMonitorV2模式可以提供更好的用户体验，尤其是在多显示器环境中，每个显示器的分辨率和DPI设置可能不同。这使得应用程序能够在不同的显示环境中保持清晰和适当比例的UI。
- 总的来说，使用PerMonitorV2可以为用户提供更加精细和适应性强的界面显示效果，特别是在多显示器设置中，每个显示器可能有不同的分辨率和DPI设置。而true虽然使应用程序在单一显示器环境中表现良好，但在多显示器或动态DPI变化的环境中可能不够灵活。因此，对于新开发的应用程序，推荐使用PerMonitorV2来提升用户体验。