您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS 集成極光推送,繞開那些容易踩的坑

編輯:iOS 開發基礎

最近公司要求把維護期的項目都集成極光推送,過程中踩到幾個小坑,特此總結記錄。

極光推送能幹嘛?

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 資源下載見原文。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved