MAUI应用仅能在Visual Studio运行的问题求助及机制咨询

解决方法 #

• 安装匹配版本的Windows App SDK运行时
  Microsoft.ui.xaml.dll是Windows App SDK的核心组件，Visual Studio运行时会自动关联开发环境中的运行时，但直接运行exe或VS Code不会自动加载。需要下载并安装与项目中引用的WindowsAppSDK版本完全匹配的运行时包（注意区分x64/x86/arm架构）。

• 正确配置项目的SelfContained属性
  在项目的.csproj文件中，针对Windows目标框架添加以下配置，确保生成自包含部署包：

  <PropertyGroup Condition="'$(TargetFramework)' == 'net7.0-windows10.0.19041.0'">
    <SelfContained>true</SelfContained>
    <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
    <RuntimeIdentifier>win10-x64</RuntimeIdentifier> <!-- 根据你的架构调整 -->
  </PropertyGroup>
  

  配置完成后，执行清理解决方案→重建解决方案，确保生成的输出文件包含所有依赖。

• 调整VS Code的启动配置
  在VS Code的.vscode/launch.json中，添加环境变量配置指定Windows App SDK的依赖路径，或者直接使用dotnet run命令启动项目（dotnet run会自动处理运行时依赖路径）：
  示例launch.json配置：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": ".NET MAUI Windows",
        "type": "coreclr",
        "request": "launch",
        "program": "${workspaceFolder}/bin/Debug/net7.0-windows10.0.19041.0/win10-x64/Gui.dll",
        "args": [],
        "cwd": "${workspaceFolder}",
        "env": {
          "PATH": "${env:PATH};C:\\Program Files\\WindowsApps\\Microsoft.WindowsAppSDK_1.4.231008000_x64__8wekyb3d8bbwe\\Redist\\x64\\Microsoft.UI.Xaml\\2.8.4"
        },
        "stopAtEntry": false
      }
    ]
  }
  

  注意替换路径中的Windows App SDK版本号为你实际安装的版本。

• 手动复制依赖DLL（临时方案）
  找到Windows App SDK安装目录下的Microsoft.ui.xaml.dll（通常路径为C:\Program Files\WindowsApps\Microsoft.WindowsAppSDK_<版本号>_x64__8wekyb3d8bbwe\Redist\x64\Microsoft.UI.Xaml\<版本号>），将其复制到exe所在的bin/Debug/net7.0-windows.../win10-x64目录下。

Visual Studio的DLL访问机制说明 #

• 环境变量自动配置：Visual Studio在运行MAUI项目时，会自动设置PATH等环境变量，指向Windows App SDK的Redist目录，确保程序能找到Microsoft.ui.xaml.dll这类依赖组件。
• 版本匹配校验：VS会根据项目的目标框架和WindowsAppSDK版本，自动加载对应版本的DLL，避免版本不兼容问题。
• 调试上下文注入：调试时，VS会注入特定的运行时上下文，包含项目依赖的所有组件路径，而直接运行exe或VS Code默认不会继承这些上下文配置，导致依赖查找失败。

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