最近公司要求把維護期的項目都集成極光推送,過程中踩到幾個小坑,特此總結記錄。
極光推送能幹嘛?
1. 為 JPush Server 上報 Device Token,免去開發者自行管理的麻煩;2. 支持 iOS APNs 推送;3. 前台運行時可接收 JPush 下發的透傳自定義消息;4. 靈活管理接收用戶:Tag(標簽分組)、Alias(用戶別名)、RegistrationID(設備注冊 ID)。了解它能做什麼,就開始動手集成吧。
配置 push 證書
此步驟直接看極光官方文檔即可,寫得非常詳細。
導入必要的框架:
CFNetwork.framework
CoreFoundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Foundation.framework
UIKit.framework
Security.framework
Xcode 7 需要 libz.tbd;Xcode 7 以下版本用 libz.dylib
創建並配置 PushConfig.plist 文件
在工程中新建一個 Property List 文件並命名為 PushConfig.plist,字段如下:
CHANNEL:指明應用下載渠道,為方便分渠道統計,值由你自行定義,如 App Store。APP_KEY:填寫 Portal 上創建應用後自動生成的 AppKey,需確保與之一致。APS_FOR_PRODUCTION:1.3.1 版本新增,用於標識當前使用的 APNs 證書環境,0(默認)表示開發證書,1 表示生產證書,此值需與 Build Settings 的 Code Signing 證書環境一致。(舊版配置文件中的 TEST_MODE 鍵在新版 SDK 已不再使用,可刪除。)

核心代碼:首先在 AppDelegate.m 導入 #import "JPUSHService.h",在 didFinishLaunchingWithOptions 方法中貼上核心代碼:
// 極光推送 if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) { [JPUSHService registerForRemoteNotificationTypes:(UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert) categories:nil]; } else { [JPUSHService registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound | UIRemoteNotificationTypeAlert) categories:nil]; } // appKey 為極光申請的 key,channel 可設默認值 [JPUSHService setupWithOption:launchOptions appKey:JAppKey channel:Jchannel apsForProduction:NO];// 生產環境設為 YES之後還需加入以下方法:
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { // Required [JPUSHService registerDeviceToken:deviceToken]; }-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{ NSString *alert = [[userInfo objectForKey:@"aps"] objectForKey:@"alert"]; if (application.applicationState == UIApplicationStateActive) { UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"推送消息" message:alert delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil]; [alertView show]; } [application setApplicationIconBadgeNumber:0]; [JPUSHService handleRemoteNotification:userInfo]; }我們還能監聽極光推送的生命週期通知,API 提供了以下 5 種類型:
extern NSString * const kJPFNetworkDidSetupNotification; // 建立連接 extern NSString * const kJPFNetworkDidCloseNotification; // 關閉連接 extern NSString * const kJPFNetworkDidRegisterNotification; // 注冊成功 extern NSString * const kJPFNetworkDidLoginNotification; // 登錄成功(RegistrationID 需在此方法中獲取) extern NSString * const kJPFNetworkDidReceiveMessageNotification; // 收到自定義消息(非 APNS)
其中 kJPFNetworkDidReceiveMessageNotification 傳遞的數據可通過 NSNotification 的 userInfo 獲取,包括標題、內容、extras 等。
使用方法:Tag(標簽分組)與 Alias(用戶別名)
// 綁定 Tag,需用 NSSet [JPUSHService setTags:[NSSet set] callbackSelector:nil object:self]; // 綁定 Alias,用 NSString [JPUSHService setAlias:@"" callbackSelector:nil object:self];
若要同時綁定 Alias 與 Tag,必須用以下方法(這裡我踩過坑):
// 同時綁定 Tag 與 Alias [JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];
一般在項目哪裡綁定?
我主要在用戶登錄成功或自動登錄後,用用戶唯一標識進行綁定,並按需添加一些前綴。
去除綁定
在用戶退出登錄的方法裡添加去除綁定即可。值得注意的是,若用到即時通訊,被擠下線時也要去除綁定(這裡我也踩過坑):
// 傳空值即代表去除 [JPUSHService setTags:[NSSet set] callbackSelector:nil object:self]; [JPUSHService setAlias:@"" callbackSelector:nil object:self]; [JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];
最後到極光平台測試推送:

只要推送成功,剩下的交給後台按 Alias 或 Tag 定點推送即可。JPush SDK 資源下載見原文。