VS Code调试.NET 8 MAUI iOS模拟器应用失败求助

问题核心 #

VS Code调试.NET 8 MAUI iOS模拟器应用时，出现libhostpolicy.dylib缺失错误，调试器误将应用按自包含模式启动，且当前调试配置未适配MAUI iOS的打包运行逻辑。

解决方案 #

1. 修正launch.json调试配置 #

MAUI iOS应用需启动.app包内的原生可执行文件，而非直接运行DLL，调整配置如下：

{
    "version": "0.2.0",
    "configurations": [
      {
        "name": ".NET MAUI iOS Simulator",
        "type": "coreclr",
        "request": "launch",
        "preLaunchTask": "build",
        // 指向.app包内的可执行文件
        "program": "${workspaceFolder}/bin/Debug/net8.0-ios/iossimulator-arm64/TIMS.app/TIMS",
        "args": [],
        "cwd": "${workspaceFolder}/bin/Debug/net8.0-ios/iossimulator-arm64",
        "stopAtEntry": false,
        "env": {
          "ASPNETCORE_ENVIRONMENT": "Development"
        },
        "sourceFileMap": {
          "/Views": "${workspaceFolder}/Views"
        }
      }
    ]
  }

2. 调整tasks.json构建参数 #

移除手动指定的RID参数，让MSBuild自动处理模拟器运行时标识：

{
    "version": "2.0.0",
    "tasks": [
      {
        "label": "build",
        "command": "dotnet",
        "type": "process",
        "args": [
          "build",
          "${workspaceFolder}/TIMS.csproj",
          "-f", "net8.0-ios",
          "-c", "Debug"
        ],
        "problemMatcher": "$msCompile"
      }
    ]
  }

3. 改用dotnet run启动调试（可选） #

直接通过dotnet run命令处理MAUI iOS的启动流程，无需手动指定路径：

{
    "version": "0.2.0",
    "configurations": [
      {
        "name": ".NET MAUI iOS Simulator",
        "type": "coreclr",
        "request": "launch",
        "command": "dotnet",
        "args": [
          "run",
          "--project", "${workspaceFolder}/TIMS.csproj",
          "-f", "net8.0-ios",
          "-c", "Debug",
          "--",
          "--device", ":v2:udid=<你的模拟器UDID>"
        ],
        "cwd": "${workspaceFolder}",
        "stopAtEntry": false,
        "env": {
          "ASPNETCORE_ENVIRONMENT": "Development"
        }
      }
    ]
  }

可通过xcrun simctl list devices命令获取模拟器UDID。

4. 清理重建项目 #

执行以下命令清除缓存并重新构建：

dotnet clean
dotnet restore
dotnet build -f net8.0-ios -c Debug

5. 验证环境兼容性 #

• 确保.NET 8 SDK为最新稳定版（建议8.0.400+）
• 确认Xcode 15.4与项目中Microsoft.iOS版本（17.5.8020）兼容

错误原因说明 #

报错本质是调试器错误地直接运行DLL文件，而MAUI iOS应用在模拟器中是以.app包形式存在的原生可执行程序，无法通过DLL直接启动。runtimeconfig.json中的tfm字段是.NET 8的标准格式，并非问题根源。

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