升级MonoGame至3.8.2后单文件发布构建失败问题咨询

调整项目配置 #

修改项目文件为以下内容，可同时实现单文件发布、ReadyToRun优化及Windows x64专属打包：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <DisableWinExeOutputInference>true</DisableWinExeOutputInference>
    <TargetFramework>net8.0-windows</TargetFramework>
    <UseWindowsForms>true</UseWindowsForms>
    <Platforms>x64</Platforms>
    <PublishSingleFile>true</PublishSingleFile>
    <SelfContained>true</SelfContained>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <PublishReadyToRun>true</PublishReadyToRun>
    <TieredCompilation>false</TieredCompilation>
    <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
    <PublishTrimmed>false</PublishTrimmed>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="MonoGame.Framework.WindowsDX" Version="3.8.2.1105" />
  </ItemGroup>
</Project>

关键配置说明 #

• <SelfContained>true</SelfContained>：切换为自包含发布模式，将.NET运行时及所有依赖库打包进单文件，避免依赖系统端的.NET环境，直接解决hostfxr.dll不支持单文件嵌入的问题。
• <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>：确保MonoGame依赖的DirectX等原生库被正确嵌入单文件包，运行时自动提取使用。
• 明确指定<RuntimeIdentifier>win-x64</RuntimeIdentifier>：移除多运行时标识，消除打包歧义，确保仅针对Windows x64环境构建产物。

验证步骤 #

1. 执行生成 > 清理解决方案，清除旧构建缓存
2. 进入发布配置，选择文件夹目标，确认运行时为win-x64，勾选单文件和ReadyToRun编译选项
3. 运行发布后的Game.exe，验证启动正常

MonoGame 3.8.2.1105的依赖处理逻辑相比3.8.1.303有调整，当启用非自包含发布（<SelfContained>false</SelfContained>）同时开启单文件/ReadyToRun/指定RuntimeIdentifier时，打包工具会错误地将hostfxr.dll这类不支持单文件嵌入的运行时文件打包进去，触发运行报错。切换为自包含发布后，完整的.NET运行时会被整合到单文件中，规避了该兼容性冲突。

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