SwiftUI应用iPadOS版本中CFBundleAlternateIcons无备用图标问题排查

针对你遇到的iOS正常但iPadOS上备用图标无法读取（CFBundleAlternateIcons为nil）、设置时报错的问题，结合新项目正常的现象，可从以下几个方向排查原项目的配置问题：

• 检查Info.plist的iPad专属图标配置
  部分项目会在主Info.plist中添加CFBundleIcons~ipad键，该键会单独覆盖iPadOS的图标配置。打开Info.plist（可通过文本编辑器查看源代码），如果存在这个键，确认其内部是否包含完整的CFBundleAlternateIcons配置；若无需单独配置iPad图标，直接删除该键即可。

• 核对目标构建设置的平台差异
  进入应用目标的Build Settings：

  1. 搜索Asset Catalog Compiler - Options下的Include All App Icon Assets，确保iPad平台的配置为YES（部分场景下项目级设为YES，但目标的iPad平台被单独修改为NO）。
  2. 查看Asset Catalogs下的Alternate App Icon Sets，确认所有备用图标集名称都被正确添加，且iPad平台无单独的配置偏差。

• 彻底清理构建缓存
  执行Xcode的Clean Build Folder（快捷键Cmd+Shift+K），手动删除DerivedData目录（路径可在Xcode偏好设置→Locations中找到）；卸载iPad设备/模拟器上的应用后重新构建安装，避免旧缓存干扰。

• 对比新项目与原项目的.pbxproj文件
  由于新项目配置正常，可将两个项目的.pbxproj文件对比，重点查找：

  • 备用图标集的资源引用配置，确认iPad平台的资源包含规则是否正确。
  • 是否存在针对iPad的条件编译设置，导致图标资源未被纳入iPad构建包。

• 验证Info.plist的CFBundleIcons结构完整性
  用文本编辑器打开Info.plist（右键→Open As→Source Code），检查CFBundleIcons的结构：

  • 确保CFBundlePrimaryIcon包含正确的CFBundleIconName（指向主图标集）。
  • 确认CFBundleAlternateIcons下每个备用图标条目名称与资源目录中的图标集完全一致，无拼写或大小写错误，且结构无语法问题（如标签未闭合）。

• 检查iPad构建包的Info.plist
  针对iPad构建归档并导出IPA，解压后查看包内的Info.plist，确认CFBundleAlternateIcons是否存在且配置完整。部分情况下Xcode会在构建时根据平台修改Info.plist，导致iPad版本的图标配置被意外移除。

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