MAUI应用指定Android v31目标版本失败，求助解决NETSDK1181错误

问题根源 #

.NET 8默认绑定Android API 34，仅通过Android SDK Manager安装API 31的SDK不足以支持项目编译，还需要安装对应的.NET Android绑定工作负载包，这就是触发NETSDK1181错误的核心原因。

解决方案步骤 #

• 安装API 31对应的.NET工作负载
  打开终端执行以下命令：

  dotnet workload install microsoft.net.android.ref-31
  

• 验证工作负载安装状态
  执行命令确认目标工作负载已成功安装：

  dotnet workload list
  

• 修正项目配置
  1. 打开项目的.csproj文件，确保目标框架与API级别配置正确：

     <TargetFrameworks>net8.0-android31.0</TargetFrameworks>
     <PropertyGroup>
       <TargetAndroidApiLevel>31</TargetAndroidApiLevel>
     </PropertyGroup>
     

  2. 同步AndroidManifest.xml中的配置，保证目标SDK版本一致：

     <uses-sdk android:minSdkVersion="你的最小SDK版本" android:targetSdkVersion="31" />
     

• 清理并重建项目
  执行命令清理编译缓存后重新构建：

  dotnet clean
  dotnet build
  

额外注意事项 #

• 确保你的.NET 8 SDK为最新版本，旧版本可能存在工作负载安装的兼容性问题
• 如果安装工作负载时遇到网络问题，可切换至国内NuGet镜像源后重试

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