迅速集成Jpush极光推送功能

一集成

   1下载官方集成SDk   https://www.jiguang.cn/push    后解压jpush-android-release-3.0.6

    2复制libs中的 jcore-android_v1.1.3.jar  和jpush-android_v3.0.6.jar到工程的libs中        并添加上依赖

    3新建src/main里创建存放cpu的文件夹  jniLibs    将sdk中的文件复制到此目录    并在app下的build Gradle里添加如下代码指向该资源

android {    ...    sourceSets.main{        jniLibs.srcDir 'src/main/jniLibs'    }}

     4清单文件  根据SDk中的AndroidManifest.xml    复制required的部分  到清单文件中

         将标注为“您的包名”  替换成app的包名                               将标注为您应用的appKey替换为在极光注册该应用时的appKey

    5在自己应用的application的onCreat()的方法里初始化极光推送         

        

public void onCreate() {              Logger.d(TAG, "[ExampleApplication] onCreate");         super.onCreate();         JPushInterface.setDebugMode(true); // 设置开启日志,发布时请关闭日志         JPushInterface.init(this);     // 初始化 JPush    }

     6自定义推送消息的广播接受者  来处理各种推送下来的广播消息 与通知等等

   

public class MyReceiver extends BroadcastReceiver {    private static final String TAG = "JPush";    @Override    public void onReceive(Context context, Intent intent) {        try {            //接受到推送过来的消息            Bundle bundle = intent.getExtras();            Logger.d(TAG, "[MyReceiver] onReceive - " + intent.getAction() + ", extras: " + printBundle(bundle));            /**             *    Logger.d(TAG, "JPush用户注册成功");             */            if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {                String regId = bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);                Logger.d(TAG, "[MyReceiver] 接收Registration Id : " + regId);                //send the Registration Id to your server...             /**             * 这里可以接收系统自定义消息    传递文本消息等等             */            } else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {                Logger.d(TAG, "[MyReceiver] 接收到推送下来的自定义消息: " + bundle.getString(JPushInterface.EXTRA_MESSAGE));                processCustomMessage(context, bundle);                /**                 * [MyReceiver] 接收到推送下来的通知                  */            } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {                Logger.d(TAG, "[MyReceiver] 接收到推送下来的通知");                int notifactionId = bundle.getInt(JPushInterface.EXTRA_NOTIFICATION_ID);                Logger.d(TAG, "[MyReceiver] 接收到推送下来的通知的ID: " + notifactionId);                /**                 *    点开通知做的处理   可以跳转到自己的activity                 */            } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {                Logger.d(TAG, "[MyReceiver] 用户点击打开了通知");                //打开自定义的Activity                Intent i = new Intent(context, TestActivity.class);                i.putExtras(bundle);                //i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);                i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);                context.startActivity(i);                BasicPushNotificationBuilder builder = new BasicPushNotificationBuilder(context);                builder.statusBarDrawable = R.drawable.jpush_notification_icon;                builder.notificationFlags = Notification.FLAG_AUTO_CANCEL                        | Notification.FLAG_SHOW_LIGHTS;  //设置为自动消失和呼吸灯闪烁                builder.notificationDefaults = Notification.DEFAULT_SOUND                        | Notification.DEFAULT_VIBRATE                        | Notification.DEFAULT_LIGHTS;  // 设置为铃声、震动、呼吸灯闪烁都要                JPushInterface.setPushNotificationBuilder(1, builder);                /**                 *   推送富媒体的                  */            } else if (JPushInterface.ACTION_RICHPUSH_CALLBACK.equals(intent.getAction())) {                Logger.d(TAG, "[MyReceiver] 用户收到到RICH PUSH CALLBACK: " + bundle.getString(JPushInterface.EXTRA_EXTRA));                //在这里根据 JPushInterface.EXTRA_EXTRA 的内容处理代码，比如打开新的Activity， 打开一个网页等..                /**                 * 链接变化的                 */            } else if (JPushInterface.ACTION_CONNECTION_CHANGE.equals(intent.getAction())) {                boolean connected = intent.getBooleanExtra(JPushInterface.EXTRA_CONNECTION_CHANGE, false);                Logger.w(TAG, "[MyReceiver]" + intent.getAction() + " connected state change to " + connected);            } else {                Logger.d(TAG, "[MyReceiver] Unhandled intent - " + intent.getAction());            }        } catch (Exception e) {        }    }}

       7运行后在控制台上就可以推送消息了

二集成时可能出现的问题

   E/JPush: [JPushGlobal] Get sdk version fail![获取sdk版本失败!]
   E/JPush: [JPushGlobal] JPush .so file do not match JPush .jar file in the project, Failed to init JPush

   解决：

  

二 标签和别名的使用

    1为什么使用标签和别名

    推送消息时，要指定推送的对象：全部，某一个人，或者某一群人。

     2工作方式

    客户端开发者App调用 setAliasAndTags API 来设置关系
    JPush SDK 把该关系设置保存到 JPush Server 上
    在服务器端推送消息时，指定向之前设置过的别名或者标签推送

   3别名

    alias可能是一对一   ，推荐一对一单独推送，

    举例：在一个用户要登录的游戏中，可能设置别名为 userid。游戏运营时，发现该用户 3 天没有玩游戏了，则根据 userid调用服务器端API发 通知到客户端提醒用户。

    也可能是一对多

     如果多个人使用了同一个别名，，向这个别名推送消息时，带有这个别名的所有用户都会收到消息。

    4标签

     为安装了应用程序的用户，打上标签。其目的主要是方便开发者根据标签，来批量下发 Push消息。可为每个用户打多个标签。

     举例： game, old_page, women

    4设置别名与标签   一般在登录界面设置     结合登录名    用户名id    域id     组织架构id等等

      JPushInterface.setAliasAndTags(getApplicationContext(),

             imModule.getAlias(), //一个字符串

             imModule.getTags(),  //一个set集合标签集合

              mAliasCallback);    //设置的回调接口

    设置别名和标签

     

        Set<String> set = new HashSet<>();        set.add("@" + user.getDomainID());        set.add(user.getOrg_id() + "@" + user.getDomainID());        ImModule imModule = new ImModule();        imModule.setAlias(alias + "@" + user.getDomainID());        imModule.setTags(set);        // 调用 Handler 来异步设置别名//        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS, alias));        message = mHandler.obtainMessage();        message.what = MSG_SET_ALIAS;        message.obj = imModule;        mHandler.sendMessage(message);

     接受到消息开始设置标签和别名

    

  ImModule imModule = (ImModule) msg.obj;                        // 调用 JPush 接口来设置别名。                        JPushInterface.setAliasAndTags(getApplicationContext(),                                imModule.getAlias(),                                imModule.getTags(),                                mAliasCallback);

     添加设置回调  当设置失败后重试

    

private final TagAliasCallback  mAliasCallback = new TagAliasCallback() {     @Override     public void gotResult(int code, String alias, Set<String> tags) {String logs;switch (code) {    case 0:        logs = "Set tag and alias success";        Logger.i(TAG, logs);                break;    case 6002:        logs = "Failed to set alias and tags due to timeout. Try again after 60s.";Logger.i(TAG, logs);                //如果联网  就60秒后重试if (ExampleUtil.isConnected(getApplicationContext())) {  mHandler.sendMessageDelayed(mHandler.obtainMessage(MSG_SET_ALIAS, alias), 1000 * 60);} else {   Logger.i(TAG, "No network");}break;     default:logs = "Failed with errorCode = " + code;Logger.e(TAG, logs);}ExampleUtil.showToast(logs, getApplicationContext());     }};

    三定制通知和消息的样式

    1 定制简单的通知样式  使用BasicPushNotificationBuilder

    

BasicPushNotificationBuilder builder = new BasicPushNotificationBuilder(MainActivity.this);builder.statusBarDrawable = R.drawable.jpush_notification_icon;builder.notificationFlags = Notification.FLAG_AUTO_CANCEL        | Notification.FLAG_SHOW_LIGHTS;  //设置为自动消失和呼吸灯闪烁builder.notificationDefaults = Notification.DEFAULT_SOUND        | Notification.DEFAULT_VIBRATE        | Notification.DEFAULT_LIGHTS;  // 设置为铃声、震动、呼吸灯闪烁都要参数一     为某种类型的 PushNotificationBuilder 指定编号。JPushInterface.setPushNotificationBuilder(1, builder);

    2 定制带按钮的Notification样式   MultiActionsNotificationBuilder

MultiActionsNotificationBuilder builder = new MultiActionsNotificationBuilder(PushSetActivity.this);//添加按钮，参数(按钮图片、按钮文字、扩展数据)builder.addJPushAction(R.drawable.jpush_ic_richpush_actionbar_back, "first", "my_extra1");builder.addJPushAction(R.drawable.jpush_ic_richpush_actionbar_back, "second", "my_extra2");builder.addJPushAction(R.drawable.jpush_ic_richpush_actionbar_back, "third", "my_extra3");JPushInterface.setPushNotificationBuilder(2, builder)

    3高级定制      使用CustomPushNotificationBuilder   定义通知里的布局

   

CustomPushNotificationBuilder builder = new    CustomPushNotificationBuilder(MainActivity.this,                              R.layout.customer_notitfication_layout,                              R.id.icon,                              R.id.title,                              R.id.text);                              // 指定定制的 Notification Layout    builder.statusBarDrawable = R.drawable.your_notification_icon;         // 指定最顶层状态栏小图标    builder.layoutIconDrawable = R.drawable.your_2_notification_icon;      // 指定下拉状态栏时显示的通知图标    JPushInterface.setPushNotificationBuilder(2, builder);

    4终极设定  自定义通知   不使用Jpush里的   App取到自定义消息全部内容，然后App自己来写代码做通知的