改變iOS app的icon

官方

iOS10.3新增了可以讓開(kāi)發(fā)者去更改app的icon，接下來(lái)看看怎么更改。
官方API給的東西很少，只是介紹了一個(gè)實(shí)例方法：

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

根據(jù)傳入的參數(shù)可知，我們只需要傳入備用icon名字即可，然后在回調(diào)里面拿到修改的結(jié)果，成功的話(huà)error為空，不成功則返回相應(yīng)的錯(cuò)誤信息（可以使用error!.localizedDescription來(lái)打印查看錯(cuò)誤信息）。如果失敗的話(huà)，alternateIconName屬性不變。這里注意：

如果當(dāng)期app使用的icon是備用的icon，那么這個(gè)屬性的值就是當(dāng)前icon的名字，這個(gè)名字是在Info.plist里面設(shè)置的名字，如果當(dāng)前app展示的是主要（primary）的icon，那么這個(gè)值為nil。

這里需要注意兩點(diǎn)：

1. 當(dāng)前設(shè)備的系統(tǒng)版本。這里的所有api都是10.3才能使用的。
2. 當(dāng)前app是否支持備用icon。使用supportsAlertnateIcons屬性判斷。只有為true的使用才能去更改。
   API中還有一句話(huà)比較關(guān)鍵：

你必須在Info.plist里面使用CFBundleIcons聲明當(dāng)前app的primary和alternate icon。這里如果不了解可以往下看，先忽略。

具體的Info.plist里面的字段含義這里就不在一一說(shuō)明，詳情可了解這里。

總之官方API上面我只找到了這么多。然而給我的感覺(jué)反倒一臉懵逼，完全搞不懂下面的Info.plist怎么設(shè)置。因此有了下面的序文。

個(gè)人理解

在剛才的Info.plist key介紹里面，我們先看一下其他的小知識(shí)。
我們都知道在Info.plist里面有個(gè)Bundle display name，也就是設(shè)置app在桌面顯示的名字。此時(shí)如果我們先不管這個(gè)key，我們繼續(xù)在Info.plist里面添加CFBundleDisplayName，你會(huì)收到這樣一個(gè)提示：

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

但是看一下Info.plist字典中的key，并沒(méi)有CFBundleDisplayName，替換后發(fā)現(xiàn)，原來(lái)它就是Bundle display name。也就是說(shuō)，Info.plist里面的Key在Xcode中顯示的并不是Key，而是Xcode name。如下圖：

Snip20170405_2.png

這個(gè)是從官方API上截的圖，其實(shí)這些Key都有對(duì)應(yīng)的Xcode name，也就是在Xcodes里面我們能看到的key。其實(shí)也很簡(jiǎn)單，如果你把Info.plist使用源碼形式打開(kāi)（右擊—>Open as —>Source code）,你就會(huì)發(fā)現(xiàn)這里寫(xiě)的key就是上面列出來(lái)的key。

先看看我在網(wǎng)上查資料設(shè)置的Info.plist：

Snip20170405_1.png

這里的CFBundleIconFiles是備用icon的名字。下面的Primary Icon是默認(rèn)的icon。源代碼就是：

Snip20170406_2.png

Snip20170406_3.png

每個(gè)字典的key是備用icon的名字，這個(gè)也是你傳入到

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

里面的iconName。其中的字典對(duì)應(yīng)值解釋如下：

Snip20170406_4.png

自己新建一個(gè)項(xiàng)目實(shí)現(xiàn)

自己實(shí)現(xiàn)需要注意兩個(gè)問(wèn)題：

1. Info.plist怎么設(shè)置？
2. 備用圖標(biāo)icon放到哪里？

首先來(lái)設(shè)置Info.plist。
按照蘋(píng)果官方的API說(shuō)法，那就先在Info.plist里面添加CFBundleIcons。但是查看了一下Key和Xcode name對(duì)應(yīng)的表格，CFBundleIcons對(duì)應(yīng)的是None，那就直接添加CFBundleIcons吧。點(diǎn)擊Information Property List后面的加號(hào)，輸入CFBundleIcons，當(dāng)點(diǎn)擊Enter鍵的時(shí)候，你會(huì)驚奇發(fā)現(xiàn)：你添加的CFBundleIcons變成了Icon files(iOS 5)字典。看看CFBundleIcons的官方API：

Snip20170406_6.png

根據(jù)英文意思可以知道：該key包含了所有app使用的icons信息。新建的是這樣的：

Snip20170406_8.png

Snip20170406_11.png

但是看官方API對(duì)CFBundleAlternateIcon的介紹里面，并沒(méi)有UINewstandBindingType和UINewsstandBindingEdge，只有這個(gè)：

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("關(guān)閉彈出框")
        }
        alert.addAction(okAction)
        self.present(alert, animated: true, completion: nil)
    }

結(jié)果卻是：

The file doesn't exist

看了一下官方API對(duì)CFBundleAlternateIcons的介紹，里面有一句話(huà)：

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

意思是這個(gè)CFBundleAlternateIcons中的字典的key是備用icon的名字，因此需要這樣修改：

Snip20170406_15.png

Snip20170406_16.png

Snip20170406_17.png

• 放到Assets.xcassets里面。新建一個(gè)普通的Image set，然后將圖片放到里面，效果如圖所示：

  
  
  

  Snip20170406_18.png
  
  

  經(jīng)過(guò)測(cè)試發(fā)現(xiàn)，這樣放置是無(wú)法正常改變appicon的。但是運(yùn)行結(jié)果沒(méi)有任何錯(cuò)誤，而且系統(tǒng)提示里面加載的也是新的app icon:

  
  
  

  IMG_0022.PNG

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

  
  
  

  Snip20170406_19.png
  
  

  運(yùn)行依然設(shè)置不成功。沒(méi)有錯(cuò)誤提示

• 放到一個(gè)新建的Bundle里面。如圖所示：。

  
  
  

  Snip20170406_20.png
  
  

  運(yùn)行結(jié)果依然是沒(méi)有成功更改。沒(méi)有錯(cuò)誤提示。

所以經(jīng)過(guò)測(cè)試，發(fā)現(xiàn)只有放到導(dǎo)航里面的圖片才可以更改成功。在蘋(píng)果qa里面看到過(guò)一個(gè)場(chǎng)景，他們是直接在導(dǎo)航新建了一個(gè)文件夾，然后將圖片放到里面，然后使用。這里也推薦建立文件夾放入圖片，然后使用

另外，關(guān)于icon大小，可以參見(jiàn)這里。

最后告訴大家一個(gè)不使用Asset來(lái)配置Icon的方法：直接在Info.plist下面這樣寫(xiě)：

Snip20170406_22.png

這個(gè)是通用的，可以直接設(shè)置iPhone和iPad的icon。其實(shí)這里也是想告訴大家：如何在CFBundleIconFiles里面去添加圖片數(shù)組：

 <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. 如果有什么疑問(wèn)歡迎留言提問(wèn)。或直接加群：206613455
   2.源碼地址：https://github.com/ScottZg/iOSChangeAppIcon