Windows环境下无法构建MAUI Android/iOS/macOS项目求助

核心原因说明 #

• iOS/Mac Catalyst平台限制：苹果的iOS和Mac Catalyst开发工具链仅支持macOS环境，Windows上无法安装对应的workload，这是官方明确的平台限制，并非SDK或操作问题。
• Android workload安装失败：Windows原生支持Android workload，安装失败大概率是缓存或网络源问题。

具体解决方案 #

1. 处理iOS/Mac Catalyst构建需求

如果不需要构建这两个平台：

• 打开项目的.csproj文件，修改<TargetFrameworks>节点，移除不支持的目标框架，示例：

  <TargetFrameworks>net8.0-android;net8.0-windows10.0.19041.0</TargetFrameworks>
  

如果需要构建iOS/Mac Catalyst：

• 必须使用macOS环境，或者通过Rider的远程Mac构建功能（需搭配一台Mac设备，在Rider中配置远程构建服务器）。

2. 修复Android workload安装失败

执行以下步骤：

• 清理本地workload缓存：

  dotnet workload clean
  

• 指定x64架构安装（适配Intel 12代处理器）：

  dotnet workload install android --arch x64
  

• 若遇网络问题，切换国内NuGet源：
  编辑%USERPROFILE%\.nuget\NuGet\NuGet.Config，添加阿里云镜像：

  <configuration>
    <packageSources>
      <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
      <add key="aliyun" value="https://mirrors.aliyun.com/nuget/v3/index.json" />
    </packageSources>
  </configuration>
  

  重新执行安装命令即可。

3. 验证修复效果

运行命令确认workload状态：

dotnet workload list

确认android或maui-android已出现在已安装列表中，重新构建项目即可解决报错。

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