MAUI打包APK前Release重建遇资源缺失及Controls命名空间错误求助

问题概述 #

在MAUI应用以Release模式重建准备打包APK时，遇到三类错误：

• APT2067：清单处理失败
• APT2260：找不到mipmap/appicon和mipmap/appicon_round资源
• CS0246：找不到'Controls'命名空间（使用Controls.UserDialogs.Maui组件）

已尝试操作：

• 在Platforms/Android/Resources/mipmap下添加对应图标
• 升级Controls.UserDialogs.Maui至1.5.0版本
• 将.NET版本从7升级到8
• 更换Visual Studio版本（17.9.0 Preview 1.0和17.8.1）
  新建演示项目无此问题，但现有项目问题未解决。

针对APT2260和APT2067错误（图标资源及清单问题） #

1. 检查图标文件生成操作
   进入Platforms/Android/Resources/mipmap目录，选中所有appicon相关文件，在属性窗口中确保：

   • 生成操作设置为AndroidResource
   • 复制到输出目录设置为如果较新则复制

2. 验证AndroidManifest.xml的图标引用
   打开Platforms/Android/AndroidManifest.xml，确认<application>标签中的属性值：

   <application android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" ...>
   

   检查拼写是否完全匹配（Android资源文件名大小写敏感，需全小写）。

3. 彻底清理并重建项目
   执行以下步骤：

   • 右键项目 → 清理
   • 删除项目根目录下的bin和obj文件夹
   • 重启Visual Studio后，再以Release模式重建

4. 检查资源目录结构
   确保mipmap目录下包含所有密度子目录（如mipmap-mdpi、mipmap-hdpi、mipmap-xhdpi等），且每个子目录下都有对应的appicon.png和appicon_round.png文件。

针对CS0246错误（Controls命名空间找不到） #

1. 确认组件引用范围
   右键项目 → 管理NuGet程序包，确保Controls.UserDialogs.Maui已安装到所有项目目标框架（包括net8.0-android等），而非仅共享项目。

2. 检查命名空间与项目文件配置

   • 在使用UserDialogs的代码文件中，添加引用：using Controls.UserDialogs.Maui;
   • 若仍报错，手动在项目文件（.csproj）中添加以下配置：

     <ItemGroup>
       <PackageReference Include="Controls.UserDialogs.Maui" Version="1.5.0" />
     </ItemGroup>
     

3. 验证MAUI初始化配置
   打开MauiProgram.cs，确认已添加UserDialogs的初始化代码：

   builder.UseMauiApp<App>().UseUserDialogs();
   

4. 检查目标框架一致性
   确保所有平台项目（如Android）的目标框架与组件兼容，.NET 8需确认组件版本（1.5.0已支持.NET 8）无兼容性遗漏。

额外排查步骤 #

由于新建演示项目无此问题，可通过对比排查差异：

• 对比现有项目与演示项目的.csproj文件，重点看资源配置、NuGet引用、目标框架等部分
• 复制演示项目中的Platforms/Android/Resources目录结构及图标文件到现有项目，覆盖后重试
• 检查现有项目是否存在自定义资源配置或清单修改，导致资源引用冲突

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