iOS 10.3 如何更换 app 图标

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

[[UIApplication sharedApplication] setAlternateIconName:nil completionHandler:^(NSError * _Nullable error) {
                NSLog(@"error = %@", error.localizedDescription);
            }];

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

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

Assets.xcassets info.plist

<key>CFBundleIcons</key>
      <dict>
        <key>CFBundleAlternateIcons</key>
        <dict>
            <key>Test1</key>
            <dict>
                <key>CFBundleIconFiles</key>
                <array>
                    <string>Test1</string>
                </array>
                <key>UIPrerenderedIcon</key>
                <false/>
            </dict>
            <key>Test2</key>
            <dict>
                <key>CFBundleIconFiles</key>
                <array>
                    <string>Test2</string>
                </array>
            </dict>
        </dict>
        <key>CFBundlePrimaryIcon</key>
        <dict>
            <key>CFBundleIconFiles</key>
            <array>
                <string>AppIcon60x60</string>
            </array>
        </dict>
    </dict>

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

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

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

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

-(void)setIcon:(UISegmentedControl *)sender
{
    switch (sender.selectedSegmentIndex) {
        case 0:
            [[UIApplication sharedApplication] setAlternateIconName:nil completionHandler:^(NSError * _Nullable error) {
                NSLog(@"error = %@", error.localizedDescription);
            }];
            break;
        case 1:
            [[UIApplication sharedApplication] setAlternateIconName:@"Test1" completionHandler:^(NSError * _Nullable error) {
                NSLog(@"error = %@", error.localizedDescription);
            }];
            break;
        case 2:
            [[UIApplication sharedApplication] setAlternateIconName:@"Test2" completionHandler:^(NSError * _Nullable error) {
                NSLog(@"error = %@", error.localizedDescription);
            }];
            break;
            
        default:
            break;
    }
    
}

Simulator Screen Shot Simulator Screen Shot

demo 地址

写在最后：国外的app如NHL、MLB.com At Bat已经集成到项目中了，有兴趣的可以下载下来看看。