.NET MAUI计数按钮项目在Android模拟器报APT2000：找不到指定文件

问题概述 #

在Windows Visual Studio中开发.NET MAUI的「Count Button」项目时，Windows端可正常运行，但所有API版本的Android模拟器均无法启动，构建阶段抛出错误：

1>C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\32.0.476\tools\Xamarin.Android.Aapt2.targets(212,3): error APT2000: Le fichier spécifié est introuvable. (2).

解决步骤 #

• 清理重建项目

  1. 执行「生成→清理解决方案」
  2. 执行「生成→重建解决方案」
  3. 手动删除项目根目录下的bin和obj文件夹，再重新构建项目

• 检查Android SDK组件

  1. 打开「工具→Android→Android SDK管理器」
  2. 确认目标API版本的以下组件已安装：
     • SDK Platform
     • Android SDK Build-Tools（版本需与项目依赖匹配）
     • Android SDK Command-line Tools
  3. 若组件缺失或版本不一致，完成安装/更新后重启Visual Studio

• 修复AAPT2工具

  1. 定位Android SDK的Build-Tools目录（默认路径：C:\Program Files (x86)\Android\android-sdk\build-tools）
  2. 检查对应版本目录下是否存在aapt2.exe，若缺失则重新安装对应版本的Build-Tools
  3. 可在项目.csproj文件中手动指定AAPT2路径（替换为你的实际版本号）：

     <PropertyGroup>
       <AndroidAapt2ToolPath>C:\Program Files (x86)\Android\android-sdk\build-tools\{你的Build-Tools版本}\aapt2.exe</AndroidAapt2ToolPath>
     </PropertyGroup>
     

• 排查资源文件问题

  1. 检查项目Resources目录下的所有文件（布局、图片、字符串等）
  2. 确保资源文件名符合Android规范：仅使用小写字母、数字、下划线，无空格或特殊字符
  3. 删除或修复损坏的资源文件

• 重置Android模拟器

  1. 关闭当前运行的模拟器，在AVD管理器中删除现有虚拟设备
  2. 重新创建新的AVD，选择完整系统镜像（避免快速启动镜像），确保镜像下载完整

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