android集成极光消息推送

推送功能现在在app中已是成常用的功能，而要实现推送功能，为了省时省力一般考虑采用第三方推送sdk来实现，这里总结是极光推送（JPush）这也是本人在项目中经常用到的第三方推送sdk ，总的来说集成起来挺简单的，只要按照官方的文档一步步集成还是能够完成，本人第一次集成的时候也是这样干的，其实其它的第三方sdk一般都是根据官方的文档文档一步步集成的，但对于一些从来没有用过极光推送或是刚开始的人来说，总会有这样的那样的问题，会走一些弯路，会躺过一些坑，现在将以前的集成经验进行流程化，再此做些记录，便于以后自己集成时候参照，同时也希望能够为其他需要的提供一些帮助。

1：前期的准备工作及注意点：

官网创建应用，生成appkey ，这是现在的第三方的sdk通用的准备工作，一般需要填写程序的包名（有些还需要程序的签名，如微信开放平台），这个包名一般都是一旦指定就不可更改。如果需要更改一般只能重新创建应用了，这时候的appkey就与之前不一样了，程序中也需要相应的修改。

https://www.jpush.cn/push/apps/02fbf519b20a6bb4dd800568/push/detail/

然后按照官方的android sdk集成指南进行集成就可以了。

注意几点：

1 导包；导包完成后的目录结构应该是：

2.注意权限配置：

配置两个都需要，而且这两个配置很相似，容易大意出错（本人和同事曾在这里坑过）

3.注意查看Log日志，和错误信息：

1：打开极光的日志，JPushInterface.setDebugMode(true); // 设置开启日志,发布时请关闭日志

2：通过JPush tag进行日志过滤

另外遇到问题可以查阅官方文档中 androi常见问题中对常见问题的解决方法。

根据在邻里，新东方项目的集成经验现总结如下：

主要是参考JPush官方文档。

1.集成前的准备工作

a.在极光官网注册开发者账号。

b.登录后创建应用，查看应用详情，获得AppKey如图：

c.点击图中的绿色按钮，下载Android Example，即官方Demo

以上步骤可以根据文档。3分钟Demo指导完成。

2.在自己的项目中集成。

这是可以根据之前下载的官方demo进行快速集成。

解压下载的官方demo压缩文件，打开可以看到如下目录结构：

在自己的项目中需要集成以下几部分。

1.jar包，导入 SDK 开发包到你自己的应用程序项目

这里只需将libs目录下的所有文件拷贝到我们工程目录下的libs下即可。

2.配置 AndroidManifest.xml

打开dmeo的AndroidManifest.xml文件。

拷贝下面代码到自己项目的AndroidManifes.xml文件中

注意将其中的 "您应用的包名: 修改为自己的程序包名

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="您应用的包名"   
    android:versionCode="180"
    android:versionName="1.8.0"
    >
    <uses-sdk android:minSdkVersion="11" android:targetSdkVersion="17"/>
    <!--Required自定义用来收发消息的相关权限-->               
    <permission
        android:name="您应用的包名.permission.JPUSH_MESSAGE"
        android:protectionLevel="signature"/>
  
    <!--Required  一些系统要求的权限，如访问网络等-->
    <uses-permission android:name="您应用的包名.permission.JPUSH_MESSAGE"/>
    <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/>
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.WAKE_LOCK"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
    <uses-permission android:name="android.permission.VIBRATE"/>
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>  
 
    <!--Optionalfor location -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
    
    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"> 
        <!--Required SDK核心功能-->
        <activity
            android:name="cn.jpush.android.ui.PushActivity"
            android:configChanges="orientation|keyboardHidden" 
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.ui.PushActivity"/>
                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="您应用的包名"/>
            </intent-filter>
        </activity>
        <!--Required  SDK核心功能-->
        <service
            android:name="cn.jpush.android.service.DownloadService"
            android:enabled="true"
            android:exported="false">
        </service>    
        <!--Required SDK 核心功能-->
        <service
            android:name="cn.jpush.android.service.PushService"
            android:enabled="true"
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTER"/>
                <action android:name="cn.jpush.android.intent.REPORT"/>
                <action android:name="cn.jpush.android.intent.PushService"/>
                <action android:name="cn.jpush.android.intent.PUSH_TIME"/> 
            </intent-filter>
        </service>
        <!--Required SDK 核心功能-->
        <service 
            android:name="cn.jpush.android.service.DaemonService"
            android:enabled="true"
            android:exported="true">
            <intent-filter >
                <action android:name="cn.jpush.android.intent.DaemonService"/>
                <category android:name="您应用的包名"/>
            </intent-filter>
        </service>
        <!--Required SDK核心功能-->
        <receiver
            android:name="cn.jpush.android.service.PushReceiver"
            android:enabled="true"
            android:exported="false">
             <intent-filter android:priority="1000">
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY"/>   <!--Required  显示通知栏-->
                <category android:name="您应用的包名"/>
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.USER_PRESENT"/>
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE"/>
            </intent-filter>
             <!--Optional-->
            <intent-filter>
                <action android:name="android.intent.action.PACKAGE_ADDED"/>
                <action android:name="android.intent.action.PACKAGE_REMOVED"/>
                <data android:scheme="package"/>
            </intent-filter>
        </receiver>
        
        <!--Required SDK核心功能-->
        <receiver android:name="cn.jpush.android.service.AlarmReceiver"/>
        
        <!--User defined.    用户自定义的广播接收器，如果不需要这个对推送消息进行处理，这个广播接收器不用定义-->
        <receiver
            android:name="您自己定义的Receiver"
            android:enabled="true">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTRATION"/><!--Required  用户注册SDK的intent-->
                <action android:name="cn.jpush.android.intent.UNREGISTRATION"/>  
                <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED"/><!--Required  用户接收SDK消息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED"/><!--Required  用户接收SDK通知栏信息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED"/><!--Required  用户打开自定义通知栏的intent-->
                <action android:name="cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK"/><!--Optional用户接受RichPushJavascript回调函数的intent-->
                <action android:name="cn.jpush.android.intent.CONNECTION"/><!--接收网络变化连接/断开 since 1.6.3-->
                <category android:name="您应用的包名"/>
            </intent-filter>
        </receiver>
 
        
        <!--Required  .Enable it you can get statistics data with channel -->
        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
        <meta-data android:name="JPUSH_APPKEY" android:value="您的Appkey"/><!--  </>值来自开发者平台取得的AppKey-->
        
    </application>
</manifest>

3.拷贝相关java代码。（主要是MyReceiver类，如果不需要对推送的通知进行特殊处理，可以不用拷贝相关java代码，

在AndroidManifest文件中也不需要定义自定义Receiver,这时候点击推送的通知，默认是打开应用）

在自己项目包名目录下建立一个jpush包名：将demo的src目录下的所有java代码拷贝到jpush包目录下。这样整体拷贝，不用更改包名，比较方便。这里我需要是关注MyReceiver中的代码，这个是核心，这个是极光广播的监听，通过这个类可以针对推送的消息进行处理，比如实现点击消息通知跳转到特定的界面等功能。

4.拷贝res目录下的资源文件到自己的项目中。

将demo目录下res下所有的res资源文件与自己的项目资源文件进行合并。

5.在自己项目进行jpush初始化，别名，tag等设置。

在登录Activity或欢迎Activity等合适的Activity中进行JPush初始化以及别名，或tag设置。

这里将这些代码统一写一个管理类，以便在以后的项目中使用。

package com.centrvideo.parkapp.jpush;
import java.io.Serializable;
import java.util.HashSet;
import java.util.Set;
import android.content.Context;
import android.os.Handler;
import android.text.TextUtils;
import android.util.Log;
import android.widget.Toast;
import cn.jpush.android.api.JPushInterface;
import cn.jpush.android.api.TagAliasCallback;
import com.centrvideo.parkapp.util.SharedPreferenceUtil;
/**
 * 极光推送封装，极光管理类
 * @ClassName: JPushManager 
 * @Description: 
 * @author xiaoxiao
 * @date modify by 2015-9-2 上午11:12:10 
 *
 */
public class JPushManager {
    private String TAG = "JPushManager";
    private final String KEY = "JpushConfig";
    private static JPushManager jPushManager;
    private static Context context;
    public static JPushManager newInstence(Context context) {
        JPushManager.context = context;
        if (jPushManager == null) {
            jPushManager = new JPushManager();
        }
        return jPushManager;
    }
    /**
     * 初始化极光，一般可以放到程序的启动Activity或是Application的onCreate方法中调用
     */
    public void initJPush() {
        JPushInterface.setDebugMode(true); // 设置开启日志,发布时请关闭日志
        JPushInterface.init(context); // 初始化 JPush
    }
    /**
     * 退出极光，一般是程序退出登录时候，具体还是需要看项目的实际需求
     */
    public void stopJPush() {
//        JPushInterface.stopPush(context);//
        setAliasAndTags("","");//通过清空别名来停止极光
    }
    /**
     * 设置AliasAndTag,设置多组tag,如果不需要设置tag的化，直接将此参数设为null;
     * 一般在程序登录成功，注册成功等地方调用。别名一般是用户的唯一标识，如userId等
     * @param alias
     * @param tags
     */
    public void setAliasAndTags(final String alias, Set<String> tags) {
        if (TextUtils.isEmpty(alias)) {
            Toast.makeText(context, "别名为空", Toast.LENGTH_SHORT).show();
            return;
        }
        // 调用 Handler 来异步设置别名
        // TODO Auto-generated method stub
        AliasAndTagsInfo aliasAndTagsInfo = new AliasAndTagsInfo();
        aliasAndTagsInfo.setAlias(alias);
        aliasAndTagsInfo.setTag(tags);
        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS,
                aliasAndTagsInfo));
    }
    /**
     * 设置AliasAndTag,设置一组tag,如果不需要设置tag的化，直接将此参数设为null;
     * @param alias
     * @param tags
     */
    public void setAliasAndTags(final String alias, String tag) {
        if (TextUtils.isEmpty(alias)) {
            Toast.makeText(context, "别名为空", Toast.LENGTH_SHORT).show();
            return;
        }
        // 调用 Handler 来异步设置别名
        // TODO Auto-generated method stub
        AliasAndTagsInfo aliasAndTagsInfo = new AliasAndTagsInfo();
        aliasAndTagsInfo.setAlias(alias);
        Set<String> tags = new HashSet<String>();
        tags.add(tag);
        aliasAndTagsInfo.setTag(tags);
        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS,
                aliasAndTagsInfo));
    }
    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";
                Log.d(TAG, logs);
                // 建议这里往 SharePreference 里写一个成功设置的状态。成功设置一次后，以后不必再次设置了。
                saveAlias(alias);
                break;
            case 6002:
                logs = "Failed to set alias and tags due to timeout. Try again after 60s.";
                Log.d(TAG, logs);
                // 延迟 60 秒来调用 Handler 设置别名
                mHandler.sendMessageDelayed(
                        mHandler.obtainMessage(MSG_SET_ALIAS, alias), 1000 * 60);
                break;
            default:
                logs = "Failed with errorCode = " + code;
                Log.d(TAG, logs);
            }
        }
    };
    /**
     * 保存别名到属性文件。
     * 
     * @param alias
     */
    private void saveAlias(String alias) {
        SharedPreferenceUtil.saveString(context, KEY, alias);
    }
    /**
     * 从属性文件取得别名
     * 
     * @param userName
     * @return
     */
    private String getAlias(String userName) {
        return SharedPreferenceUtil.getString(context, KEY, null);
    }
    private static final int MSG_SET_ALIAS = 1001;
    private final Handler mHandler = new Handler() {
        @Override
        public void handleMessage(android.os.Message msg) {
            super.handleMessage(msg);
            AliasAndTagsInfo aliasAndTagsInfo = (AliasAndTagsInfo) msg.obj;
            switch (msg.what) {
            case MSG_SET_ALIAS:
                Log.d(TAG, "Set alias in handler.");
                // 调用 JPush 接口来设置别名。
                JPushInterface.setAliasAndTags(context,
                        aliasAndTagsInfo.getAlias(), aliasAndTagsInfo.getTag(),
                        mAliasCallback);
                break;
            default:
                Log.d(TAG, "Unhandled msg - " + msg.what);
            }
        }
    };
    public class AliasAndTagsInfo implements Serializable {
        private static final long serialVersionUID = 1L;
        private String alias;
        private Set<String> tag;
        public String getAlias() {
            return alias;
        }
        public void setAlias(String alias) {
            this.alias = alias;
        }
        public Set<String> getTag() {
            return tag;
        }
        public void setTag(Set<String> tag) {
            this.tag = tag;
        }
    }
}

来自为知笔记(Wiz)

附件列表

posted @ 2015-09-02 13:30 ---风雨无阻-- 阅读(7103) 评论(0) 编辑收藏举报

刷新页面返回顶部

android集成极光消息推送

附件列表

公告