改变iOS app的icon

官方

iOS10.3新增了可以让开发者去更改app的icon，接下来看看怎么更改。
官方API给的东西很少，只是介绍了一个实例方法：

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

根据传入的参数可知，我们只需要传入备用icon名字即可，然后在回调里面拿到修改的结果，成功的话error为空，不成功则返回相应的错误信息（可以使用error!.localizedDescription来打印查看错误信息）。如果失败的话，alternateIconName属性不变。这里注意：

如果当期app使用的icon是备用的icon，那么这个属性的值就是当前icon的名字，这个名字是在Info.plist里面设置的名字，如果当前app展示的是主要（primary）的icon，那么这个值为nil。

这里需要注意两点：

1. 当前设备的系统版本。这里的所有api都是10.3才能使用的。
2. 当前app是否支持备用icon。使用supportsAlertnateIcons属性判断。只有为true的使用才能去更改。
   API中还有一句话比较关键：

你必须在Info.plist里面使用CFBundleIcons声明当前app的primary和alternate icon。这里如果不了解可以往下看，先忽略。

具体的Info.plist里面的字段含义这里就不在一一说明，详情可了解这里。

总之官方API上面我只找到了这么多。然而给我的感觉反倒一脸懵逼，完全搞不懂下面的Info.plist怎么设置。因此有了下面的序文。

个人理解

在刚才的Info.plist key介绍里面，我们先看一下其他的小知识。
我们都知道在Info.plist里面有个Bundle display name，也就是设置app在桌面显示的名字。此时如果我们先不管这个key，我们继续在Info.plist里面添加CFBundleDisplayName，你会收到这样一个提示：

The key you entered is already present in the dictionary.do you want to replace the existing key/value pair?

但是看一下Info.plist字典中的key，并没有CFBundleDisplayName，替换后发现，原来它就是Bundle display name。也就是说，Info.plist里面的Key在Xcode中显示的并不是Key，而是Xcode name。如下图：

Snip20170405_2.png

这个是从官方API上截的图，其实这些Key都有对应的Xcode name，也就是在Xcodes里面我们能看到的key。其实也很简单，如果你把Info.plist使用源码形式打开（右击—>Open as —>Source code）,你就会发现这里写的key就是上面列出来的key。

先看看我在网上查资料设置的Info.plist：

Snip20170405_1.png

这里的CFBundleIconFiles是备用icon的名字。下面的Primary Icon是默认的icon。源代码就是：

Snip20170406_2.png

Snip20170406_3.png

每个字典的key是备用icon的名字，这个也是你传入到

IApplication.shared.setAlternateIconName(iconName) { (error) in
            if (error != nil) {
                self.aler(str: (error!.localizedDescription))
            }else {
                self.aler(str: "修改成功")
            }
        }

里面的iconName。其中的字典对应值解释如下：

Snip20170406_4.png

自己新建一个项目实现

自己实现需要注意两个问题：

1. Info.plist怎么设置？
2. 备用图标icon放到哪里？

首先来设置Info.plist。
按照苹果官方的API说法，那就先在Info.plist里面添加CFBundleIcons。但是查看了一下Key和Xcode name对应的表格，CFBundleIcons对应的是None，那就直接添加CFBundleIcons吧。点击Information Property List后面的加号，输入CFBundleIcons，当点击Enter键的时候，你会惊奇发现：你添加的CFBundleIcons变成了Icon files(iOS 5)字典。看看CFBundleIcons的官方API：

Snip20170406_6.png

根据英文意思可以知道：该key包含了所有app使用的icons信息。新建的是这样的：

Snip20170406_8.png

Snip20170406_11.png

但是看官方API对CFBundleAlternateIcon的介绍里面，并没有UINewstandBindingType和UINewsstandBindingEdge，只有这个：

Snip20170406_12.png

Snip20170406_14.png

    @IBAction func changeToNewIconAction(_ sender: Any) {
        if !checkSupportChangeIcon() {
            return
        }
        if !UIApplication.shared.supportsAlternateIcons {
            return
        }
        changeToIcon("newicon")

    }
    //MARK: check system version
    func checkSupportChangeIcon() -> Bool {
        let deviceVersion = UIDevice.current.systemVersion
        if deviceVersion.contains("10.3") {
            return true
        }
        return false
    }
    //MARK: change to icon message
    func changeToIcon(_ iconName: String?)  {
        
        UIApplication.shared.setAlternateIconName(iconName) { (error) in
            if (error != nil) {
                self.aler(str: (error!.localizedDescription))
            }else {
                self.aler(str: "修改成功")
            }
        }
        
        
        
    }
    //MARK: alert message
    func aler(str: String) {
        let alert = UIAlertController.init(title: "提示", message: str, preferredStyle: .alert)
        let okAction = UIAlertAction.init(title: "ok", style: .cancel) { (action: UIAlertAction) in
            print("关闭弹出框")
        }
        alert.addAction(okAction)
        self.present(alert, animated: true, completion: nil)
    }

结果却是：

The file doesn't exist

看了一下官方API对CFBundleAlternateIcons的介绍，里面有一句话：

In iOS, the value of the key is a dictionary. The key for each dictionary entry is the name of the alternate icon, which is also the string you pass to the setAlternateIconName:completionHandler: method of UIApplication when changing icons. The value for each key is a dictionary containing the keys in Table 5

意思是这个CFBundleAlternateIcons中的字典的key是备用icon的名字，因此需要这样修改：

Snip20170406_15.png

Snip20170406_16.png

Snip20170406_17.png

• 放到Assets.xcassets里面。新建一个普通的Image set，然后将图片放到里面，效果如图所示：

  
  
  

  Snip20170406_18.png
  
  

  经过测试发现，这样放置是无法正常改变appicon的。但是运行结果没有任何错误，而且系统提示里面加载的也是新的app icon:

  
  
  

  IMG_0022.PNG

• 放到Assets.xcassets里面，并且新建的icon，如图：

  
  
  

  Snip20170406_19.png
  
  

  运行依然设置不成功。没有错误提示

• 放到一个新建的Bundle里面。如图所示：。

  
  
  

  Snip20170406_20.png
  
  

  运行结果依然是没有成功更改。没有错误提示。

所以经过测试，发现只有放到导航里面的图片才可以更改成功。在苹果qa里面看到过一个场景，他们是直接在导航新建了一个文件夹，然后将图片放到里面，然后使用。这里也推荐建立文件夹放入图片，然后使用

另外，关于icon大小，可以参见这里。

最后告诉大家一个不使用Asset来配置Icon的方法：直接在Info.plist下面这样写：

Snip20170406_22.png

这个是通用的，可以直接设置iPhone和iPad的icon。其实这里也是想告诉大家：如何在CFBundleIconFiles里面去添加图片数组：

 <key>CFBundleIconFiles</key>
            <array>
                <string>Icon-Small</string>
                <string>Icon-Small-40</string>
                <string>Icon-Small-50</string>
                <string>Icon</string>
                <string>Icon-60</string>
                <string>Icon-72</string>
            </array>

备注

1. 如果有什么疑问欢迎留言提问。或直接加群：206613455
   2.源码地址：https://github.com/ScottZg/iOSChangeAppIcon