• 推送证书设置指南
    • 创建应用
    • 创建和上传证书
  • 推送使用
    • 推送消息接收
    • 推送消息发送
      • Web端发送
      • app端发送
        • 广播推送
        • 组播推送
          • 1.根据订阅频道推送
          • 2.根据特定的查询条件进行推送
        • 点播推送

    推送证书设置指南

    创建应用

    1.进入并登录apple member center

    2.点击进入Certificates, Identifiers & Profiles

    iOS SDK 开发文档 - 图1

    3.点击进入iOS Apps下面的Provisioning Portal

    iOS SDK 开发文档 - 图2

    4.点击App IDs栏目中的加号,根据提示创建应用ID(图1),如图2所示,在创建过程中勾选Push Notification服务;

    图1

    iOS SDK 开发文档 - 图3

    iOS SDK 开发文档 - 图4

    图2

    iOS SDK 开发文档 - 图5

    创建和上传证书

    1.创建完成后再次点击应用,点击Edit;

    iOS SDK 开发文档 - 图6

    2.点击创建证书(图1),并根据提示创建证书(图2),

    图1

    iOS SDK 开发文档 - 图7

    图2

    iOS SDK 开发文档 - 图8

    3.生成证书后点击一下步,并上传刚刚创建好的证书,点击生成

    iOS SDK 开发文档 - 图9

    4.如图所示,点击Download下载APNs,完成后点击Done。

    iOS SDK 开发文档 - 图10

    5.导出.p12文件

    • 双击刚刚生成的.cer文件;

    iOS SDK 开发文档 - 图11

    • 进入”钥匙串访问”,选中刚刚导入的证书;

    iOS SDK 开发文档 - 图12

    • 选择导出项目(图1),导出.12文件,可以修改文件保存位置为桌面,方便后续上传(图2);

    图1

    iOS SDK 开发文档 - 图13

    图2

    iOS SDK 开发文档 - 图14

    • 点击存储,会提示设置密码,此处密码需为空,点击“好”,根据提示输入登录密码即可导出。

    iOS SDK 开发文档 - 图15

    6.按照1~5步创建开发证书

    iOS SDK 开发文档 - 图16

    7.进入Bmob后台,在消息推送的推送设置处上传刚刚生成的两个.p12文件,并且选择目前是开发状态还是生产状态(图1)。证书是具有有效时间的,需要注意在过期后重新生成

    图1

    iOS SDK 开发文档 - 图17

    图2

    iOS SDK 开发文档 - 图18

    推送使用

    使用Bmob的推送服务,需要添加BmobSDK及其依赖库,具体可以参考BmobSDK iOS快速入门

    推送消息接收

    接收推送消息需要做两件事情,一是注册远程推送,一是将注册后得到的Token值保存至服务器。

    1.注册远程推送,在AppDelegate.m中的- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中使用以下代码

    1. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    2. [Bmob registerWithAppKey:@"your appkey"];
    3. // Override point for customization after application launch.
    4. //注册推送,iOS 8的推送机制与iOS 7有所不同,这里需要分别设置
    5. if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0) {
    6. UIMutableUserNotificationCategory *categorys = [[UIMutableUserNotificationCategory alloc]init];
    7. //注意:此处的Bundle ID要与你申请证书时填写的一致。
    8. categorys.identifier=@"com.bmob.bmobpushdemo";
    9. UIUserNotificationSettings *userNotifiSetting = [UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound) categories:[NSSet setWithObjects:categorys,nil]];
    10. [[UIApplication sharedApplication] registerUserNotificationSettings:userNotifiSetting];
    11. [[UIApplication sharedApplication] registerForRemoteNotifications];
    12. }else {
    13. //注册远程推送
    14. UIRemoteNotificationType myTypes = UIRemoteNotificationTypeBadge|UIRemoteNotificationTypeAlert|UIRemoteNotificationTypeSound;
    15. [[UIApplication sharedApplication] registerForRemoteNotificationTypes:myTypes];
    16. }
    17. return YES;
    18. }

    2.在AppDelegate.m中添加以下代码,上传Token至服务器

    1. -(void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
    2. //注册成功后上传Token至服务器
    3. BmobInstallation *currentIntallation = [BmobInstallation installation];
    4. [currentIntallation setDeviceTokenFromData:deviceToken];
    5. [currentIntallation saveInBackground];
    6. }

    至此就可以接收到通知消息了。

    注意

    1. iOS的推送只能在真机上使用,因此测试只能在真机上进行。

    2. 项目一般需要设置自己的 Provisioning Profile ,如果是第一次跑该应用程序,可能会遇到以下问题,这是没有设置 Provisioning Profile 导致的。

    1. Domain=NSCocoaErrorDomain Code=3000 "未找到应用程序的“aps-environment”的权利字符串"

    解决过程如下:
    1)添加一个新的许可文件(如下图),将你要测试的设备添加入许可文件,并将该文件下载下来,双击安装至xcode;

    iOS SDK 开发文档 - 图19

    2)在Build Settings/Code Signing/Prvisioning Profile中选择刚刚导入至xcode的许可文件。

    iOS SDK 开发文档 - 图20

    3)在info.plist的Bundle identifier中填入Bundle ID即可,注意:此处的Bundle ID要与你申请证书时填写的一致。

    iOS SDK 开发文档 - 图21

    完成上述内容后,如果你的应用不是在运行状态,苹果的服务器就会发送推送至用户的设备上,并且由操作系统显示给用户,并不需要开发者做任何操作。如果推送到达时,应用是处于前台运行状态,开发者可以解析这条推送的内容。代码如下:

    1. - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{
    2. // 处理推送消息
    3. NSLog(@"userinfo:%@",userInfo);
    4. NSLog(@"收到推送消息:%@",[[userInfo objectForKey:@"aps"] objectForKey:@"alert"]);

    推送消息发送

    推送消息一种是直接在Web端进行发送,另外一种则是在app端进行发送。

    Web端发送

    完成以上步骤后,你可以运行应用程序,从web推送一条消息给客户端。

    iOS SDK 开发文档 - 图22

    在后台推送消息给Android和iOS两个平台的时候,有一些需要注意的:

    1、由于Android和iOS的提送机制不同,iOS要经过APNS,Android的推送完全是走Bmob的长连接服务,为兼容这个问题,如果你选择发送格式为“json”格式时,需要添加APNS兼容头部(见下面json的aps部分),推送内容格式如下:

    1. {
    2. "aps": {
    3. "sound": "cheering.caf",
    4. "alert": "这个是通知栏上显示的内容",
    5. "badge": 0
    6. },
    7. "xx" : "json的key-value对,你可以根据情况添加更多的,客户端进行解析获取",
    8. }

    其中,sound是iOS接收时的声音,badge是iOS通知栏的累计消息数(目前该值服务器并没有主动处理,需要开发者自行维护该值)。

    2、如果你选择发送格式为“text”时,推送内容为“推送消息测试。。。。”,Bmob会自动添加aps部分发送给APNS,,相当于自动生成如下的json格式的推送内容:

    1. {
    2. "aps": {
    3. "alert": "推送消息测试。。。。",
    4. }
    5. }

    同时,也会发送给Android端,相当于自动生成如下的json格式的推送内容:

    1. {
    2. "alert" : "推送消息测试。。。。",
    3. }

    3、如果只是发送给Android端,大家可以自定义json格式的数据。

    4、由于iOS的APNS的推送的大小是有限制的,默认最多256bytes,因此,如果你需要跨平台互通的话,需注意推送的内容不要太长。

    5、想要更多了解Bmob的推送格式的朋友,如即时聊天,可以查看我们在问答社区中的回答:http://wenda.bmob.cn//?/question/204

    app端发送

    app端推送我们可以有以下类型

    1. 广播推送,即给所有安装了该应用的设备发送推送
    2. 组播推送,即给特定用户群发送推送
    3. 点播推送,即给特定某一用户发送推送
    广播推送

    采用以下代码

    1. BmobPush *push = [BmobPush push];
    2. //设置推送消息
    3. [push setMessage:@"所有人的推送的消息"];
    4. //发送推送
    5. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    6. NSLog(@"error %@",[error description]);
    7. }];
    组播推送

    可以自定义筛选条件给特定的用户群进行推送,这里我们将通过案例来说明如何使用组播推送。

    1.根据订阅频道推送

    如我们做电台应用,只希望给订阅了特定频道的用户进行推送,我们可以使用利用在Intallation表中定义了的channels字段,我们可以设置该字段,然后只给订阅了特定channels的用户推送消息。首先,来看看如何设置该字段。

    覆盖已订阅的频道:

    1. BmobInstallation *currentIntallation = [BmobInstallation objectWithoutDatatWithClassName:nil objectId:@"szK8444I"];
    2. [currentIntallation setObject:@[@"Giants",@"Mets"] forKey:@"channels"];
    3. [currentIntallation updateInBackground];

    订阅一个新频道,不覆盖已订阅的频道:

    1. BmobInstallation *currentIntallation = [BmobInstallation objectWithoutDatatWithClassName:nil objectId:@"szK8444I"];
    2. [currentIntallation subscribeFromChannels:@[@"Giants"]];
    3. [currentIntallation updateInBackground];

    退订一个订阅频道

    1. BmobInstallation *currentIntallation = [BmobInstallation objectWithoutDatatWithClassName:nil objectId:@"szK8444I"];
    2. [currentIntallation unsubscribeFromChannels:@[@"Giants"]];
    3. [currentIntallation updateInBackground];

    设置好订阅频道后我们可以给订阅了特定频道的用户推送消息,代码如下:

    1. BmobPush *push = [BmobPush push];
    2. [push setMessage:@"推送给订阅了体育频道的用户"];
    3. [push setChannel:@"Sports"];
    4. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    5. NSLog(@"error %@",[error description]);
    6. }];
    2.根据特定的查询条件进行推送

    我们可以设置查询条件,然后给符合条件的用户进行推送,样例如下:

    1. BmobQuery *query = [BmobInstallation query];
    2. //设置查询条件
    3. ...
    4. BmobPush *push = [BmobPush push];
    5. [push setQuery:query];
    6. [push setMessage:@"推送给满足条件的用户"];
    7. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    8. NSLog(@"error %@",[error description]);
    9. }];

    如我们可以根据平台进行推送

    1)推送给安卓用户

    1. BmobPush *push = [BmobPush push];
    2. BmobQuery *query = [BmobInstallation query];
    3. [query whereKey:@"deviceType" equalTo:@"android"];
    4. [push setQuery:query];
    5. [push setMessage:@"推送给安卓用户的消息"];
    6. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    7. NSLog(@"error %@",[error description]);
    8. }];

    2)推送给苹果用户

    1. BmobPush *push = [BmobPush push];
    2. BmobQuery *query = [BmobInstallation query];
    3. [query whereKey:@"deviceType" equalTo:@"ios"];
    4. [push setQuery:query];
    5. push setMessage:@"推送给苹果用户的消息"];
    6. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    7. NSLog(@"error %@",[error description]);
    8. }];
    点播推送

    给特定的用户发送信息,推送给安卓用户与推送给苹果用户有所区别,样例如下:

    1、发送给单个安卓用户

    1. BmobPush *push = [BmobPush push];
    2. BmobQuery *query = [BmobInstallation query];
    3. [query whereKey:@"installationId" equalTo:@"xxxxxxxxxxxxxxxx"];
    4. [push setQuery:query];
    5. [push setMessage:@"推送给某个安卓用户的消息"]
    6. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    7. NSLog(@"error %@",[error description]);
    8. }];

    2、推送给单个苹果用户

    1. BmobPush *push = [BmobPush push];
    2. BmobQuery *query = [BmobInstallation query];
    3. [query whereKey:@"deviceToken" equalTo:@"xxxxxxxxxxxxxxxx"];
    4. [push setQuery:query];
    5. [push setMessage:@"推送给某个苹果用户的消息"]
    6. [push sendPushInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
    7. NSLog(@"error %@",[error description]);
    8. }];