[iOS开发] iOS动态更换图标系列(一)

在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图标联系起来,下面来看一下官方文档的解释

supportsAlternateIcons.png

1.@property (readonly, nonatomic) BOOL supportsAlternateIcons
仅当系统允许您更改应用程序的图标时,此属性的值才为true。 要声明应用程序的备用图标,请将它们包含在应用程序的Info.plist文件的CFBundleIcons键中。(Plist的配置我们下面再说)


setAlternateIconName.png

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键说明。

alternateIconName.png

3.@property (nullable, readonly, nonatomic) NSString *alternateIconName
当系统显示您的应用程序的备用图标时,此属性的值是备用图标的名称(来自应用程序的Info.plist文件)。 当系统显示您应用的主要图标时,此属性的值为nil。

文档中反复提到的Info.plist文件中的CFBundleIcons配置,这是Xcode6之前是用来配置App图标的方法,后来有了更完备的Assets.scassets,配置App图标就可以直接拖拽到Assets.scassets中配置了。

下面来说一下,info.plist文件中的配置

infoPlist.png

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的扩展名写上

工程中的图片的位置.png

注意:需要替换的图标一定要放在工程的文件夹中,不能放在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来替换图标了。

小伙伴们可以根据自己应用的业务逻辑来判断什么时候需要替换图标,不过需要替换的图标一定要提前设置在应用包中哦~~~

不过很多小伙伴们肯定会发现,每替换一次图标,系统都会弹框提示用户图标已更换,这是什么鬼,这样用户体验肯定差的要死,而且这样的成果一定会被产品经理打死吧。如下图:


系统弹框.png

别担心,程序员就是一种利用各种招都要解决问题的生物。下一篇文章我们来解决弹框问题,实现用户无感替换应用图标。

传送门:

好了,有问题欢迎随时讨论~~~~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容