打开 云巴官方网站, 点击注册创建账号。
注册账号成功跳转到我的应用界面,点击“创建应用”,输入应用名称
打开 开发者资源页面 下载 iOS SDK, iOS SDK 包含 DEMO 程序和开发者所需嵌入的 lib 库以及头文件。
下载的 YunBa-iOS-sdk 包并添加到项目中,并且添加依赖库SystemConfiguration.framework。
添加头文件,引入YunBaService.h
:
#import "YunBaService.h"
从portal获取AppKey:
注: 请使用从 Portal 获取到的 AppKey 替换代码中的 AppKey。
初始化 SDK 并订阅 Topic,在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
中添加初始化和订阅代码:
[YunBaService setupWithAppkey:AppKey];
[YunBaService subscribe:topic resultBlock:^(BOOL succ, NSError *error){
if (succ) {
NSLog(@"[result] subscribe to topic(%@) succeed", topic);
} else {
NSLog(@"[result] subscribe to topic(%@) failed: %@, recovery suggestion: %@", topic, error, [error localizedRecoverySuggestion]);
}
}];
在默认消息中心添加的监听代码:
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onMessageReceived:) name:kYBDidReceiveMessageNotification object:nil];
消息处理代码:
- (void)onMessageReceived:(NSNotification *)notification {
YBMessage *message = [notification object];
NSString *payloadString = [[NSString alloc] initWithData:[message data] encoding:NSUTF8StringEncoding];
NSLog(@"[Message] %@ => %@", [message topic], payloadString);
}
打开应用详情页面,点击发布消息,如图所示:
打开应用详情页面,点击发布上报统计可以查看消息发布实时送达比,如图所示:
打开应用详情页面,点击在线用户统计可以查看当前在线用户数,用户活跃数等信息,如图所示:
打开编辑应用页面,点击 “选择文件” 按钮,上传证书文件(*.p12)。如果证书导出时设置了密码,则需将密码填写在 “证书密码” 一栏。
此外,iOS SDK 还支持 “多证书” 功能。用户可以点击左侧的 “添加更多证书” 的按钮,上传多个证书(暂无数量限制),从而实现对同一应用的不同版本进行推送。
证书添加完成后,请点击 “提交” 按钮,保存设置。
打开 Apple 开发者网站的 证书管理界面
点击新建证书
选择新建证书的类型(开发或者生产推送环境)
注:如果你的系统中没有中间签名证书,则需要下载并安装到你的系统中:
为证书选择对应需要推送功能的APP ID:
为制作推送证书,需要有一个CSR文件用以使新生成的推送证书与私钥相匹配:
注:如果你没有CSR文件,则需要新建一个,步骤如下:
a. 打开钥匙串访问
b. 申请创建CSR文件
c. 输入你的邮件等信息后保存CSR文件到本地磁盘
点击继续之后生成APNs证书成功,然后点击下载即可
导出证书为p12文件
导出时可以添加自定义密码以提高安全性:
制作完成后,在 Portal 上传APNs证书以激活APN推送功能
注意:如果你使用生产和开发证书两个证书来进行推送:云巴会在使用的过程中根据 SDK 上报的状态自动选择生产或者开发证书,也就是说消息会推送给使用开发或生产证书的所有设备。如果需要仅发送给一个证书下的app的话建议在推送前删除另一个证书。