VS编译.NET MAUI项目失败，报APT2144文件路径无效错误

错误详情 #

级别 代码 描述 路径 文件 行 列 抑制状态
错误 APT2144 无效文件路径 'C:\Prakash\Git\myappMobile\myapp\myapp\obj\Debug\net7.0-android\res\values\appicon.png'。 C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\33.0.68\tools C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\33.0.68\tools\Xamarin.Android.Aapt2.targets 123 3

已尝试操作 #

• 确认该PNG文件存在于指定路径，文件资源管理器中可找到该路径
• 清理解决方案后重新生成，仍出现相同错误

解决方案建议 #

1. 修正资源目录结构 #

Android的res/values目录仅用于存放XML类资源（如字符串、样式配置），图片资源不允许放在此目录下，这是触发APT2144错误的核心原因：

• 检查项目中appicon.png的配置项，确认是否错误指定了输出到res/values目录
• 确保图片资源的生成目标路径为res/drawable或对应分辨率的drawable-xxxhdpi等专用图片目录

2. 手动调整文件与配置 #

• 手动将appicon.png从obj\Debug\net7.0-android\res\values移动到obj\Debug\net7.0-android\res\drawable目录
• 打开项目的.csproj文件，检查appicon.png的配置节点，确保格式正确（无错误的输出路径配置），示例正确配置：

<ItemGroup>
  <MauiIcon Include="Resources\AppIcon\appicon.png" ForegroundFile="Resources\AppIcon\appiconfg.png" Color="#512BD4" />
</ItemGroup>

3. 深度清理构建缓存 #

除常规清理解决方案外，执行以下操作彻底清除缓存：

• 删除项目根目录下的.vs、bin、obj三个文件夹
• 打开命令行进入项目目录，依次执行：

dotnet clean
dotnet restore

之后重新生成项目

4. 检查SDK版本兼容性 #

当前使用的Microsoft.Android.Sdk版本为33.0.68，尝试更新到同版本的最新补丁包，或升级至.NET 7 MAUI SDK的最新稳定版，规避SDK自身的路径处理bug

内容的提问来源于stack exchange，提问作者MR ᴩ ʜ ᴏ ᴇ ɴ ɪ x