Swift开发iOS应用iPad真机图标不显示但模拟器正常问题求助

问题根因 #

该问题是Xcode 13.x + iOS 15.x版本组合下的已知资产编译+系统缓存双重bug，结合你提到的Include all app icon assets选项关联表现，核心触发点有三个：

1. Xcode 13的资产编译增量构建缓存存在失效问题，即使回退代码，本地残留的构建缓存未被正常清理，会持续污染后续构建产物
2. iOS 15.0-15.1的系统图标缓存存在逻辑缺陷，安装新应用包时不会强制覆盖旧图标缓存，即使应用包内图标正确，系统仍会读取旧的占位缓存展示
3. Xcode 13的图标资源裁剪逻辑存在误判，当Include all app icon assets设为NO时，会错误裁剪部分iPad/iPhone所需的专属尺寸图标，导致不同设备表现不一致

可复现的稳定解决方案 #

按以下优先级执行操作即可完全解决：

1. 彻底清理Xcode本地缓存 #

关闭Xcode后在终端执行以下两条命令，完全清除残留的衍生数据和编译缓存：

rm -rf ~/Library/Developer/Xcode/DerivedData
rm -rf ~/Library/Caches/com.apple.dt.Xcode

重启Xcode打开项目后，按住Option键点击顶部菜单栏Product -> Clean Build Folder，确保所有历史构建产物被完全删除。

2. 修正图标资产配置 #

• 打开Assets.xcassets中的AppIcon条目，确认所有尺寸图标都已正确填充，尤其不要遗漏iPad专属尺寸：
  • 76pt @1x、@2x
  • 83.5pt @2x（iPad Pro 12.9英寸专属）
  • 1024pt @1x（App Store必填图标）
• 打开项目TARGETS配置，切换到Build Settings标签，搜索Asset Catalog Compiler - Options：
  • 确认Asset Catalog App Icon Set Name的取值和你Assets内的图标集名称完全一致
  • 强制将Include All App Icon Assets设为YES，规避Xcode的图标误裁剪问题
• 检查Info.plist，如果存在手动添加的CFBundleIcons、CFBundleIcons~ipad条目直接删除，让Xcode从Assets自动生成对应配置即可。

3. 清理测试端缓存 #

• 真机：先卸载设备上的旧版本应用，重启设备后再安装新构建的安装包
• 模拟器：打开对应模拟器，点击顶部菜单栏Device -> Erase All Content and Settings重置模拟器后再安装应用

4. 验证构建产物完整性 #

构建完成后，在Xcode的Products目录下找到生成的.app文件，右键选择Show Package Contents，确认包内存在所有尺寸的图标文件，无缺失即可。

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