【iOS】动态更换图标

在iOS 10.3苹果添加了更换图标的功能，经过这个功能，咱们能够在适当的时候采起特定的方式为咱们的App更换图标。 听似很好很方便，实则并无。缘由以下：

1. 更换的图标，咱们须要预置在项目中
2. 替换图标这个功能，必定要通过用户赞成（虽然有跳过这一步的方法，可是不建议使用）

虽然咱们在使用这个功能时有着种种限制，可是瑕不掩瑜，他一样为咱们的用户体验带来了提高：

1. 逢年过节想换个应景的App图标，不用在进行发版了
2. 公司有个重大活动须要更换图标，不用担忧活动前不能成功发版上线了

注： 咱们更换的不仅是APP的图标，还有通知栏的中的图标，以及设置界面中的图标等全部与咱们 App 有关的图标。

开发步骤

准备你要更换的图标

将咱们须要更换的图标放到咱们的项目目录中（由于放到.xcassets中无论用），图片的命名建议如下面的方式命名，例如：xx20x20@2x.png，xx20x20@3x.png…这样在填写Info.plist时也会省事不少。

PS： 其实对于更换的图标，咱们也能够只提供一张，但命名时，咱们就不要填写具体的尺寸了，只保留图片名字便可，例如：xx@2x.png，xx@3x.png， 可是效果上可能不如准备一整套的效果好。毕竟把一张桌面图标大小的图片塞到通知图标那么小的框里，图片会压缩。

修改Info.plist

想要实现换图标的功能，Info.plist 文件的修改是很重要的一步。

• CFBundleIcons: 一个字典，包含全部AppIcon信息，即上图的Icon files(iOS 5)
• CFBundlePrimaryIcon: 若是已经在Assets.xcassets中设置了AppIcon，那么CFBundlePrimaryIcon中的配置会被忽略，Assets.xcassets的AppIcon将会自动配置到CFBundlePrimaryIcon中。
• CFBundleAlternateIcons: 一个数组，负责配置可供替换的icon信息
• UIPrerenderedIcon: 是否已经预渲染，若是不设置该项或者设为NO。系统会自动为icon进行渲染增长光泽

若是想详细了解CFBundleIcons, CFBundlePrimaryIcon, CFBundleAlternateIcons，请查看附件2

若是iPad须要也须要更换图标，那么咱们须要在CFBundleIcons~ipad进行一样的设置。

注： 不能把图片放在.xcassets里面

编写代码

经过查看文档，咱们能够看到下面几个属性和方法。

// If false, alternate icons are not supported for the current process.
// 检查是否支持更换图标
@property (readonly, nonatomic) BOOL supportsAlternateIcons NS_EXTENSION_UNAVAILABLE("Extensions may not have alternate icons") API_AVAILABLE(ios(10.3), tvos(10.2));

// Pass `nil` to use the primary application icon. The completion handler will be invoked asynchronously on an arbitrary background queue; be sure to dispatch back to the main queue before doing any further UI work.
// 更换图标
- (void)setAlternateIconName:(nullable NSString *)alternateIconName completionHandler:(nullable void (^)(NSError *_Nullable error))completionHandler NS_EXTENSION_UNAVAILABLE("Extensions may not have alternate icons") API_AVAILABLE(ios(10.3), tvos(10.2));

// If `nil`, the primary application icon is being used.
// 当前图标的名称
@property (nullable, readonly, nonatomic) NSString *alternateIconName NS_EXTENSION_UNAVAILABLE("Extensions may not have alternate icons") API_AVAILABLE(ios(10.3), tvos(10.2));
复制代码

系统提供的 API 简单明了，惟一要注意的是下面这个方法。

- (void)setAlternateIconName:(nullable NSString *)alternateIconName completionHandler:(nullable void (^)(NSError *_Nullable error))completionHandler
复制代码

方法中的alternateIconName参数，是要填写您在Info.plist 中填写的名字，如图二中所示，咱们应当在此方法中填写female或者male1.

代码示例

为了方便你们使用，我将更换图标相关的代码已经写好在下面，如需自取。 也能够访问 DynamicAppIconDemo，查看 FSAppIconManager 类

+ (NSString *)getCurrentAppIconName {
    if (@available(iOS 10.3, *)) {
        return ([UIApplication sharedApplication].alternateIconName.length == 0) ? @"" : [UIApplication sharedApplication].alternateIconName;
    } else {
        // Fallback on earlier versions
        return @"";
    }
}

+ (BOOL)canChangeAppIcon {
    if (@available(iOS 10.3, *)) {
        return [[UIApplication sharedApplication] supportsAlternateIcons];
    } else {
        // Fallback on earlier versions
        return NO;
    }
}

+ (void)changeAppIconWithIconName:(NSString *)iconName completionHandler:(void (^)(NSError * _Nullable))completionHandler {
    if (@available(iOS 10.3, *)) {
        [[UIApplication sharedApplication] setAlternateIconName:iconName completionHandler:^(NSError * _Nullable error) {
            if (!error) {
                completionHandler(nil);
            } else {
                completionHandler(error);
            }
        }];
    } else {
        // Fallback on earlier versions
        NSDictionary *userInfo = @{
                                   NSLocalizedDescriptionKey: NSLocalizedString(@"AppIcon change failed", nil),
                                   NSLocalizedFailureReasonErrorKey: NSLocalizedString(@"The current system version does not support replacing the AppIcon.", nil),
                                   NSLocalizedRecoverySuggestionErrorKey: NSLocalizedString(@"", nil)
                                   };
        NSError *error = [NSError errorWithDomain:@""
                                             code:34001
                                         userInfo:userInfo];
        completionHandler(error);
    }
}
复制代码

下面给出部分 App Icon 相关的资料

App Icon Attributes

Attribute	Value
Format	PNG
Color space	sRGB or P3 (see Color Management)
Layers	Flattened with no transparency
Resolution	Varies. See Image Size and Resolution
Shape	Square with no rounded corners

App Icon Sizes

Device or context	Icon size
iPhone	180px × 180px (60pt × 60pt @3x)
	120px × 120px (60pt × 60pt @2x)
iPad Pro	167px × 167px (83.5pt × 83.5pt @2x)
iPad, iPad mini	152px × 152px (76pt × 76pt @2x)
App Store	1024px × 1024px (1024pt × 1024pt @1x)

Spotlight, Settings, and Notification Icons

Device or context	Spotlight icon size	Settings icon size	Notification icon size
iPhone	120px × 120px (40pt × 40pt @3x)	87px × 87px (29pt × 29pt @3x)	60px × 60px (20pt × 20pt @3x)
	80px × 80px (40pt × 40pt @2x)	58px × 58px (29pt × 29pt @2x)	40px × 40px (20pt × 20pt @2x)
iPad Pro, iPad, iPad mini	80px × 80px (40pt × 40pt @2x)	58px × 58px (29pt × 29pt @2x)	40px × 40px (20pt × 20pt @2x)

Notice：

Don’t add an overlay or border to your Settings icon. iOS automatically adds a 1-pixel stroke to all icons so that they look good on the white background of Settings.

附

1. Human Interface Guidelines - App Icon
2. CFBundleIcons,CFBundlePrimaryIcon,CFBundleAlternateIcons

---

title: 【iOS】动态更换 App 图标

author: zhangpeng

date: 2018.07.10

GitHub: github.com/fullstack-z…