app.manifest 文件详解：Windows应用程序清单

🎯 什么是 app.manifest？

app.manifest 是 Windows应用程序清单文件，它是一个XML格式的配置文件，用于定义Windows应用程序如何与操作系统交互。这个文件告诉Windows系统你的应用需要哪些特性和权限，以及如何与用户账户控制(UAC)和安全机制集成。

📌 核心作用：
通过此文件，你可以控制应用程序的：

• 权限级别（如管理员权限）
• DPI感知（高清屏支持）
• 兼容性设置（针对不同Windows版本）
• 视觉样式（窗口主题等）

🧩 文件位置与基本结构

典型位置

YourProject/
├── Properties/
│   ├── app.manifest        # 主清单文件
│   └── AssemblyInfo.cs

基本XML结构

<?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="MyApplication.app"/>
  
  <!-- 关键配置区域 -->
  <trustInfo>...</trustInfo>
  <compatibility>...</compatibility>
  <application>...</application>
  <dependency>...</dependency>
</assembly>

🔑 核心配置详解

1. UAC权限控制（最重要的部分）

<trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
  <security>
    <requestedPrivileges>
      <!-- 选择以下一项 -->
      <requestedExecutionLevel 
        level="asInvoker"   <!-- 默认：继承父进程权限 -->
        uiAccess="false"/> 
        
      <requestedExecutionLevel 
        level="requireAdministrator"  <!-- 要求管理员权限 -->
        uiAccess="false"/>
        
      <requestedExecutionLevel 
        level="highestAvailable"  <!-- 尽可能获取最高权限 -->
        uiAccess="false"/>
    </requestedPrivileges>
  </security>
</trustInfo>

权限级别对比：

级别	效果	适用场景
asInvoker	继承调用者权限	常规应用程序（不需要管理员权限）
requireAdministrator	必须管理员权限	安装程序、系统工具
highestAvailable	获取可用的最高权限	混合权限需求的应用

2. Windows版本兼容性设置

<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
  <application>
    <!-- 支持的Windows版本 -->
    <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd0a9d411}" /> <!-- Windows 11 -->
    <supportedOS Id="{1f676c76-80e1-4239-95bb-83d3f94d130}" /> <!-- Windows 10 -->
    <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93}" /> <!-- Windows 8.1 -->
    <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e3}" /> <!-- Windows 8 -->
    <supportedOS Id="{1d676f76-80e1-4239-95bb-83d3f94d130}" /> <!-- Windows 7 -->
  </application>
</compatibility>

3. DPI感知配置（支持4K/高DPI屏幕）

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <!-- 支持的模式 -->
    <dpiAwareness>PerMonitorV2</dpiAwareness> <!-- Win10+ 推荐 -->
    <dpiAware>true</dpiAware>                 <!-- 传统DPI支持 -->
    
    <!-- 禁用缩放行为 -->
    <gdiScaling>false</gdiScaling> 
    <longPathAware>true</longPathAware>        <!-- 支持长路径 -->
  </windowsSettings>
</application>

4. Windows公共控件视觉样式

<dependency>
  <dependentAssembly>
    <assemblyIdentity 
        type="win32" 
        name="Microsoft.Windows.Common-Controls" 
        version="6.0.0.0" 
        processorArchitecture="*" 
        publicKeyToken="6595b64144ccf1df" 
        language="*"/>
  </dependentAssembly>
</dependency>

作用：启用现代Windows主题（而非传统的灰色窗口）

⚙️ 实际应用场景

场景1：为安装程序请求管理员权限

<requestedExecutionLevel level="requireAdministrator" uiAccess="false"/>

→ 效果：用户启动时会弹出UAC提权提示

场景2：禁用应用缩放（在高分屏上保持清晰）

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <dpiAwareness>PerMonitorV2</dpiAwareness>
    <dpiAware>true</dpiAware>
  </windowsSettings>
</application>

场景3：支持长路径（超过260字符）

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <longPathAware>true</longPathAware>
  </windowsSettings>
</application>

🛠️ 如何启用/修改app.manifest

在Visual Studio中：

1. 右键项目 → "属性"
2. 转到"应用程序"标签页
3. 点击"资源"下的"清单"下拉框
   • 选择默认清单 → VS自动生成
   • 选择现有清单 → 使用你自己的app.manifest

创建自定义清单：

1. 添加XML文件到项目
2. 命名为app.manifest
3. 粘贴标准模板
4. 在项目属性中选择此文件

⚠️ 注意事项

1. 权限最小化原则：

   • 除非必要，否则使用asInvoker
   • 避免滥用管理员权限

2. 版本兼容性：

   • 显式声明支持的Windows版本
   • 避免使用过时特性（如Windows XP专用API）

3. DPI设置：

   • 现代应用应用使用PerMonitorV2
   • Win7等旧系统使用<dpiAware>true</dpiAware>

4. 调试技巧：

   mt -manifest app.manifest -outputresource:YourApp.exe;1

   命令行重新嵌入清单

🔍 调试清单问题

问题现象	可能原因	解决方案
无UAC提示	清单未生效	检查清单是否嵌入（项目属性）
界面模糊	DPI支持禁用	启用PerMonitorV2
系统主题未应用	缺少公共控件声明	添加Common-Controls 6.0依赖

💡 总结：关键应用价值

1. 权限管理：精确控制用户账户级别需求
2. 兼容性保障：确保在目标Windows版本上正常运行
3. 显示优化：支持4K/高清屏和现代主题
4. 功能扩展：启用长路径等高级特性

📚 官方文档参考：
应用程序清单文档（Microsoft Learn）

通过正确配置app.manifest，你可以显著提升Windows应用程序的兼容性、安全性和用户体验！