Push_v3

为解决 Android 推送碎片化、到达率低、集成繁琐等问题，聚合极光、小米、华为、Vivo、OPPO 等手机厂商提供的第三方聚合推送解决方案。

历经 push_v1 push_v2 两个版本的迭代优化，框架已经有足够的稳定性易用性，欢迎各位采纳使用，有任何问题欢迎提 issue 讨论交流。

一概述

JLPush 目前聚合了极光、小米、华为三大平台的推送、其中小米、华为为厂商推送。Push 的启用默认逻辑是: 如果当前设备品牌是小米或者华为则走对应的厂商平台推送、其余设备机型启用极光推送。

小米 Push 所用版本 MiPush_SDK_Client_3_6_19.jar

华为 Push 所用版本

 api 'com.huawei.android.hms:base:2.6.3.301'
 api 'com.huawei.android.hms:push:2.6.3.301'

极光 Push 所用版本

 api 'cn.jiguang.sdk:jpush:3.3.6'
 api 'cn.jiguang.sdk:jcore:2.1.6'

Vivo Push
```
libs/vivo_pushsdk-v2.9.0.0.aar
```
OPPO Push
```
libs/com.heytap.msp-push-2.1.0.aar
```
minSdkVersion 16

二流程

其中 App 应用层的职责是: 将 JLPush 库返回的 registerId 上报给自己的 App server ， App sever 能够通过各平台提供接口给 App 端下发通知。应用层需要处理 JLPush 聚合接口返回的通知做对应处理，例如: 弹出通知栏或者打开应用指定跳转界面。

三名词解释

	1 registerId : 各个推送平台客户端与推送服务端对应的秘钥，启动 App 调用初始化等接口时，如果初始化成功平台 SDK 应该会返回此值，某些平台也叫 token 一般拿到这个 registerId 去推送平台做接入调试或者上报给应用服务器。

	2 通知栏与透传 : 受限于 Android 系统后台进程驻留机制，后台进程长时间保持存活越来越困难。推送厂商直接提供系统级别的推送来保证推送的到达率一般这样的推送方式称谓通知栏方式，特点是由系统保证推送到达率高，但是可自定义程度低，透传方式反之。

	3 socket 长连接

四集成准备

  访问小米、华为、极光推送平台注册账号、随后创建应用。获取各个平台的 secret  appkey  appid 等重要数据

Gradlle 配置：

    buildTypes {
        debug {
            manifestPlaceholders = [
                    JPUSH_PKGNAME: 'Your packgename',
                    JPUSH_APPKEY : "xxx", //JPush 上注册的包名对应的 Appkey.
                    JPUSH_CHANNEL: "developer-default", //暂时填写默认值即可.

                    HUAWEI_APPID : "xxx",

                    XIAOMI_APPID : "xiaomi_xxx",
                    XIAOMI_APPKEY: "xiaomi_xxx",

                    VIVO_APPID   : "xxx",
                    VIVO_APPKEY  : "xxx",

                    OPPO_APPKEY  : "xxx",
                    OPPO_SECRET  : "xxx"
            ]
        }
        release{
        ...
        }

将各个平台的 push 包在工程进行依赖，需要哪个平台就添加哪个平台即可，Push 框架已做按需取用处理

五接入步骤

1 module 、aar、maven 三种方式择其一依赖 Push 库

2 建议在 application 或者 main 做初始化工作

            PushClient.init(this, new PushConfig(), new PushStatusListener() {
                @Override
                public void onRegister(String registerId, PushType pushType) {
                    Log.e(App.class.getSimpleName(), "push type: " + pushType.getName() + " push regId :" + registerId);
                }

                @Override
                public void onError(String error, PushType pushType) {

                }

                @Override
                public void onPushConnected() {

                }
            });

3 新建广播 extends com.julive.push.core.PushReceiver , 示例如下：

public class AppPushReceiver extends PushReceiver {

    public static final String TAG = AppPushReceiver.class.getSimpleName();

    @Override
    public boolean onNotificationMessageArrived(Context context, PushType pushType, String notificationMessage) {
        Log.e(TAG, "onNotificationMessageArrived push type ：" + pushType + " message ：" + notificationMessage);
        return false;
    }

    @Override
    public boolean onNotificationMessageClicked(Context context, PushType pushType, String notificationMessage) {
        Log.e(TAG, "onNotificationMessageClicked push type ：" + pushType + " message ：" + notificationMessage);
        Log.e(TAG, context.toString());
        return false;
    }
}

        <receiver
            android:name=".AppPushReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="com.comjia.push.intent.MESSAGE_ARRIVED" />
                <action android:name="com.comjia.push.intent.MESSAGE_CLICKED" />
            </intent-filter>
        </receiver>

4 其他用法

a: 应用存活时接受透传消息等

        PushClient.setOnPushActionListener(new OnPushActionListener() {
            @Override
            public void onNotificationReceived(String message, PushType pushType) {
                Log.e(TAG, "Listener onNotificationReceived pushType：" + pushType.getName() + " message：" + message);
            }

            @Override
            public void onNotificationOpened(String message, PushType pushType) {
                Log.e(TAG, "Listener onNotificationOpened pushType：" + pushType.getName() + " message：" + message);
            }

            @Override
            public void onTransparentMessage(String message, PushType pushType) {
                Log.e(TAG, "Listener onTransparentMessage pushType：" + pushType.getName() + " message：" + message);
            }
        });

b: OPPO 不支持广播接收，如果需要定制跳转页面则需：

public class OppoPushDispatchActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Intent i = getIntent();
        Uri uri = i.getData();
        Log.e(PUSH_TAG,"oppo clicked ：" + uri.toString());
    }
}

        <activity
            android:name=".OppoPushDispatchActivity"
            android:configChanges="screenSize|smallestScreenSize|screenLayout"
            android:launchMode="singleTask"
            android:screenOrientation="behind"
            >
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />

                <data
                    android:host="app.comjia.com"
                    android:path="/oppopush"
                    android:scheme="push" />
            </intent-filter>
        </activity>
        <!--push://app.comjia.com/oppopush?goodsId=10011002 按照此例子协议可以自定义配置 在 OPPO 后台为 schemeUrl 配置 -->

六 API

TODO

七测试

1 日志分析:

库的日志过滤关键字为 jlpush ，以下以小米为例做一个成功流程的日志分析:

2 小米推送管理后台

http://admin.xmpush.xiaomi.com/

3 华为推送管理后台

4 极光推送管理后

极光推送管理后台

八 FQA

Q: 应用在小米手机上进程存活和不存活时候接受推送是什么表现？

A: 进程是否存活小米通知都能收到，只是代码中小米 SDK 广播收到的事件不一样。如果是进程存活小米推送的表现是抵达事件和点击通知栏事件都能收到，如果进程被杀死则(点击通知自定义)的推送收不到抵达事件能收到点击的事件，此时应用会走 application 的 oncreate 方法但是主界面不会被唤起需要开发者自己去处理唤起 splash 或者 main 页面的唤起。
Q: 极光推送在进程存活和不存活时候接受推送是什么表现？

A: 极光推送进程存活消息抵达和通知事件都能收到，进程被杀死后均无法收到推送。

Tyeeee/Push_v3

Push_v3

一 概述

二 流程

三 名词解释

四 集成准备

五 接入步骤

六 API

七 测试

八 FQA

一概述

二流程

三名词解释

四集成准备

五接入步骤

七测试