.NET MAUI Android发布报错XA5300：无法找到Android SDK目录

原因分析 #

部署测试手机正常说明Visual Studio已正确配置Android SDK路径，但dotnet publish命令行环境未读取到该配置，导致无法定位SDK目录。

解决方案 #

1. 手动指定SDK路径 #

在发布命令中添加/p:AndroidSdkDirectory参数，直接指定本地SDK的实际路径，示例：

dotnet publish -f:net6.0-android -c:Release /p:AndroidSdkDirectory="C:\Program Files (x86)\Android\android-sdk"

路径需替换为你本地Android SDK的真实安装位置，可在VS的SDK管理器中查看该路径

2. 配置系统环境变量 #

将Android SDK根目录添加到系统环境变量ANDROID_SDK_ROOT：

• 打开「系统属性」→「高级」→「环境变量」
• 在系统变量中新建ANDROID_SDK_ROOT，值设置为SDK根目录（如C:\Program Files (x86)\Android\android-sdk）
• 重启命令行窗口后重新执行发布命令

3. 检查项目配置 #

确认项目.csproj文件中指定的目标SDK版本与已安装的版本一致，示例：

<PropertyGroup>
  <TargetFramework>net6.0-android</TargetFramework>
  <AndroidSdkPlatform>31</AndroidSdkPlatform>
</PropertyGroup>

4. 修复.NET MAUI工作负载 #

如果dotnet环境未正确关联Android SDK，可重新安装MAUI Android工作负载：

dotnet workload install maui-android

内容的提问来源于stack exchange，提问作者Juan Pablo Gomez