Swift动态切换App图标异常：图标显示为未定义状态

1. Info.plist配置校验 #

• 确认CFBundleIcons顶层键存在，其下的CFBundleAlternateIcons字典结构正确：每个备选图标对应的子字典中，CFBundleIconFiles必须是数组类型，且值为你在Assets中设置的图标名称（不要加文件后缀，比如图标Asset名为IconBlue就直接写IconBlue）
• 检查CFBundlePrimaryIcon的CFBundleIconFiles是否正确指向主图标，且主图标在Assets中正常配置
• 确保备选图标的键名（即CFBundleAlternateIcons下的key）和后续代码调用的名称完全一致，大小写也要严格匹配

2. Assets资源检查 #

• 备选图标必须是App Icon类型的Asset Set，而非普通Image Set。创建时选择“App Icon”模板，至少填充1024×1024的iOS Marketing图标，以及对应设备所需的尺寸（仅放1024尺寸可能导致系统无法适配不同设备）
• 确认Asset Set的名称和Info.plist中CFBundleIconFiles的名称完全一致，避免因拼写、大小写错误导致系统找不到资源

3. 代码调用验证 #

确保调用切换接口时传入的名称与Info.plist中CFBundleAlternateIcons的键名一致，示例代码：

UIApplication.shared.setAlternateIconName("BlueIcon") { error in
    if let error = error {
        print("图标切换失败：\(error.localizedDescription)")
    }
}

• 若completionHandler返回错误，直接打印错误信息定位问题

4. 环境与缓存问题 #

• 彻底删除真机/模拟器上的App，重新编译安装，避免旧缓存干扰图标加载
• 切换图标后，可重启设备（真机）或模拟器，确保系统Springboard刷新图标资源

辅助验证手段 #

通过代码打印当前支持的备选图标列表，确认配置是否被系统正确读取：

if let supportedIcons = UIApplication.shared.supportedAlternateIconNames {
    print("已配置的备选图标：\(supportedIcons)")
} else {
    print("未检测到备选图标配置")
}

如果输出为空，说明Info.plist的结构或内容存在错误，需重新检查配置。

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