前言
我們今天主要通過文檔參考+實驗的方法來得出遠程推送接收通知的那些方法調用的一些結論。文章較長,可以直接跳到最后看結論。
與遠程推送的有關的幾個方法
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions NS_AVAILABLE_IOS(3_0);
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo NS_DEPRECATED_IOS(3_0, 10_0, "Use UserNotifications Framework's -[UNUserNotificationCenterDelegate willPresentNotification:withCompletionHandler:] or -[UNUserNotificationCenterDelegate didReceiveNotificationResponse:withCompletionHandler:] for user visible notifications and -[UIApplicationDelegate application:didReceiveRemoteNotification:fetchCompletionHandler:] for silent remote notifications");
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler NS_AVAILABLE_IOS(7_0);
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler __IOS_AVAILABLE(10.0) __TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0) __OSX_AVAILABLE(10.14);
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler __IOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0) __OSX_AVAILABLE(10.14) __TVOS_PROHIBITED;
方法1- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions NS_AVAILABLE_IOS(3_0);
這個做iOS的人都知道,是App啟動的時候會調用的方法,值得一說的是,這個方法有個launchOptions 參數,可以用來標識啟動的原因。點擊了通知彈框打開App的時候,這個方法是會帶有推送的參數的。
方法2:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo NS_DEPRECATED_IOS(3_0, 10_0, "Use UserNotifications Framework's -[UNUserNotificationCenterDelegate willPresentNotification:withCompletionHandler:] or -[UNUserNotificationCenterDelegate didReceiveNotificationResponse:withCompletionHandler:] for user visible notifications and -[UIApplicationDelegate application:didReceiveRemoteNotification:fetchCompletionHandler:] for silent remote notifications");
一個非常古老的方法,在iOS7之前,推送主要是通過這個方法接收的。在iOS7之后就被下面的方法3替代了,而且在iOS10的時候這個方法已經被標為過時了,所以不建議使用。
方法3:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler NS_AVAILABLE_IOS(7_0);
這個方法就比較重要了。iOS7的時候出來的方法,到iOS10之前都是稱霸一方的大佬。當然由于靜默推送的存在,直到現在仍然比較重要。除了能夠完全替代方法2之外,還能處理推送喚醒的功能。關于推送喚醒(也叫做靜默推送)這個功能比較復雜,本文不考慮這個功能。
方法4:
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler __IOS_AVAILABLE(10.0) __TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0) __OSX_AVAILABLE(10.14);
這個方法是iOS10推出的,屬于UserNotifications
框架中UNUserNotificationCenterDelegate
代理協議的方法。主要是當App在前臺的時候,收到推送通知之后調用。completionHandler回調可以控制是否顯示alert、badge和sound。在iOS10之前,當App在前臺的時候收到通知,是不會顯示通知彈框的,但是在iOS10開始,實現了這個方法,我們可以選擇是否顯示通知彈框。比如在方法里面調用了completionHandler(UNNotificationPresentationOptionAlert);
,當App在前臺收到通知也會顯示通知彈框。可操作性更高了。
方法5:
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler __IOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0) __OSX_AVAILABLE(10.14) __TVOS_PROHIBITED;
跟方法4配套的,同樣是iOS10推出,屬于UNUserNotificationCenterDelegate
的方法。主要是當App在后臺以及關閉狀態下收到通知之后通過點擊通知打開App的時候調用。
測試工具
上面大概介紹了幾個方法的基本情況。但是實際上這幾個推送方法的關系實在是剪不斷理還亂。所以為了搞清楚這些關系,我做了一大波的測試。
工欲善其事必先利其器,我們需要幾下幾個東西:
1.一個可以用來測試的demo,由于遠程推送是需要推送證書的,所以需要一個開發者賬號,BundleID需要配置了開啟推送,并配置相應的推送證書。
2.一個發送推送通知的工具,我用的是github上star數很高的NWPusher里面的Mac App,可以使用這個App來發送通知,很好用。話說,這App的圖標簡直無力吐槽。。。
3.一個log工具,需要記錄我們手動啟動的時候打印的log(因為無法直接從Xcode上看),并且能夠方便查看。我就直接用我之前做過的一個浮窗log工具了。
4.測試推送需要使用真機,目前手上容易拿到的是兩個手機,系統分別為iOS9.3.2和iOS12.3.1。由于主要分界線是iOS10及iOS10之前,所以這兩個夠用了。
開始測試
首先我們默認demo已經調通了推送,能夠拿到deviceToken了。
推送的payload為{"aps":{"alert":"Testing.. (0)","badge":1,"sound":"default"}}
(Puser這個App還很貼心地在每次推送完畢之后都會將Testing后面的數字加1,這樣可以方便地辨認出那一次的通知)。靜默推送的情況比較復雜,我們暫不測試。
上面的5個方法,我們只實現方法2(當然方法1一直都是要實現的,后面就不特別說明了)。
然后分別在App處于前臺,App處于后臺,App處于關閉狀態的時候推送通知。以下為測試記錄:
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS9.3.2 | 不顯示通知彈框,直接調用方法2 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法2 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1 |
iOS12.3.1 | 不顯示通知彈框,直接調用方法2 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法2 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1 |
可以得出結論:
如果只實現方法2,不管是iOS10以下還是以上,推送通知到來時,
如果App處于前臺,那么會直接調用方法2。
如果App處于后臺,那么系統會顯示通知提示框。如果我們不點擊通知提示框,那什么都不會調用。如果點擊了通知提示框,那么會打開App,并且會調用方法2。
當App在關閉狀態,推送到來時,系統會彈出通知提示框。如果不點擊通知提示框,那么什么都不會調用。如果點擊了通知提示框,那么App會啟動,將會調用方法1.方法1的launchOptions里面會有推送的參數。而方法2并不會調用。
接下測試的情況是只實現方法3:
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS9.3.2 | 不顯示通知彈框,直接調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法3 |
iOS12.3.1 | 不顯示通知彈框,直接調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法3 |
結論:
如果只實現方法3,不管是iOS10以下還是以上,推送通知到來時,
當App處于前臺,跟只實現方法2時相同
當App處于后臺,跟只實現方法2時相同
當App在關閉狀態,推送到來時,系統會彈出通知提示框。如果不點擊通知提示框,那么什么都不會調用。如果點擊了通知提示框,那么App會啟動,將會調用方法1.方法1的launchOptions里面會有推送的參數。接著將會調用方法3,方法3的參數跟方法1的launchOptions參數是相同的(其實不是完全相同,launchOptions參數會用UIApplicationLaunchOptionsRemoteNotificationKey為key的字典將推送傳過來的參數包裹住,也就是將方法3收到的參數包裹住)。
也就是說,只實現方法2和只顯示方法3的不同點在于,當App處于關閉狀態時,點擊通知提示框之后,App在調用了方法1之后,會調用方法3,而方法2卻不會被調用。
同時實現方法2和方法3:
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS9.3.2 | 不顯示通知彈框,直接調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法3 |
iOS12.3.1 | 不顯示通知彈框,直接調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法3 |
結論:很明顯,同時實現方法2和方法3,將會導致方法2被方法3覆蓋,也就是說,方法2永遠不會被調用。
只實現方法4和方法5
上文提過,方法4和方法5是配套使用的。所以現在要測試下只實現這兩個方法的情況。先讓方法4的參數設為0
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS9.3.2 | 不會調用方法 | 顯示通知,通知到來時彈出推送彈框,點擊彈框打開App | 顯示通知,通知到來內框會打開App,點擊彈框后會調用方法1 |
iOS12.3.1 | 不顯示通知彈框,直接調用方法4 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法5 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法5 |
由于方法4和方法5是iOS10的時候才推出的,所以在iOS10以下的設備不生效。所以在iOS9.3.2設備上測試的時候這兩個方法是無效的。在iOS10以上,這兩個方法相當于將方法3拆分成了兩個,在前臺的時候調用方法4,在后臺和關閉狀態打開的時候調用方法5。
這里還需要測試一種情況,就是方法4收到推送之后,是可以彈出提示框的。我們把方法4的參數改為UNNotificationPresentationOptionAlert
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler
{
NSLogD(@"willPresentNotification notification=%@",notification);
completionHandler(UNNotificationPresentationOptionAlert);
}
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS12.3.1 | 調用方法4,顯示通知,點擊通知之后調用調用方法5 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法5 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法5 |
也就是說,App在前臺的時候,我們能夠讓通知顯示提示框。點擊提示框之后依舊會走方法5.
再來測一下一波,當我們將上面說的所有方法都實現了,然后測一波
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS9.3.2 | 不顯示通知,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框打開App,調用方法3 | 顯示通知,通知到來內框會打開App,點擊彈框后會調用方法1,然后調用方法3 |
iOS12.3.1 | 不顯示通知彈框,直接調用方法4 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法5 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法5 |
所以,跟推測中的結果一樣,方法2不管怎樣都不會調用,因為實現了方法3.在iOS10以下設備,方法3義不容辭地起作用了。在iOS10及以上設備,方法4和方法5都實現的情況下,優先調用方法4和方法5,而方法3將會被忽略掉。
到了這里,有沒有想過,要是只實現方法5和方法3,或者只實現方法4和方法3,會怎么樣呢?
我們只測試iOS10及以上設備,只實現方法5和方法3的情況
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS12.3.1 | 不顯示通知彈框,直接調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法5 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法5 |
只實現方法4和方法3的情況
系統 | App處于前臺 | App處于后臺 | App處于關閉狀態 |
---|---|---|---|
iOS12.3.1 | 不顯示通知彈框,直接調用方法4 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后打開App,調用方法3 | 顯示通知,通知到來時彈出推送彈框,點擊彈框后會調用方法1,接著調用方法3 |
跟想象中一樣,當方法4或方法5其中一個沒實現的時候,備胎(方法3)就起作用了。
結論:
至此,我們就可以得出方法的調用順序邏輯圖了。
推送通知接收方法的調用跟系統版本(以iOS10作為分界線)、App狀態(前臺、后臺、關閉狀態)、方法是否實現(只實現了某些方法或者所有方法都實現)有關。
方法的優先級為
方法4和方法5 > 方法3 > 方法2
。系統檢測到有優先級高的方法就調用,就不會管優先級較低的方法了。所以在iOS10及以上系統,系統會先查找
[UNUserNotificationCenter currentNotificationCenter]
是否有delegate,delegate是否實現了方法4和方法5,如果有,就調用。如果沒有,就查找方法3,有就調用。如果沒有,再去查找方法2。iOS10以下系統沒有
UNUserNotification
框架,所以系統會直接找方法3,如果有,就調用。如果沒有,就去查找方法2進行處理。
參考
總結 iOS 接收遠程推送的響應方法
蘋果推送功能官方文檔
遠程推送didReceiveRemoteNotification代理方法調用詳細說明