消息推送在APP应用中越来越普遍，来记录一下项目中用到的一种推送方式，对于Andriod它并没有自己的原生推送机制，一种简单的推送方式是采用第三方推送服务的方式，即通过嵌入SDK使用第三方提供的推送服务，主流的有百度云推送，极光推送，友盟，个推、亚马逊等等。本篇博文只介绍采用极光推送的方式。
如果你是一个新手，建议你先看完本篇博客，然后在去看官网，这样也许上手会快一些。
关键步骤：
1.在极光官网先注册一个账号，创建一个应用，获取AppKey、Master Secret （官网：https://www.jiguang.cn/）
2.在java项目中导入依赖的jar包，如果你是maven项目，在pom文件中添加依赖即可。
3.创建一个JPushUtil类，代码放在下面。
详细步骤
1.登录极光官网，注册一个账号
2.选择“开发者服务”—“极光推送”—“立即体验”
3.创建一个应用
4.点击新创建的应用，获取AppKey和Master Secret
5.在java项目中导入依赖包，（可参考官网：https://docs.jiguang.cn/jpush/server/sdk/java_sdk/#_2）
maven 方式
将下边的依赖条件放到你项目的 maven pom.xml 文件里。
<dependency>
<groupId>cn.jpush.api</groupId>
<artifactId>jpush-client</artifactId>
<version>3.3.9</version>
</dependency>
jar 包方式
请到 Release页面下载相应版本的发布包。
依赖包
其中 slf4j 可以与 logback, log4j, commons-logging 等日志框架一起工作，可根据你的需要配置使用。
如果使用 Maven 构建项目，则需要在你的项目 pom.xml 里增加：
<dependency>
<groupId>cn.jpush.api</groupId>
<artifactId>jiguang-common</artifactId>
<version>1.1.3</version>
</dependency>
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.1.6.Final</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.3</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.7</version>
</dependency>
<!-- For log4j -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.7</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
如果不使用 Maven 构建项目，则项目 libs/ 目录下有依赖的 jar 可复制到你的项目里去。
6.创建JPushUtil类，该类中给出了使用与Android和ios的方法，以及两者都适用的方法，代码如下：
/**
* 极光推送工具类
* Created by DUYU on 2019/1/17.
*/
public class JPushUtil {
// 设置好账号的app_key和masterSecret是必须的
private static String APP_KEY = "fcc67*************ba80d76";
private static String MASTER_SECRET = "a4c45*************cc0";
//极光推送>>Android
//Map<String, String> parm是我自己传过来的参数,可以自定义参数
public static void jpushAndroid(Map<String, String> parm) {
//创建JPushClient(极光推送的实例)
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);
//推送的关键,构造一个payload
PushPayload payload = PushPayload.newBuilder()
.setPlatform(Platform.android())//指定android平台的用户
.setAudience(Audience.all())//你项目中的所有用户
// .setAudience(Audience.alias(parm.get("alias")))//设置别名发送,单发，点对点方式
//.setAudience(Audience.tag("tag1"))//设置按标签发送，相当于群发
// .setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户
.setNotification(Notification.android(parm.get("msg"), parm.get("title"), parm)) //发送内容
.setOptions(Options.newBuilder().setApnsProduction(true).setTimeToLive(7200).build())
// apnProduction指定开发环境 true为生产模式 false 为测试模式 (android不区分模式,ios区分模式) 不用设置也没关系
// TimeToLive 两个小时的缓存时间
.setMessage(Message.content(parm.get("msg")))//自定义信息
.build();
try {
PushResult pu = jpushClient.sendPush(payload);
System.out.println(pu.toString());
} catch (APIConnectionException e) {
e.printStackTrace();
} catch (APIRequestException e) {
e.printStackTrace();
}
}
//极光推送>>ios
//Map<String, String> parm是我自己传过来的参数,可以自定义参数
public static void jpushIOS(Map<String, String> parm) {
//创建JPushClient
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);
PushPayload payload = PushPayload.newBuilder()
.setPlatform(Platform.ios())//ios平台的用户
.setAudience(Audience.all())//所有用户
//.setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户
.setNotification(Notification.newBuilder()
.addPlatformNotification(IosNotification.newBuilder()
.setAlert(parm.get("msg"))
.setBadge(+1)
.setSound("happy")//这里是设置提示音(更多可以去官网看看)
.addExtras(parm)
.build())
.build())
.setOptions(Options.newBuilder().setApnsProduction(false).build())
.setMessage(Message.newBuilder().setMsgContent(parm.get("msg")).addExtras(parm).build())//自定义信息
.build();
try {
PushResult pu = jpushClient.sendPush(payload);
System.out.println(pu.toString());
} catch (APIConnectionException e) {
e.printStackTrace();
} catch (APIRequestException e) {
e.printStackTrace();
}
}
//极光推送>>All所有平台
public static void jpushAll(Map<String, String> parm) {
//创建JPushClient
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);
//创建option
PushPayload payload = PushPayload.newBuilder()
.setPlatform(Platform.all()) //所有平台的用户
.setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户
.setNotification(Notification.newBuilder()
.addPlatformNotification(IosNotification.newBuilder() //发送ios
.setAlert(parm.get("msg")) //消息体
.setBadge(+1)
.setSound("happy") //ios提示音
.addExtras(parm) //附加参数
.build())
.addPlatformNotification(AndroidNotification.newBuilder() //发送android
.addExtras(parm) //附加参数
.setAlert(parm.get("msg")) //消息体
.build())
.build())
.setOptions(Options.newBuilder().setApnsProduction(true).build())//指定开发环境 true为生产模式 false 为测试模式 (android不区分模式,ios区分模式)
.setMessage(Message.newBuilder().setMsgContent(parm.get("msg")).addExtras(parm).build())//自定义信息
.build();
try {
PushResult pu = jpushClient.sendPush(payload);
System.out.println(pu.toString());
} catch (APIConnectionException e) {
e.printStackTrace();
} catch (APIRequestException e) {
e.printStackTrace();
}
}
}
7.DEMO测试类
public class demo {
public static void main(String[] args) {
//设置推送参数
//这里可以自定义推送参数了
Map<String, String> parm = new HashMap<String, String>();
//设置提示信息,内容是文章标题
parm.put("msg","收到请联系发送人");
parm.put("title","这里是title");
parm.put("alias","abc");
JPushUtil.jpushAndroid(parm);
}
}测试结果：
8.极光后台查看
在极光后台可以查看推送历史，登录极光后台，在应用的下方点击“推送”
选择Api
点击“操作”查看详情
9。参数信息：
（来自于官方文档https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/#platform）
platform：推送平台
JPush 当前支持 Android, iOS, Windows Phone 三个平台的推送。其关键字分别为："android", "ios", "winphone"。
如果目标平台为 iOS 平台，推送 Notification 时需要在 options 中通过 apns_production 字段来设定推送环境。True 表示推送生产环境，False 表示要推送开发环境； 如果不指定则为推送生产环境；一次只能推送给一个环境。
推送到所有平台：
{ "platform" : "all" }
指定特定推送平台：
{ "platform" : ["android", "ios"] }
audience：推送目标
推送设备对象，表示一条推送可以被推送到哪些设备列表。确认推送设备对象，JPush 提供了多种方式，比如：别名、标签、注册 ID、分群、广播等。
all
如果要发广播（全部设备），则直接填写 “all”。
推送目标
广播外的设备选择方式，有如下几种：
| 关键字 | 类型 | 含义 | 说明 | 备注 |
|---|---|---|---|---|
| tag | JSON Array | 标签OR | 数组。多个标签之间是 OR 的关系，即取并集。 | 用标签来进行大规模的设备属性、用户属性分群。 一次推送最多 20 个。
|
| tag_and | JSON Array | 标签AND | 数组。多个标签之间是 AND 关系，即取交集。 | 注意与 tag 区分。一次推送最多 20 个。 |
| tag_not | JSON Array | 标签NOT | 数组。多个标签之间，先取多标签的并集，再对该结果取补集。 | 一次推送最多 20 个。 |
| alias | JSON Array | 别名 | 数组。多个别名之间是 OR 关系，即取并集。 | 用别名来标识一个用户。一个设备只能绑定一个别名，但多个设备可以绑定同一个别名。一次推送最多 1000 个。
|
| registration_id | JSON Array | 注册ID | 数组。多个注册 ID 之间是 OR 关系，即取并集。 | 设备标识。一次推送最多 1000 个。客户端集成 SDK 后可获取到该值。 |
| segment | JSON Array | 用户分群 ID | 在页面创建的用户分群的 ID。定义为数组，但目前限制一次只能推送一个。 | 目前限制是一次只能推送一个。 |
| abtest | JSON Array | A/B Test ID | 在页面创建的 A/B 测试的 ID。定义为数组，但目前限制是一次只能推送一个。 | 目前限制一次只能推送一个。 |
以上几种类型至少需要有其一。如果值数组长度为 0，表示该类型不存在。
这几种类型可以并存，多项的隐含关系是 AND，即取几种类型结果的交集。
例如：
"audience" : { "tag" : [ "tag1", "tag2" ], "tag_and" : [ "tag3", "tag4"], "tag_not" : [ "tag5", "tag6"] }
先计算 "tag" 字段的结果 tag1或tag2=A;
再计算 "tag_and" 字段的结果 tag3且tag4=B;
再计算 "tag_not" 字段的结果 非(tag5或tag6)=C
"audience" 的最终结果为 A且B且C 。
notification:通知
message：自定义消息
options：可选参数
推送可选项。
当前包含如下几个可选项：
| 关键字 | 类型 | 选项 | 含义 | 说明 |
|---|---|---|---|---|
| sendno | int | 可选 | 推送序号 | 纯粹用来作为 API 调用标识，API 返回时被原样返回，以方便 API 调用方匹配请求与返回。值为 0 表示该 messageid 无 sendno，所以字段取值范围为非 0 的 int. |
| time_to_live | int | 可选 | 离线消息保留时长(秒) | 推送当前用户不在线时，为该用户保留多长时间的离线消息，以便其上线时再次推送。默认 86400 （1 天），最长 10 天。设置为 0 表示不保留离线消息，只有推送当前在线的用户可以收到。该字段对 iOS 的 Notification 消息无效。 |
| override_msg_id | long | 可选 | 要覆盖的消息 ID | 如果当前的推送要覆盖之前的一条推送，这里填写前一条推送的 msg_id 就会产生覆盖效果，即：1）该 msg_id 离线收到的消息是覆盖后的内容；2）即使该 msg_id Android 端用户已经收到，如果通知栏还未清除，则新的消息内容会覆盖之前这条通知；覆盖功能起作用的时限是：1 天。如果在覆盖指定时限内该 msg_id 不存在，则返回 1003 错误，提示不是一次有效的消息覆盖操作，当前的消息不会被推送；该字段仅对 Android 有效。 |
| apns_production | boolean | 可选 | APNs 是否生产环境 | True 表示推送生产环境，False 表示要推送开发环境；如果不指定则为推送生产环境。但注意，JPush 服务端 SDK 默认设置为推送 “开发环境”。该字段仅对 iOS 的 Notification 有效。 |
| apns_collapse_id | string | 可选 | 更新 iOS 通知的标识符 | APNs 新通知如果匹配到当前通知中心有相同 apns-collapse-id 字段的通知，则会用新通知内容来更新它，并使其置于通知中心首位。collapse id 长度不可超过 64 bytes。 |
| big_push_duration | int | 可选 | 定速推送时长(分钟) | 又名缓慢推送，把原本尽可能快的推送速度，降低下来，给定的 n 分钟内，均匀地向这次推送的目标用户推送。最大值为 1400。未设置则不是定速推送。 |
384
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
