【iOS 开发】iOS 10.3 如何更换 app 图标

iOS 10.3 开放了更换 app 图标的 API，核心方法是下面这个：

func setAlternateIconName(_ alternateIconName: String?, 
    completionHandler: ((Error?) -> Void)? = nil)

这是官方文档，但是你还需要在 info.plist 里面填一些东西才能让它起作用，这部分官方注释内容在这里。

但 info.plist 如何填写这部分读起来还是有些晦涩，一时可能搞不清楚如何操作，下面做个示范。

Assets.xcassets

info.plist

CFBundleIcons

    CFBundleAlternateIcons
    
        blackBgColor
        
            CFBundleIconFiles
            
                blackBgColor
            
            UIPrerenderedIcon
            
        
    
    CFBundlePrimaryIcon
    
        CFBundleIconFiles
        
            AppIcon60x60
        
    

如图，Primary Icon 字段写为 AppIcon60x60 是因为这里 xcassets 里面我只导入了 60pt@2x 和 60pt@3x 的图片资源，这里选为 60 是因为对于 iPhone，60pt 的图片资源图标所需最高质量，更低分辨率的版本系统会自动压缩以展示。

blackBgColor 是我的用于替换原生图标的图片资源。文件名需要和 info.plist 中保持一致（注意 info.plist 中用到了两次 "blackBgColor"），同时这也是你在代码中设置图标时，需要给 API 传入的参数。同样是 60pt@2x 和 60pt@3x 的图片资源，文件不通过 Assets.xcassets 添加进来，而是直接放到目录中。

如果你需要支持 iPad，建议这里使用 83.5pt（iPad Pro）的图片资源。另外还有些其他关于在 iPad 上替换图标的注意事项，在这里有说明，注意我们这里在 info.plist 里面所用的 key 是 CFBundleIcons，还有另外一个 key 是 CFBundleIcons~ipad。

替换图标部分的代码就超级简单了：

import UIKit

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
    }

    @IBAction func changeAppIcon(_ sender: Any) {
        
        if UIApplication.shared.supportsAlternateIcons {
            print("you can change this app's icon")
        }else {
            print("you cannot change this app's icon")
            return
        }
        
        if let name = UIApplication.shared.alternateIconName {
            // CHANGE TO PRIMARY ICON
            UIApplication.shared.setAlternateIconName(nil) { (err:Error?) in
                print("set icon error：\(String(describing: err))")
            }
            print("the alternate icon's name is \(name)")
        }else {
            // CHANGE TO ALTERNATE ICON
            UIApplication.shared.setAlternateIconName("blackBgColor") { (err:Error?) in
                print("set icon error：\(String(describing: err))")
            }
        }
    }

}

这是上述所有内容的完整 demo 地址

screentshot