在iOS 10.3之前,苹果是不提供已上线的app动态更换图标功能的,这就导致我们即便只是一个更改节日图标的小需求,都需要重新打包上传商店,然后经历漫长的等待,可能还会有被拒绝的风险,好不容易审核通过了,得,节日过去了,还要换回来......贼坑爹......
但是,这个需求在iOS 10.3以后,苹果就开放了相应的API,可以提供开发者根据需求动态更改自己App的图标,而不需要重新上架。下面我们就来说一下怎么实现动态更换app的图标。
系统提供API
@interface UIApplication (UIAlternateApplicationIcons)
//如果为false,则当前进程不支持备用图标。
@property (readonly, nonatomic) BOOL supportsAlternateIcons NS_EXTENSION_UNAVAILABLE("Extensions may not have alternate icons") API_AVAILABLE(ios(10.3), tvos(10.2));
//传递`nil`以使用主应用程序图标。 完成处理程序将在任意后台队列上异步调用; 在进行任何进一步的UI工作之前,请务必调度回主队列。
- (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));
// 如果是`nil`,则使用主应用程序图标。
@property (nullable, readonly, nonatomic) NSString *alternateIconName NS_EXTENSION_UNAVAILABLE("Extensions may not have alternate icons") API_AVAILABLE(ios(10.3), tvos(10.2));
@end
系统API总共提供了2个属性一个方法来更改app图标,但是我们好像没办法通过这3个api将alternateIconName 和App图标联系起来,下面来看一下官方文档的解释
1.@property (readonly, nonatomic) BOOL supportsAlternateIcons
仅当系统允许您更改应用程序的图标时,此属性的值才为true。 要声明应用程序的备用图标,请将它们包含在应用程序的Info.plist文件的CFBundleIcons键中。(Plist的配置我们下面再说)
2.- (void)setAlternateIconName:(NSString *)alternateIconName completionHandler:(void (^)(NSError *error))completionHandler
参数解释:
alternateIconName:备用图标的名称,在应用程序的Info.plist文件的CFBundleAlternateIcons键中声明。 如果要显示应用程序的主要图标(使用CFBundlePrimaryIcon键声明),请指定nil。 这两个键都是应用程序Info.plist文件中CFBundleIcons键的子条目。
completionHandler:要使用结果执行的处理程序。 尝试更改应用程序的图标后,系统会通过调用您的处理程序来报告结果。 (处理程序在UIKit提供的队列上执行,而不一定在应用程序的主队列上执行。)
error:成功时,此参数的值为nil。 如果发生错误,则此参数包含指示发生了什么的错误对象,并且alternateIconName属性的值保持不变。
使用此方法可将应用程序的图标更改为其主要图标或其备用图标之一。 仅当supportsAlternateIcons属性的值为YES时,才能更改图标。
您必须使用应用的Info.plist文件的CFBundleIcons键声明应用的主要和备用图标。 有关如何为应用程序配置备用图标的信息,请参阅
信息属性列表键参考中的CFBundleIcons键说明。
3.@property (nullable, readonly, nonatomic) NSString *alternateIconName
当系统显示您的应用程序的备用图标时,此属性的值是备用图标的名称(来自应用程序的Info.plist文件)。 当系统显示您应用的主要图标时,此属性的值为nil。
文档中反复提到的Info.plist文件中的CFBundleIcons配置,这是Xcode6之前是用来配置App图标的方法,后来有了更完备的Assets.scassets,配置App图标就可以直接拖拽到Assets.scassets中配置了。
下面来说一下,info.plist文件中的配置
CFBundleIcons添加的时候,系统默认是添加Primary Icon和Newsstand Icon两个键值对
- Primary Icon:这个是配置App最初图标,可以选择在这里配置我们的最初图标,也可以在assets中配置。但是如果Assets.scassets中已经配置了AppIcon,那么这个地方的配置就不起作用。为什么呢?因为系统是会将Assets.xcassets中配置的AppIcon转化为Info.plist中的CFBundlePrimaryIcon。
- Newsstand Icon:这个目前没有用到,所以不太清楚它的作用是什么
- CFBundleAlternateIcons:这个才是我们要动态替换appicon的主角。这个文件夹内放置的是我们事先需要配置到工程中的我们需要动态替换的图标。
上图中的OriginIcon 和 NewIcon是我们自己配置的图标的名称,这个名称不需要和图片名字相同,可以随意定义,不过[- (void)setAlternateIconName:(NSString *)alternateIconName completionHandler:(void (^)(NSError *error))completionHandler方法中使用的alternateIconName一定是我们在这儿自定义的图片的名字,否则调用更改图标的方法的时候会报错,系统会提示找不到相应名称的图片。
UIPrerenderedIcon的value是BOOL值。这个键值所代表的作用在iOS7之后(含iOS7)已失效,在iOS6中可渲染app图标为带高亮效果。所以这个值目前我们可以不设置,默认是NO.
CFBundleIconFiles中的值分别是对应的不同尺寸的图标,不过也可以只用简单的2x、3x图,这样这个地方只需要配置图片名就可以了。不过这样的话,通知和系统配置的图标就会发生压缩,会稍微影响一些美观。
注意:文件扩展名,如@2x,@3x,要么统一不写,那么系统会自动寻找合适的尺寸。要写就需要把每张icon的扩展名写上
注意:需要替换的图标一定要放在工程的文件夹中,不能放在Assets.scassets中,如上图。否则系统没法找到对应的图片
下面进行代码实现:
-(void)changeAppIconWithIconName:(NSString *)iconName
{
if (@available(iOS 10.3, *)) {
//判断是否支持替换appicon
if (![[UIApplication sharedApplication] supportsAlternateIcons]) {
return;
}
//获取当前的iconName
//如果是原始的appicon,则iconName返回nil
NSString *alternateIconName = [[UIApplication sharedApplication] alternateIconName];
if (alternateIconName == nil) {
if (iconName.length == 0) {
//如果原app图标就是原始图标,则不需要再替换为原始图标
return;
}
}else{
//当前应用图标名和需要设置的图标名不相同时,才更改图标
if ([iconName isEqualToString:alternateIconName]) {
return;
}
}
[[UIApplication sharedApplication] setAlternateIconName:iconName completionHandler:^(NSError * _Nullable error) {
//打印替换结果,是否
NSLog(@"%@",error.description);
}];
}
}
代码中判断如果是原始应用图标和需要替换的图标是同一个的话,则直接return,就不需要调用系统api来替换图标了。
小伙伴们可以根据自己应用的业务逻辑来判断什么时候需要替换图标,不过需要替换的图标一定要提前设置在应用包中哦~~~
不过很多小伙伴们肯定会发现,每替换一次图标,系统都会弹框提示用户图标已更换,这是什么鬼,这样用户体验肯定差的要死,而且这样的成果一定会被产品经理打死吧。如下图:
别担心,程序员就是一种利用各种招都要解决问题的生物。下一篇文章我们来解决弹框问题,实现用户无感替换应用图标。
传送门:
好了,有问题欢迎随时讨论~~~~