jpush推送
其正常工作的必要条件是:JPush SDK 与 JPush Server 的网络保持着连接。请参考这篇文章来做进一步的理解:极光推送技术原理:移动无线网络长连接。
开发者集成 JPush Android SDK 到其应用里,JPush Android SDK 创建到 JPush Cloud 的长连接,为 App 提供永远在线的能力。
当开发者想要及时地推送消息到达 App 时,只需要调用 JPush API 推送,或者使用其他方便的智能推送工具,即可轻松与用户交流。
图中红色部分,是 JPush 与 App 开发者的接触点。手机客户端侧,App 需要集成 JPush SDK;服务器端部分,开发者调用 JPush REST API 来进行推送。
Android SDK 服务
JPush Android SDK 是作为 Android Service 长期运行在后台的,从而创建并保持长连接,保持永远在线的能力。JPush可推送的内容如下
- 其中
红包
需要集成第三方SDK - 区别通知于自定义消息
通知即指在手机的通知栏(状态栏)上会显示的一条通知信息。
自定义消息是极光推送自己的概念。
自定义消息不是通知,所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。
自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来,有可能没有任何界面显示
使用Jcenter自动集成说明
使用jcenter自动集成的开发者,不需要在项目中添加jar和so,jcenter会自动完成依赖;在AndroidManifest.xml中不需要添加任何JPush SDK 相关的配置,jcenter会自动导入。
如果开发者需要修改组件属性,可以在本地的 AndroidManifest 中定义同名的组件并配置想要的属性,然后用 xmlns:tools 来控制本地组件覆盖 jcenter 上的组件。
集成步骤
- 当然先要注册开发者账号
- 下载对应平台的SDK(android/ios/windowsphone/...)
- 配置
- 开发
- 测试推送
来一波最easy的demo
以android项目为例,使用Android Studio自动集(jcenter)成极光推送
- 创建AS项目
- 在JPUSH平台创建应用,获取
appkey
,创建时需提供项目的包名 - 在
module:app
下的build.gradle
中添加依赖
compile 'cn.jiguang.sdk:jpush:3.0.3' // 此处以JPush 3.0.3 版本为例。 compile 'cn.jiguang.sdk:jcore:1.1.1' // 此处以JCore 1.1.1 版本为例。
-
module:app
下的build.gradle
>defaultConfig{}
中添加以下代码
ndk {
//选择要添加的对应cpu类型的.so库。
abiFilters 'armeabi', 'armeabi-v7a', 'armeabi-v8a'
// 还可以添加 'x86', 'x86_64', 'mips', 'mips64'
}
manifestPlaceholders = [
JPUSH_PKGNAME : applicationId,
JPUSH_APPKEY : "eabbe4d26af31ef9b397c3a7", //JPush上注册的包名对应的appkey.
JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
]
配置完毕了,点击一下如图按钮,as自动集成所需,不报错就可以进行下一项了
- 在项目的Application中进行初始化JPUSH的SDK
@Override
public void onCreate() {
super.onCreate();
//初始化
JPushInterface.init(this);
//开启调试
JPushInterface.setDebugMode(true);
}
- 在JPUSH控制台进行推送测试
测试结果提示:
- 按以上操作就简单集成了,后台推送的消息也能准确接收到
- 在系统通知栏可以看见图标为
android
中经典的icon(机器人图标) -
发送通知
和富媒体消息
下的URL
消息可准确收到 -
自定义消息
后台显示成功,通知栏不显示(这个属于正常情况,需显示还需要自己操作) -
富媒体消息
下的模板
后台显示发送成功,手机上未收到消息
针对以上出现问题的(使用jcenter集成)解决方案
如何设置推送显示项目所需的图标?
官方文档特别说明
说明:若没有res/drawable-xxxx/jpush_notification_icon这个资源默认使用应用图标作为通知icon,在5.0以上系统将应用图标作为statusbar icon可能显示不正常,用户可定义没有阴影和渐变色的icon替换这个文件,文件名不要变。
尝试:将自己的图片改名为jpush_notification_icon
放到res/drawable-xxxx
文件夹,重新运行仍然显示默认icon
- 终极方案
基于上面出现的问题,如何才能接收到富媒体消息?
原因:未配置PushActivity组件
必须将压缩包 res 中的资源放到我们自己的项目的对应文件夹,并按照官方示例AndroidManifest.xml
配置 PushActivity 组件终极方案
基于上面出现的问题,如何才能接收到自定义消息并显示到所发送的消息?
自定义消息:SDK 不会把自定义消息展示到通知栏。
调试时,需要到日志里才可以看到服务器端推送的自定义消息。自定义消息一定要由开发者写 接收推送消息 来处理收到的消息
- 自定义广播接收器
MyReceiver
(采用静态注册方式) -
AndroidManifest.xml
注册广播配置,这里添加所有action
具体项目可根据实际情况配置
<receiver android:name=".MyReceiver"
android:enabled="true"
>
<intent-filter>
<action android:name="cn.jpush.android.intent.REGISTRATION" />
<action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />
<action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
<action android:name="cn.jpush.android.intent.NOTIFICATION_CLICK_ACTION" />
<action android:name="cn.jpush.android.intent.CONNECTION" />
<category android:name="com.pushdemo" />
</intent-filter>
</receiver>
广播中的每个action
详情功能说明,请查看官方文档API-接收推送消息Receiver
附上项目完整MyReceiver
public class MyReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Bundle bundle = intent.getExtras();
Log.d(TAG, "onReceive - " + intent.getAction());
if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
} else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
// 自定义消息不会展示在通知栏,完全要开发者写代码去处理
String content = bundle.getString(JPushInterface.EXTRA_MESSAGE);
String extra = bundle.getString(JPushInterface.EXTRA_EXTRA);
Toast.makeText(context, "自定义消息" + content + "\nextra" + extra, Toast.LENGTH_SHORT).show();
//TODO 可推送json过来,接收到再解析
} else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
System.out.println("收到了通知");
// 在这里可以做些统计,或者做些其他工作
} else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent
.getAction())) {
System.out.println("用户点击打开了通知");
// 在这里可以自己写代码去定义用户点击后的行为
Intent i = new Intent(context, MainActivity.class); // 自定义打开的界面
i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(i);
} else {
Log.d(TAG, "Unhandled intent - " + intent.getAction());
}
}
}
持续更新中.......