jianshu_0031.jpg

极光官网

注册
创建应用
生成AppKey 、Master Secret

集成指南

文章只介绍Android Studio Jcenter 自动集成

支持jcenter

buildscript {
    repositories {
        jcenter()
    }
    ......
}

allprojets {
    repositories {
        jcenter()
    }
}

配置gradle

因为项目本身自定义config.gradle ，所以都用rootProject.exty引用，和实际一样

android {
 ...
    defaultConfig {
        applicationId rootProject.ext.android["applicationId"]

        ndk {
            abiFilters 'armeabi'
        }
    }
  ...

    buildTypes {
        debug {
            manifestPlaceholders = [
                    JPUSH_PKGNAME: rootProject.ext.android["applicationId"],
                    JPUSH_APPKEY : rootProject.ext.jpush["debugAppKey"],
                    JPUSH_CHANNEL: rootProject.ext.jpush["channel"]]
        }

        release {
            manifestPlaceholders = [
                    JPUSH_PKGNAME: rootProject.ext.android["applicationId"],
                    JPUSH_APPKEY : rootProject.ext.jpush["releaseAppKey"],
                    JPUSH_CHANNEL: rootProject.ext.jpush["channel"]]
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

config.gradle代码

    jpush = [
            //JPush上注册的包名对应的appkey
            debugAppKey  : "",
            releaseAppKey: "",
            //暂时填写默认值即可
            channel      : "developer-default"
    ]

配置AndroidManifest

注意：在AndroidManifest中使用 ${applicationId} 引用gradle中定义的包名
这里分三块展示给大家

权限相关 @Required必填

核心功能 @Required必填

自定义广播接收器 @必填

/**
 * 自定义接收器
 * 如果不定义这个 Receiver，则：
 * 1) 默认用户会打开主界面
 * 2) 接收不到自定义消息
 */
public class JPushReceiver extends BroadcastReceiver {

    public void onReceive(Context context, Intent intent) {
        if (intent == null) {
            return;
        }

        String extraData = intent.getExtras().getString(JPushInterface.EXTRA_EXTRA);
        if (StringUtil.isEmpty(extraData)) {
            return;
        }

        PushEntity pushEntity = new Gson().fromJson(extraData, PushEntity.class);

        //推送消息 收到
        if(false && JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())){
   
        }

        //推送消息 点击
        if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {

        }
    }
}

一行代码

    /**
     * 极光推送
     */
    private void initPush() {
        // 设置开启日志,发布时请关闭日志
        JPushInterface.setDebugMode(BuildConfig.LOG_DEBUG);
        // 初始化 JPush
        JPushInterface.init(this);
    }

好了，到这里，我们就集成完了，去官网发送一条通知，测试一波

jianshu_0032.png

调试指南

SDK启动过程

检查AndroidManifest.xml中是否有配置AppKey，如果没有，则启动失败
检查 Androidmanifest.xml文件配置的正确性，必须要保证“Android SDK 集成指南”中所有标注“
Required的部分都正确配置，否则启动失败
检查 JPush SDK库文件的有效性，如果库文件无效，则启动失败
检查网络是否可用，如果网络可用则连接服务器登录，否则启动失败
登陆成功后可以从log中看到如下log

网络问题

关闭代理
网络不稳定

部分系统的特殊处理
详情请查看极光推送官方文档

测试指南

之前我们有定义两个AppKey，为什么要有两个AppKey呢？

最开始我们只有一个AppKey，然后App上线后，需要测试推送，这时，发送的话，线上的用户都会收到推送消息，如果只针对用户推的话，难免测试服与线上服ID一致，还是会有少部分用户收到推送，然后与极光团队邮件沟通，解决方案就是重新注册账号，新建应用，得到测试AppKey，用来只做测试。这样线上和测试就分两条通道走了。

    buildTypes {
        debug {
            manifestPlaceholders = [
                    JPUSH_APPKEY : rootProject.ext.jpush["debugAppKey"],
        }

        release {
            manifestPlaceholders = [
                    JPUSH_APPKEY : rootProject.ext.jpush["releaseAppKey"],
        }
    }

gradle小技巧

jianshu_0033.png

jianshu_0034.png

这里需要gradle设置一下签名即可，使用简单
感叹gradle的强大，如果想深入了解的同学，请移步
Gradle入门（一）

高级API

应项目需求，采用设置别名的方式，这里也只介绍setAlias

    @Override
    public void initPush() {
        if (UserCache.getInstance().getJPushStatus()) {
            return;
        }

        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS, localUid));
    }

接收消息，设置别名

    private final Handler mHandler = new Handler() {

        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
            switch (msg.what) {
                case MSG_SET_ALIAS:
                    JPushInterface.setAlias(MainActivity.this, (String) msg.obj, mAliasCallback);
                    break;
            }
        }
    };

设置别名的回调

    private final TagAliasCallback mAliasCallback = new TagAliasCallback() {
        @Override
        public void gotResult(int code, String alias, Set tags) {

            switch (code) {
                case 0:
                    //设置成功，存储状态值
                    UserCache.getInstance().saveJPushSuccess();
                    break;
                case 6002:
                    //失败，重复设置
                    mHandler.sendMessageDelayed(mHandler.obtainMessage(MSG_SET_ALIAS, alias), 1000 * 60);
                    break;
                default:
                    break;
            }
        }
    };

退出登录，删除别名

    @Override
    public void loginOut() {
        // JPushInterface.deleteAlias(,); 也可以
        JPushInterface.setAlias(AppSettingActivity.this, "", null);
        exitActivity();
    }

其它

关于拉起

不是所有使用了极光服务的App都愿意开启拉起功能来拉起别的应用或者被别的应用拉起
拉起同样会受到系统的限制，该功能只是尽量提高点重启的几率，相当于有比没有好
测试拉起的具体步骤方法
成功设置了拉起也不是说马上你杀死，推送测试他就能收到的，你要等他拉起成功

注意

互相拉起服务，使用的后果一定要考虑清楚

使用了互相拉起服务，确实，你们APP推送的及时到达率都提升了很多，但是，APP开启的一段时间里，手机会卡顿，因为会唤醒，同样注册了极光推送互相拉起服务的应用，手机里面有2-3个还好，用户还发现不了什么，如果手机里面有100，200，300个应用，那最少唤醒10- 30个，开启的一段时间，手机绝对会卡顿，所以为什么会有垃圾联盟了，为什么手机越用越卡。

当然也看你们产品定位，毕竟手机里面装100，200，300个应用的用户占少数，牺牲少部分用户，博得大部分群体也可以，看实际需求。

最后呢，我们的产品最开始开启互相拉起服务，一段时间我又删除了，就是关闭互相拉起服务，正常情况，APP不该唤醒其它应用，也不会被其它应用唤醒，结果，删除了，还是没法解决互相唤醒，现在就是想关关不掉！！！和极光服务沟通过，让我们多测试一下，现在也没时间测试，暂时记一个Bug，也有可能不是极光服务的问题。总之，慎重！

后记

上线后怎么测试推送和广播？
事情起因，测试人员不小心推送、广播全部人，结果，线上的用户都收到了 test 这样的信息，无法点击查看。其实，我也经常会收到新浪推送的test信息，真的非常影响用户体验。

iOS为什么不会出现这样的问题呢？
他们在设置时，已经有生产环境和开发环境，配置不同的签名，结合后端的业务，来推生产环境，还是开发环境，这样线上的用户就不会收到测试人员的推送

android怎么解决呢？

重新注册极光账号
设置包名，生成AppKey 、Master Secret
告诉后台，这个属于开发测试的通道

极光推送