.NET MAUI iOS打包：.ipa无图标及CFBundleIconName不生效问题求助

问题描述 #

在Windows系统的Visual Studio 2022中开发.NET MAUI应用，通过云端Mac环境的Transporter工具向App Store上传.ipa文件时遇到两个问题：

• 构建产物中未包含应用图标；
• Info.plist中的CFBundleIconName配置未生效。

我的配置 #

• 应用图标：所有所需尺寸的图标文件（如icon16.png、icon32.png、icon512.png等）及基础文件appicon.svg均存放于Resources\AppIcon目录，所有文件的Build Action均设置为MauiImage，.csproj中已添加配置：<MauiIcon Include="Resources\AppIcon\appicon.svg" />
• Info.plist：已添加CFBundleIconName键并设置为应用名称；
• 启动页：位于Resources/Splash/dart_splash.png的启动页可正常工作。

已尝试操作 #

• 验证所有图标尺寸及Build Action设置为MauiImage；
• 确认Info.plist中CFBundleIconName配置值正确；
• 检查.csproj中图标及启动页的引用配置；
• 在Visual Studio中无错误完成.ipa构建。

环境信息 #

• 开发系统：Windows + Visual Studio 2022；
• Mac环境：云端托管，用于构建.ipa及通过Transporter上传；
• 框架：面向iOS的.NET MAUI。

问题现象 #

1. 上传.ipa文件后，App Store中未显示应用图标；
2. 应用名称未匹配CFBundleIconName的配置值。

排查建议与解决步骤 #

1. 纠正CFBundleIconName的配置误解 #

CFBundleIconName的作用是指定Asset Catalog中图标集的名称（默认是AppIcon），并非应用名称。应用显示名称需要配置CFBundleDisplayName，Bundle内部名称配置CFBundleName。请将Info.plist中的CFBundleIconName值改为AppIcon（与默认图标集名称一致），示例配置：

<key>CFBundleIconName</key>
<string>AppIcon</string>

2. 修复.csproj中的图标配置 #

.NET MAUI依赖MauiIcon配置生成iOS所需的Asset Catalog，需确保配置正确：

• 将主图标svg的Build Action改为MauiIcon（而非MauiImage）；
• 手动添加的png图标文件Build Action设置为None（避免与自动生成的图标冲突）；
• 完善.csproj中的MauiIcon配置，确保包含生成规则，示例：

<MauiIcon Include="Resources\AppIcon\appicon.svg" 
          ForegroundFile="Resources\AppIcon\appicon.svg"
          Color="#512BD4" /> <!-- 可选：设置图标主色调 -->

3. 验证Asset Catalog生成结果 #

构建完成后，解压.ipa文件，进入Payload/[你的应用名].app目录，检查是否存在Assets.car文件。可使用Asset Catalog查看工具（如Asset Catalog Tinkerer）打开该文件，确认其中包含所有iOS所需尺寸的应用图标。

4. 检查云端Mac的Xcode版本 #

.NET MAUI对Xcode版本有严格要求：

• .NET 7需Xcode 14.3或更高版本；
• .NET 8需Xcode 15或更高版本；
  请确认云端Mac的Xcode版本符合当前使用的.NET MAUI框架要求，旧版本Xcode可能无法正确处理MauiIcon的自动生成逻辑。

5. 清理缓存并重新构建 #

• 在Visual Studio中清理解决方案，删除本地bin和obj目录；
• 远程清理云端Mac的构建缓存（通常可通过构建工具的清理选项实现）；
• 重新构建iOS发行版，确保构建过程无警告或错误。

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