iOS极光推送

时间 2019-11-20

标签 ios 极光推送栏目 iOS 繁體版

原文原文链接

昨天花了一下午的时间研究了下极光推送，也前也是没作过，不知道从何下手！才开始的时候一看官方的SDK感受好难，不过通过一系列的捣鼓以后，手机收到了推送信息，感受其实并无那么难！ios

1.配置开发证书（得有开发者帐号，我的，企业的均可以）

开发环境测试

在对 JPush iOS 开发环境进行测试前，请确保 3 个统一：api

App 是开发环境打包（开发证书 Development）
上传了开发证书并验证经过
Portal 上的应用设置为开发环境

发布环境测试

在对 JPush iOS 生产环境进行测试前，请确保 3 个统一：xcode

App 是 ad-hoc 打包或者App Store 版本（发布证书 Production）
上传了发布证书并验证经过
Portal 上的应用设置为生产环境

iOS 证书设置指南

建立应用程序ID

在 iOS Provisioning Portal中，点击App IDs进入App ID列表。

建立 App ID，若是 ID 已经存在能够直接跳过此步骤

为 App 开启 Push Notification 功能。若是是已经建立的 App ID 也能够经过设置开启 Push Notification 功能。

根据实际状况完善 App ID 信息并提交,注意此处须要指定具体的 Bundle ID 不要使用通配符。app

配置和下载证书

若是你以前没有建立过 Push 证书或者是要从新建立一个新的，请在证书列表下面新建。

新建证书须要注意选择证书种类（开发证书用于开发和调试使用，生产证书用于 App Store 发布）

点击 Continue 后选择证书对应的应用ID，而后继续会出现“About Creating a Certificate Signing Request (CSR)”。

根据它的说明建立打开KeychainAccess 建立 Certificate Signing Request。

填写“User Email Address”和“Common Name” 后选择 Saved to disk 进行保存。

继续返回Apple developer 网站点击 Continue ，上传刚刚生成的 .certSigningRequest 文件生成 APNs Push Certificate。
下载并双击打开证书，证书打开时会启动“钥匙串访问”工具。
在“钥匙串访问”中你的证书会显示在“个人证书”中，注意选择“My Certificates” 和"login"

导出 .p12 证书文件

注意要选“login”和“My Certificates” 导出证书时要选中证书文件，不要展开private key。

将文件保存为Personal Information Exchange (.p12)格式。

将文件保存为Personal Information Exchange (.p12)格式。

上传证书

在 JPush 管理 Portal 上，针对某应用程序，上传上面步骤获得 .p12 证书文件。这是 iOS SDK 可以接收到 JPush 推送消息的必要步骤。框架

Provisioning Profile的建立

建立Provisioning Profile的前提，已在Apple Developer网站建立待发布应用所使用的Bundle ID的App ID，且为该App ID建立了APNs证书，以下图:

建立App ID、APN证书和p12证书的导出的具体步骤请看 :iOS 证书设置指南less
在苹果开发者帐号的Provisioning Profile页面点击下图按钮，建立Provisioning Profileide

选择此Provisioning Profile的环境后点击[Continue]：

选择要建立Provisioning Profile的App ID后点击[Continue]：

选择所属的开发者证书，（这里建立了多个开发者证书，建议只建立一个，方便管理）为了方便，选择了[Select All]，再点击[Continue]进入下一步：

为该Provisioning Profile选择将要安装的设备（通常选择[Select All]），点击[Continue]:

给该Provisioning Profile填写Profile Name，点击[generate]完成建立。

填写完Profile Name后点击[generate]完成建立，以后点击[DownLoad]下载Provisioning Profile

双击下载下来的Provisioning Profile，添加到xcode。

2. Xcode的证书配置教程

参照iOS SDK 集成指南集成JPush SDK 和上传了推送用到的p12证书后在编译运行前须要先配置一下证书，步骤以下：工具

打开xxx-info.plist的Bundle identifier项把上传到JPush 控制台的bundle id填写进去：

点击项目，选择目标TARGETS后进入Build Setting 界面，搜索“Code signing”，按照下图配置

客户端设置

开启Remote notifications

须要在Xcode 中修改应用的 Capabilities 开启Remote notifications，请参考下图：测试

3.SDK集成步骤

集成压缩包内容

包名为JPush-iOS-SDK-{版本号}fetch

lib文件夹：包含头文件 JPUSHService.h，静态库文件jpush-ios-x.x.x.a ，支持的iOS版本为 5.0 及以上版本。（请注意：模拟器不支持APNs）
pdf文件：集成指南
demo文件夹：示例

开发环境

使用Xcode 6及以上版本可使用新版Push SDK，XCode 5环境下须要运行旧版本SDK(1.7.4)

一、在JPush Portal上建立应用

在 JPush的管理Portal 上建立应用并上传APNs证书。若是对APNs证书不太了解请参考： iOS 证书设置指南

建立成功后自动生成 AppKey 用以标识该应用。

二、导入API开发包到应用程序项目

将SDK包解压，在XCode中选择“Add files to 'Your project name'...”，将解压后的lib子文件夹（包含JPUSHService.h、jpush-ios-x.x.x.a）添加到你的工程目录中。

三、必要的框架

CFNetwork.framework
CoreFoundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Foundation.framework
UIKit.framework
Security.framework
Xcode7须要的是libz.tbd；Xcode7如下版本是libz.dylib

四、Build Settings

若是你的工程须要支持小于7.0的iOS系统，请到Build Settings 关闭 bitCode 选项，不然将没法正常编译经过。

设置 Search Paths 下的 User Header Search Paths 和 Library Search Paths，好比SDK文件夹（默认为lib）与工程文件在同一级目录下，则都设置为"$(SRCROOT)/{静态库所在文件夹名称}"便可。

五、建立并配置PushConfig.plist文件

2.1.0 版本开始，新增了带参数的setupWithOption初始化方法，可经过此方法等参数传入AppKey等信息。1.8.8及以前版本的 JPush SDK只能经过PushConfig.plist配置AppKey等信息。

在你的工程中建立一个新的Property List文件，并将其命名为PushConfig.plist，文件所含字段以下：

CHANNEL
- 指明应用程序包的下载渠道，为方便分渠道统计，具体值由你自行定义，如：App Store。
APP_KEY
- 填写管理Portal上建立应用后自动生成的AppKey值。请确保应用内配置的 AppKey 与第1步在 Portal 上建立应用后生成的 AppKey 一致。
APS_FOR_PRODUCTION
- 1.3.1版本新增，用于标识当前应用所使用的APNs证书环境。
- 0 (默认值)表示采用的是开发证书，1 表示采用生产证书发布应用。
- 注：此字段的值要与Build Settings的Code Signing配置的证书环境一致。
在1.2.2或以前版本的配置文件中，有 TEST_MODE 这个键，新版的SDK再也不使用，能够将它删除。

PushConfig.plist文件示例图:

六、添加代码

2.1.0版本开始,API类名为JPUSHService，再也不使用原先的APService。

容许XCode7支持Http传输方法

若是用的是Xcode7时，须要在App项目的plist手动加入如下key和值以支持http传输:

<key>NSAppTransportSecurity</key> 
      <dict> 
  <key>NSAllowsArbitraryLoads</key> 
        <true/> 
    </dict>

集成所需API

APIs 主要集中在 JPUSHService 接口类里。

初始化JPush方法分为两个：
- 1.8.8及如下版本使用的是已过时的初始化方法。升级到2.1.0的老用户仍可继续使用旧的初始化方法。
- 2.1.0版本开始提供带appkey等参数的新初始化方法。使用此方法无需再添加PushConfig.plist配置JPush的AppKey等字段。

4.项目代码：

AppDelegate.h里面的代码：

#import<UIKit/UIKit.h>

staticNSString *appKey = @"4fd48a0712a3fde75eb1c7423";//申请应用成功之后官方会提供给你

staticNSString *channel = @"Publish channel";

staticBOOL isProduction = FALSE;

@interface AppDelegate :UIResponder <UIApplicationDelegate>

@property (strong,nonatomic) UIWindow *window;

@end

#import"AppDelegate.m"中的代码

#import "AppDelegate.h"

#import "JPUSHService.h"

@interface AppDelegate ()

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

// Override point for customization after application launch.

self.window.backgroundColor = [UIColorwhiteColor];

[self.windowmakeKeyAndVisible];

if ([[UIDevicecurrentDevice].systemVersionfloatValue] >= 8.0) {

//能够添加自定义categories

[JPUSHServiceregisterForRemoteNotificationTypes:(UIUserNotificationTypeBadge |

UIUserNotificationTypeSound |

UIUserNotificationTypeAlert)

categories:nil];

} else {

//categories 必须为nil

[JPUSHServiceregisterForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |

UIRemoteNotificationTypeSound |

UIRemoteNotificationTypeAlert)

categories:nil];

}

[JPUSHServicesetupWithOption:launchOptions appKey:appKey

channel:channelapsForProduction:NO];

returnYES;

}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

// Required

[JPUSHServiceregisterDeviceToken:deviceToken];

}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {

// Required,For systems with less than or equal to iOS6

[JPUSHServicehandleRemoteNotification:userInfo];

}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

// IOS 7 Support Required

[JPUSHServicehandleRemoteNotification:userInfo];

completionHandler(UIBackgroundFetchResultNewData);

}

- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {

//Optional

NSLog(@"did Fail To Register For Remote Notifications With Error: %@", error);

}

- (void)applicationWillResignActive:(UIApplication *)application {

// Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.

// Use this method to pause ongoing tasks, disable timers, and throttle down OpenGL ES frame rates. Games should use this method to pause the game.

}

- (void)applicationDidEnterBackground:(UIApplication *)application {

// Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.

// If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.

}

- (void)applicationWillEnterForeground:(UIApplication *)application {

// Called as part of the transition from the background to the inactive state; here you can undo many of the changes made on entering the background.

}

- (void)applicationDidBecomeActive:(UIApplication *)application {

// Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.

}

- (void)applicationWillTerminate:(UIApplication *)application {

// Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.

}

@end

4.真机测试：

登录到极光推送官网:

点击控制台：

选择应用，也就是你建立测试的项目：个人项目是aa.TestPush

选中之后点击进入到下面这里：

点击上面的推送：

点击左边的发送通知，也能够选择自定义消息(这里我选择的发送通知)：

这里我随便写点什么用我手机测试：

点击当即发送：

手机上的显示：

iOS极光推送

1.配置开发证书（得有开发者帐号，我的，企业的均可以）

开发环境测试

发布环境测试

iOS 证书 设置指南

建立应用程序ID

配置和下载证书

导出 .p12 证书文件

上传证书

Provisioning Profile的建立

2. Xcode的证书配置教程

客户端设置

开启Remote notifications

3.SDK集成步骤

集成压缩包内容

开发环境

一、在JPush Portal上建立应用

二、导入API开发包到应用程序项目

三、必要的框架

四、Build Settings

五、建立并配置PushConfig.plist文件

六、添加代码

容许XCode7支持Http传输方法

集成所需API

4.项目代码：

4.真机测试：

iOS 证书设置指南