android jpush（极光推送）快速集成

在日常生活中，我们经常见到手机上的软件在通知栏提醒，各种新闻，软件更新提示等等。。都涉及到了推送服务。

推送服务，可以主动、及时地向您的用户发起交互，向其发送聊天消息、

日程提醒、活动预告、进度提示、动态更新等。

精准的目标用户和有价值的推送内容可以提升用户忠诚度，提高留存率与收入。

本文介绍的是  极光推送 与android 的集成。

官网：www.jiguang.cn

1、注册登录账户。

2、进入开发者服务后台

3、创建应用

此处我用的是和android 的集成，ios的没填，输入应用名称 和 自己要集成软件的包名

4、下载demo

demo下载解压，得到目录结构

5、手动集成

• 解压缩 jpush-android-release-3.x.y.zip 集成压缩包。
• 复制 libs/jcore-android_v1.x.y.jar 到工程 libs/ 目录下。
• 复制 libs/jpush-android_v3.x.y.jar 到工程 libs/ 目录下。
• 复制 libs/(cpu-type)/libjcore1xy.so 到你的工程中存放对应cpu类型的目录下。
• 复制 res/ 中drawable-hdpi, layout, values文件夹中的资源文件到你的工程中 res/ 对应同名的目录下。

注：复制layout、values文件夹中的内容时，要将重复文件的内容合并，而非简单覆盖。

6、 配置 AndroidManifest.xml

根据 SDK 压缩包里的 AndroidManifest.xml 样例文件，来配置应用程序项目的 AndroidManifest.xml 。

主要步骤为：

• 复制备注为 "Required" 的部分
• 将标注为“您应用的包名”的部分，替换为当前应用程序的包名
• 将标注为“您应用的Appkey”的部分，替换为在Portal上注册该应用的的Key,例如：9fed5bcb7b9b87413678c407

AndroidManifest 示例

上方注释标注Required的部分是必须的代码，用户自定义的部分不是必须的。

7、 创建 一个类继承 Application，初始化Application天然是单例的，可以把一些全局信息和全局的方法写在Application中。

public class ExampleApplication extends Application {
	@Override
        public void onCreate() {
            super.onCreate();
    	JPushInterface.setDebugMode(true);
    	JPushInterface.init(this);
    }
}

这样，基本的功能都配置完了。

可以在极光官网推送实验了。

8、自定义消息类 会用到上方代码Receiver（注释为：）

MyReceiver.java

package com.text.push;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;

import org.json.JSONException;
import org.json.JSONObject;

import cn.jpush.android.api.JPushInterface;

/**
 */
public class PushReceiver extends BroadcastReceiver {
    private static final String TAG = "PushReceiver";

    //当受到消息，会回调onReceive()方法,onReceive中解析
    @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())) {
            //自定义消息可以发送json数据
            System.out.println("收到了自定义消息。消息内容是：" + bundle.getString(JPushInterface.EXTRA_MESSAGE));
            // 自定义消息不会展示在通知栏，完全要开发者写代码去处理
        } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
            System.out.println("收到了通知");
            // 在这里可以做些统计，或者做些其他工作(通知栏被点击)
        } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
            System.out.println("用户点击打开了通知");
            // 在这里可以自己写代码去定义用户点击后的行为
            //保存服务器推送下来的附加字段。这是个 JSON 字符串。
            String extras = bundle.getString(JPushInterface.EXTRA_EXTRA);
            System.out.println("附加信息："+extras);
            try {
                JSONObject obj = new JSONObject(extras);
                String url = obj.getString("url");
                System.out.println("url："+url);
                //跳浏览器
            } catch (JSONException e) {
                e.printStackTrace();
            }
        } else {
            Log.d(TAG, "Unhandled intent - " + intent.getAction());
        }
    }
}

9、 配置和代码说明

必须权限说明

权限	用途
You Package.permission.JPUSH_MESSAGE	官方定义的权限，允许应用接收JPUSH内部代码发送的广播消息。
RECEIVE_USER_PRESENT	允许应用可以接收点亮屏幕或解锁广播。
INTERNET	允许应用可以访问网络。
WAKE_LOCK	允许应用在手机屏幕关闭后后台进程仍然运行
READ_PHONE_STATE	允许应用访问手机状态。
WRITE_EXTERNAL_STORAGE	允许应用写入外部存储。
READ_EXTERNAL_STORAGE	允许应用读取外部存储。
WRITE_SETTINGS	允许应用读写系统设置项。
VIBRATE	允许应用震动。
MOUNT_UNMOUNT_FILESYSTEMS	允许应用挂载/卸载 外部文件系统。
ACCESS_NETWORK_STATE	允许应用获取网络信息状态，如当前的网络连接是否有效。

官方文档 http://docs.jiguang.cn/jpush/client/Android/android_guide/