iOS极光推送文档
一、创建工程
Product Name:baixin
Company Identifier:com.bluewave
Bundle Identifier:com.bluewave.baixin
二、申请证书
1.创建应用程序ID
a.登陆 选择进入iOS Provisioning Portal。
b.在 中,点击App IDs进入App ID列表。
c. 创建 App ID,如果 ID 已经存在可以直接跳过此步骤
d. 根据实际情况完善 App ID 信息并提交,注意此处需要指定具体的 Bundle ID 不要使用通配符。
注:此错误表示有相同的App ID,不需再创建
e. 为 App 开启 Push Notification 功能。如果是已经创建的 App ID 也可以通过设置开启 Push Notification 功能。
f.到此App ID以创建好,后面直接点击submit即可。
2.配置和下载证书
a.如果你之前没有创建过 Push 证书或者是要重新创建一个新的,请在证书列表下面新建。
b.新建证书需要注意选择证书种类(开发证书用于开发和调试使用,生产证书用于 App Store 发布)
注:在发布应用时,这4个证书都需要创建,测试时,只需两个就可以了
c.点击 Continue 后选择证书对应的应用ID,然后继续会出现“About Creating a Certificate Signing Request (CSR)”。
d.点击Continue,到后面如下这一步
e.创建证书签名请求(CSR)
f.点击继续,储存一个.certSigningRequest的csr文件。
g.继续上面的d步骤,将. certSigningRequest添加进来,然后进入下面页面
h.将这步骤如此操作4次,创建好证书。
3.导出.p12证书文件( 两个都要导出)
a. 将推送证书双击,在“钥匙串访问”中你的证书会显示在“我的证书”中,注意选择“MyCertificates” 和"login",导出证书时要选中证书文件,不要展开private key。
b.点击导出,并命名为xxx.p12文件
c.点击save后,会出现这个窗口,这里的密码可以不用设置,直接下一步。但是如果你设置了就必须记住,后面创建应用那里需要用到。。。
4.创建配置文件(Provisioning Profiles)
a.这里至少一个开发,一个生产
b.下一步
c.到这里选择将要运行的设备,你可以只选某一个,当你不确定时,也可以全选。。。。
d.现在配置文件也建好了,下载保存就好。。。。
嘿嘿…….如下就是创建出来的所有证书了。。。。
OK啦~~~~~,证书什么的都好了,下面来上传证书了。。。。
三、上传证书
a. 进入极光推送页面。(先注册一个极光账号)
b.创建应用
现在应用就创建好了,接下来就是更改工程中的一些设置了。。。。。
四、操作工程文件
1.导入API开发包到应用程序项目
a.将SDK包解压,在XCode中选择“Add files to 'Your project name'...”,将解压后的lib子文件夹(包含APService.h、libPushSDK.a)添加到你的工程目录中。
2.必要的框架
- CFNetwork.framework
- CoreFoundation.framework
- CoreTelephony.framework
- SystemConfiguration.framework
- CoreGraphics.framework
- Foundation.framework
- UIKit.framework
- Security.framework
- libz.dylib
3.Build Settings
a .设置 Search Paths 下的 User Header Search Paths 和 Library Search Paths,比如SDK文件夹(默认为lib)与工程文件在同一级目录下,则都设置为"$(SRCROOT)/[文件夹名称]"即可。
4.创建并配置PushConfig.plist文件
a .在你的工程中创建一个新的Property List文件,并将其命名为PushConfig.plist,填入Portal为你的应用提供的APP_KEY等参数。
{ "APS_FOR_PRODUCTION = "0"; "CHANNEL" = "Publish channel"; "APP_KEY" = "AppKey copied from JPush Portal application"; } |
- CHANNEL
- 指明应用程序包的下载渠道,为方便分渠道统计。根据你的需求自行定义即可。
- APP_KEY
- 在时自动生成的(AppKey)用以标识该应用。请确保应用内配置的 AppKey 与第1步在 Portal 上创建应用时生成的 AppKey 一致,AppKey 可以在应用详情中查询。
- APS_FOR_PRODUCTION
- 1.3.1版本新增,表示应用是否采用生产证书发布( Ad_Hoc 或 APP Store ),0 (默认值)表示采用的是开发者证书,1 表示采用生产证书发布应用。请注意此处配置与 Web Portal 应用环境设置匹配。
- 在1.2.2或之前版本的配置文件中,有 TEST_MODE 这个键,新版的SDK不再使用,可以将它删除。
5.添加关键代码
1.- (BOOL)application: didFinishLaunchingWithOptions: 方法里:
五、常见的错误
1.
解决办法:
2.点击通知进入应用后,通知栏的消息删除,并且应用上的badge number为0
解决办法:
注意:
1.对于badge number需要后台在推送时设置+1或 -1.
2.对于生产环境还是开发环境都是由后台来设置
3.客户端需要给服务器传递tag、alias
4.如果在同一个应用上切换用户a/b,第一个用户的alias会被第二个的alias覆盖掉,不过第一个用户的离线消息还有效,这种情况你可以把离线保存时间设置长点