Wix Toolset自定义动作中WinForm高DPI适配问题求助

我之前也碰到过类似的坑——Wix自定义动作里的WinForms窗体在高DPI显示器上模糊，核心原因是自定义动作默认是在msiexec.exe进程内运行，你给自定义动作项目单独加的app.manifest根本不会生效，因为整个进程的DPI感知由msiexec说了算。下面给你几个可行的解决办法，按推荐程度排序：

1. 让窗体在独立进程中运行（最推荐） #

把显示窗体的逻辑抽成一个独立的WinForms EXE项目，给这个EXE配置正确的DPI感知，然后让Wix的自定义动作启动这个独立进程。这样窗体完全脱离msiexec的进程环境，自己的manifest就能正常生效了。

具体步骤：

• 新建一个WinForms项目，把原来的窗体逻辑移过去
• 在这个新项目里添加app.manifest，取消dpiAware部分的注释，修改成支持高DPI的配置：

  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
    </windowsSettings>
  </application>
  

  （如果用的是.NET Framework 4.7+，也可以用PerMonitorV2实现更精细的感知）
• 在Wix项目里，把这个EXE作为二进制资源引入，然后创建启动它的自定义动作：

  <!-- 引入EXE二进制 -->
  <Binary Id="MyFormExe" SourceFile="..\MyWinFormsApp\bin\Release\MyWinFormsApp.exe" />
  <!-- 定义自定义动作 -->
  <CustomAction Id="ShowCustomForm" BinaryKey="MyFormExe" ExeCommand="" Return="check" />
  <!-- 在安装序列里安排执行时机，比如在LaunchConditions之后 -->
  <InstallExecuteSequence>
    <Custom Action="ShowCustomForm" After="LaunchConditions">YOUR_CONDITION_HERE</Custom>
  </InstallExecuteSequence>
  

2. 手动在代码中处理DPI缩放（适合不想拆分进程的场景） #

如果不想单独做EXE，可以在自定义动作的窗体代码里手动处理DPI适配，尤其是用.NET Framework 4.7及以上版本的话，WinForms原生支持Per-Monitor DPI感知：

• 首先确保自定义动作项目的Target Framework设为4.7+
• 在项目的app.config里添加DPI感知配置：

  <configuration>
    <System.Windows.Forms.ApplicationConfigurationSection>
      <add key="DpiAwareness" value="PerMonitorV2" />
    </System.Windows.Forms.ApplicationConfigurationSection>
  </configuration>
  

• 在窗体代码里优化布局：
  • 把AutoScaleMode设为Dpi
  • 重写OnDpiChanged方法，手动缩放控件和字体（如果需要）
  • 确保控件的Anchor、Dock属性设置合理，避免DPI变化后布局错乱

3. 修改msiexec的全局DPI感知（不推荐） #

这个方法会改变系统中所有MSI安装包的运行环境，可能带来兼容性问题，所以仅作为最后手段：

• 修改注册表：在HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\SideBySide下新建DWORD值PreferExternalManifest，设为1
• 分别在C:\Windows\System32和C:\Windows\SysWOW64目录下创建msiexec.exe.manifest文件，内容如下：

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <application xmlns="urn:schemas-microsoft-com:asm.v3">
      <windowsSettings>
        <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
      </windowsSettings>
    </application>
  </assembly>
  

  这样msiexec会启用DPI感知，你的自定义动作窗体也会跟着适配高DPI，但会影响所有MSI安装程序，风险较高。

内容的提问来源于stack exchange，提问作者tjsmith