iOS10通知扩展之Notification Service Extension

iOS 10增加了两种新的通知扩展:Notification Service ExtensionNotification Content Extension,本文只介绍前者(通知服务扩展)。想要接入使用通知服务扩展,需确保App已经具备了接收push的能力,如果有需求,可以参考iOS Push从0到1文章

1、Notification Service Extension

通知服务扩展(Notification Service Extension),在通知显示给用户之前会给你时间处理通知payloads,例如将要展示在通知中的image、GIF、Video、解密文本下载下来。

1.1 创建Service Extension

使用Xcode打开项目,选中File -> New -> Target...,在出现的弹窗中选择Notification Service Extension模板。如下图所示:

notificationService_0.png

点击Next后,你需要填写特定于应用程序的相关信息。添加完毕,点击Finish可以在项目的TARGETS里看到多了Service Extension一项。如图所示:

notificationService_1.png

而项目中则会生成NotificationService文件夹,以及相应的类文件和plist文件,如图所示:

notificationService_2.png

1.2 Extension LifeCycle

一旦你给App配置了通知服务扩展程序后,每个通知都会执行以下过程:

  1. App收到通知。
  2. 系统创建扩展类的实例对象并在后台启动它。
  3. 你的扩展程序会执行内容编辑和/或下载某些内容操作。
  4. 如果你的扩展程序执行太长时间而不能完成它的工作,将会收到通知并被立即终止。
  5. 通知显示给用户。

1.3 Extension Code

NotificationService类文件中有两个回调方法,方法如下:

// 重写此方法以实现推送通知的修改
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler;
// 扩展程序被系统终止之前会被调用,你可以选择是否覆盖此方法
- (void)serviceExtensionTimeWillExpire;

系统受到通知后,在有限的时间(不超过30s)内,你的扩展程序可以在didReceiveNotificationRequest:withContentHandler:方法内对通知做相应的更改并执行contentHandler代码块。如果你没有及时执行,系统将会调用上面的第二个方法serviceExtensionTimeWillExpire,在这里给你提供最后一次执行contentHandler代码块的机会。如果你什么都没做,系统将向用户显示通知的原始内容,你做的所有修改都不会生效。

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    self.contentHandler = contentHandler;
    self.bestAttemptContent = [request.content mutableCopy];
    
    // 根据约定好的key获取image地址
    NSString *imageUrlString = [request.content.userInfo objectForKey:@"url_key"];
    if (![imageUrlString isKindOfClass:[NSString class]]) {
        return;
    }
    
    NSURL *url = [NSURL URLWithString:imageUrlString];
    if (!url)
        return;
    
    [[[NSURLSession sharedSession] downloadTaskWithURL:url completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        if (!error) {
            NSString *tempDict = NSTemporaryDirectory();
            
            NSString *filenameSuffix = response.suggestedFilename ? response.suggestedFilename : [response.URL.absoluteString lastPathComponent];
            NSString *attachmentID = [[[NSUUID UUID] UUIDString] stringByAppendingString:filenameSuffix];
            NSString *tempFilePath = [tempDict stringByAppendingPathComponent:attachmentID];
            
            if ([[NSFileManager defaultManager] moveItemAtPath:location.path toPath:tempFilePath error:&error]) {
                UNNotificationAttachment *attachment = [UNNotificationAttachment attachmentWithIdentifier:attachmentID URL:[NSURL fileURLWithPath:tempFilePath] options:nil error:&error];
                
                if (!attachment) {
                    NSLog(@"Create attachment error: %@", error);
                } else {
                    _bestAttemptContent.attachments = [_bestAttemptContent.attachments arrayByAddingObject:attachment];
                }
            } else {
                NSLog(@"Move file error: %@", error);
            }
        } else {
            NSLog(@"Download file error: %@", error);
        }
        
        dispatch_async(dispatch_get_main_queue(), ^{
            self.contentHandler(self.bestAttemptContent);
        });
    }] resume];
}

2、Push payload

简单看一下push payload的格式:

{
    "aps":{
        "alert":{
            "title":"Push Title",
            "subtitle":"Push Subtitle",
            "body":"Push Body"
        },
        "sound":"default",
        "badge":1,
        "mutable-content":1
    },
    "landing_page":"https://www.baidu.com"
}

注意:

  • 如果要支持扩展服务,一定要确保payloadaps字典中包含mutable-content字段,值为1。

3、Push开关是否打开

Push功能完成后,我们一般会有判断App是否打开了通知开关的需求。如果用户没有打开可以提示用户再次打开,以保证Push消息能够推动给更多的用户,提高消息转化率。由于iOS10以上的通知相关API发生了较大变化,我们需要针对不同的系统版本使用不同的API来判断。具体代码如下:

+ (BOOL)isOpenNotificationSetting {
    __block BOOL isOpen = NO;
    if (@available(iOS 10.0, *)) { //iOS10及iOS10以上系统
       dispatch_semaphore_t semaphore;
       semaphore = dispatch_semaphore_create(0);
       // 异步方法,使用信号量的方式加锁保证能够同步拿到返回值
       [[UNUserNotificationCenter currentNotificationCenter] getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
           if (settings.authorizationStatus == UNAuthorizationStatusAuthorized) {
               isOpen = YES;
           }
           dispatch_semaphore_signal(semaphore);
       }];
       dispatch_semaphore_wait(semaphore, DISPATCH_TIME_FOREVER);
   } else { 
       UIUserNotificationSettings *settings = [[UIApplication sharedApplication] currentUserNotificationSettings];
       if (settings.types != UIUserNotificationTypeNone) {
           isOpen = YES;
       }
   }
   return isOpen;
}

由于getNotificationSettingsWithCompletionHandler:方法是一个异步方法,如果直接在回调中去判断当前的push授权状态的话,还未给isOpen赋值就已经return返回结果了。

问题有了,那么解决方案也有很多,如代码中所示,我们使用了信号量dispatch_semaphore,功能类似于iOS开发中的锁(比如NSLock@synchronize等),它是一种基于计数器的多线程同步机制。

  1. 使用dispatch_semaphore_create创建信号量semaphore,此时信号量的值是0。
  2. 异步跳过block块代码,执行dispatch_semaphore_wait,信号量的值减1。此时当前线程处于阻塞状态,等待信号量加1才能继续执行。
  3. block块代码异步执行,dispatch_semaphore_signal执行后发送一个信号,信号量的值加1,线程被唤醒,继续执行,给isOpen赋值,然后return,保证了每次能够正确取到当前的push开关状态。

4、相关配置

  1. 如果是一个新App,你需要创建2个App ID,一个用于App本身,一个用于创建通知服务扩展;如果App已经存在,再增加通知服务扩展,只需要创建用于扩展程序的App ID
  2. 与1同样,还需要创建用于扩展程序的Provisioning Profile
  3. 创建完成再Xcode完成相应的配置。

5、推送测试工具Pusher

iOS App的推送消息测试是比较麻烦的,Pusher提供了相当完善的push推送功能,可以帮助我们很好的完成push调试。

notificationService_3.png
  1. 选择对应的p12推送证书
  2. Should use sandbox environment选项代表你要发送push的环境是开发环境还是生产环境
  3. 第三行是要输入你当前要发送push设备的device token
  4. 最下面的输入框是push payload,将编辑好的json文本粘贴到这点击Push推送即可

最后附上效果图。

notificationService_4.png
notificationService_5.png

参考

iOS 10: Notification Service Extensions

iOS推送通知及推送扩展

NWPusher Github

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

推荐阅读更多精彩内容