iOS 10 正式版推出後,網路上關於 Xcode 8 與 iOS 10 的適配文章層出不窮,但真正談遠程推送改動的卻不多。事實上 iOS 10 對通知系統的改動幅度相當大,最關鍵的一點是新增了 UserNotifications Framework。以下結合實際專案的改造過程,說明需要動到哪些地方。
在 Xcode 7 的時代,這個開關不打開推送也能跑;但到了 Xcode 8,必須勾上,否則會直接拿到類似這樣的錯誤:
Error Domain=NSCocoaErrorDomain Code=3000 "未找到應用程序的“aps-environment”的授權字符串"
UserInfo={NSLocalizedDescription=未找到應用程序的“aps-environment”的授權字符串}
勾選之後,Xcode 會自動為專案產生 .entitlements 檔,APS Environment 的設定就寫在裡面。
先引入新框架:
#import <UserNotifications/UserNotifications.h>
iOS 10 把註冊 API 換成了以 UNUserNotificationCenter 為核心的寫法,因此又要做一次版本分支(以下示範 iOS 8 以上的處理):
if (IOS_VERSION >= 10.0) {
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
center.delegate = self;
[center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert)
completionHandler:^(BOOL granted, NSError * _Nullable error) {
if (!error) {
DLog(@"request authorization succeeded!");
}
}];
} else {
if ([application respondsToSelector:@selector(registerUserNotificationSettings:)]) {
// iOS 8 / 9:沿用舊的 UIUserNotificationSettings
UIUserNotificationSettings *notiSettings = [UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeBadge | UIUserNotificationTypeAlert | UIUserNotificationTypeSound) categories:nil];
[application registerUserNotificationSettings:notiSettings];
}
}
要注意的是,iOS 10 之後 delegate 必須設定,否則前台收到通知時不會有任何反應。
在 iOS 10 中處理推送,需要實作兩個方法:
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
willPresentNotification:(UNNotification *)notification
withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler;
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)())completionHandler;
兩者的分工很清楚:第一個是 App 位於前台時收到通知的回調;第二個是 App 在後台(或未啟動)時,使用者點擊通知進入 App 後的回調。
舊寫法裡,通知內容是從 userInfo 參數取出;新方法的參數清單表面上少了它,但其實資料一直都在,只是換了一條路徑:
/// App 在前台時的回調
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
willPresentNotification:(UNNotification *)notification
withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
NSDictionary *userInfo = notification.request.content.userInfo;
[self handleRemoteNotificationForcegroundWithUserInfo:userInfo];
}
/// App 在後台時,點擊通知後的回調
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)())completionHandler {
NSDictionary *userInfo = response.notification.request.content.userInfo;
[self handleRemoteNotificationBackgroundWithUserInfo:userInfo];
}
完成上面三個步驟,iOS 10 的推送適配基本就到位了。至於自訂通知樣式(Notification Content Extension)或各種 NotificationAction,那屬於更進階的應用,可以另找專文參考——本文的目標只是把版本差異填平。
本文已整理進《iOS 推送教程》,歡迎延伸閱讀。