蘋果的推送服務從 iOS 3 問世至今,幾乎每個大版本都會補上新的玩法:iOS 7 帶來 Silent Remote Notifications(遠端靜默推播),iOS 8 引進 Category 分類與快捷回覆,iOS 9 則追加 Text Input Action,讓使用者能直接在通知上輸入文字。
到了 iOS 10,蘋果一口氣把在地通知(Local Notification)與遠端通知(Remote Notification)大範圍重整,推出全新的 UserNotifications 框架(iOS 10 之前,相關 API 原本掛在 UIKit 之下)。新框架把在地與遠端通知的點擊處理整合為同一套介面,於是過去那些專門處理「點擊通知」的舊方法,如今只剩下靜默推播還在沿用。
遠端推送是指在裝置連網的前提下,由遠端伺服器透過蘋果 APNs(Apple Push Notification Service)轉發給用戶端的推播。無論 App 是開啟還是關閉,都能收到伺服器送出的通知。原理很單純:所有蘋果裝置在連網狀態下,都會與蘋果伺服器維持一條長連線。
UDID 與 BundleID 送給 APNs,APNs 加密後回傳 deviceToken。deviceToken 一併上傳,由伺服器保存對應關係。deviceToken,把訊息內容與 deviceToken 交給 APNs。deviceToken 精準定位到「某台裝置上的某個 App」,再把訊息推送給使用者。(1)真機設備,模擬器無法接收遠端推播。
(2)除錯階段憑證
iOS_development.cer:真機除錯用憑證。aps_development.cer:真機推播除錯用憑證。xxx.mobileprovision:描述檔,記錄可除錯的裝置、電腦與 App。(3)發布階段憑證
iOS_distribution.cer:用於上架發布的憑證。aps.cer:讓發布後的 App 具備推送能力的憑證。xxx.mobileprovision:描述檔,記錄可發布 App 的電腦。憑證的申請與設定流程不在本文範圍內,請自行處理或參考影片教學。
1. 建立 iOS 專案並命名。
2. 在 AppDelegate 中引入標頭檔:
#import <UserNotifications/UserNotifications.h>
3. 在 application:didFinishLaunchingWithOptions 中註冊遠端通知:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { //請求通知權限, 本地和遠程共用 UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter]; [center requestAuthorizationWithOptions:UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert completionHandler:^(BOOL granted, NSError * _Nullable error) { if (granted) { NSLog(@"請求成功"); } else { NSLog(@"請求失敗"); } }]; //注冊遠程通知 [[UIApplication sharedApplication] registerForRemoteNotifications]; //設置通知的代理 center.delegate = self; return YES; }
4. 在接收 DeviceToken 的回呼方法中取出 Token,後續需要上傳給後端:
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { //將來需要將此Token上傳給後台服務器 NSLog(@"token:%@", deviceToken); }
若希望在通知被點擊後自行處理業務邏輯,iOS 10 必須設定 UNUserNotificationCenter 的 delegate,並讓 AppDelegate 遵守 UNUserNotificationCenterDelegate 協議,接著實作以下三個方法,分別對應不同情境:
willPresentNotification:withCompletionHandler:App 位於前台時觸發。didReceiveNotificationResponse:withCompletionHandler:App 在背景或被終止時觸發。didReceiveRemoteNotification:fetchCompletionHandler:靜默推播時觸發。//設置通知的代理 center.delegate = self;
前台運行指的是 App 正在執行、使用者看得见介面。在舊框架下,前台收到推播不會顯示任何提示;iOS 10 則會正常跳出通知橫幅。
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler { NSDictionary *userInfo = notification.request.content.userInfo; //前台運行推送 顯示紅色Label [self showLabelWithUserInfo:userInfo color:[UIColor redColor]]; //可以設置當收到通知後, 有哪些效果呈現(聲音/提醒/數字角標) completionHandler(UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert); }
背景運行指 App 已開啟但使用者看不到介面,例如鎖屏或按下 Home 鍵;App 退出則是程式完全沒有在執行,或由多工介面手動關閉。
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler { NSDictionary *userInfo = response.notification.request.content.userInfo; //後台及退出推送 顯示綠色Label [self showLabelWithUserInfo:userInfo color:[UIColor greenColor]]; completionHandler(); }
靜默推播自 iOS 7 起提供,不會發出聲音或提醒,只用來喚醒 App 做事。使用上有兩個硬性要求:
alert 與 sound 欄位。content-available 欄位並設為 1,例如:{"aps":{"content-available":"1"},"PageKey":"2"} //如果是以前的舊框架, 此方法 前台/後台/退出/靜默推送都可以處理 - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { //靜默推送 顯示藍色Label [self showLabelWithUserInfo:userInfo color:[UIColor blueColor]]; completionHandler(UIBackgroundFetchResultNewData); }
實際專案中,點擊通知後要做什麼取決於產品需求。為了方便示範,這裡只把通知內容用 UILabel 隨手畫在主界面上。
- (void)showLabelWithUserInfo:(NSDictionary *)userInfo color:(UIColor *)color { UILabel *label = [UILabel new]; label.backgroundColor = color; label.frame = CGRectMake(0, 250, [UIScreen mainScreen].bounds.size.width, 300); label.text = userInfo.description; label.numberOfLines = 0; [[UIApplication sharedApplication].keyWindow addSubview:label]; }
PushMeBaby 是一個可在 Mac 上模擬伺服器的小工具,能直接把訊息交給蘋果 APNs。前往 www.github.com 搜尋並下載 PushMeBaby 即可。
使用步驟:
DeviceToken 與測試文字,填進專案 AppDelegate 的 init 方法中。 - (id)init { self = [super init]; if(self != nil) { self.deviceToken = @"de20184c ef0461d5 12c76422 f5b78240 5f657e18 ebf91c9f 01d5560c e2913102"; self.payload = @"{\\"aps\\":{\\"alert\\":{\\"title\\":\\"himeao\\",\\"subtitle\\":\\"自學成才\\",\\"body\\":\\"iOS10遠程&本地推送教程\\"},\\"badge\\":1,\\"sound\\":\\"default\\"},\\"PageKey\\":\\"1\\"}"; self.certificate = [[NSBundle mainBundle] pathForResource:@"aps_development" ofType:@"cer"]; } return self; }
本文完整走過 iOS 10 遠端通知的建立流程:從推送原理、憑證準備,到註冊 Token、以 UserNotifications 框架接管各情境的處理邏輯,最後用 PushMeBaby 完成實測。對正在學習 iOS 10 的開發者來說,這套流程值得動手跑一遍;若有疑問歡迎留言交流。