Android集成極光推送

要說學習極光推送，個人感覺官方文檔就非常好啦，但是沒法，人太懶啦，為了下次能夠快速的將極光推送集成到項目中，故結合之前開發的項目和官方文檔記錄下簡單的Android集成極光推送，在這之前，先上一張簡單的思維導圖吧，最近一直在研究思維導圖，感覺幫助還挺大的。

 

 

先從官方文檔中摘取出一些熟悉的名詞，推送目標主要分為四種：

廣播推送：向所有的注冊用戶發送一條廣播消息

標簽推送：根據屬性對用戶設置標簽分組，向群組用戶發送

別名推送：客戶端綁定用戶別名，向具體的單個用戶推送

用戶群體：根據JPush提供的多條件組合進行用戶群組划分，實時篩選實時推送

推送的消息形式也分為四種：

通知：指在手機的通知欄（狀態欄）上會顯示的一條通知信息。通知主要用於提示用戶的目的，應用於新聞內容、促銷活動、產品信息、版本更新提醒、訂單狀態提醒等多種場景

自定義形式：自定義消息不是通知，所以不會被SDK展示到通知欄上。其內容完全由開發者自己定義。自定義消息主要用於應用的內部業務邏輯。一條自定義消息推送過來，有可能沒有任何界面顯示。

富媒體：JPush支持開發者發送圖文並茂的通知，從而更好的傳達信息，帶來更豐富的用戶互動。JPush提供了5種模板，開發者可以通過填充模板的內容，發送landing page、彈窗、信息流形式的富媒體通知。開發者還可以直接通過URL發送預先編輯好的頁面。

本地通知：本地通知API不依賴於網絡，無網條件下依舊可以觸發；本地通知的定時時間是自發送時算起的，不受中間關機等操作的影響。本地通知與網絡推送的通知是相互獨立的，不受保留最近通知條數上限的限制。本地通知適用於在特定時間發出的通知，如一些Todo和鬧鍾類的應用，在每周、每月固定時間提醒用戶回到應用查看任務

集成極光推送主要有兩種方式，一種是jcenter 自動集成，另外一種是手動集成，這里主要介紹下jcenter 自動集成，手動集成的可參考官方文檔

 1：我們先在module的gradle中添加依賴

 compile 'cn.jiguang.sdk:jpush:3.0.3'  // 此處以JPush 3.0.3 版本為例。
 compile 'cn.jiguang.sdk:jcore:1.1.1'  // 此處以JCore 1.1.1 版本為例。

2：確認android studio的 Project 根目錄的主 gradle 中配置了jcenter支持。（新建project默認配置就支持）

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

allprojets {
    repositories {
        jcenter()
    }
}

3：在module的gradle中的defaultconfig添加AndroidManifest的替換變量

   ndk {
            //選擇要添加的對應cpu類型的.so庫。
            abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a'
            // 還可以添加 'x86', 'x86_64', 'mips', 'mips64'
        }

        manifestPlaceholders = [
                JPUSH_PKGNAME: applicationId,
                JPUSH_APPKEY : "4f44ddfa7aa983a7df72b5b3", //JPush上注冊的包名對應的appkey.
                JPUSH_CHANNEL: "developer-default", //用戶渠道統計的渠道名稱
        ]

4：在AndroidManifest中添加JPusService並配置android:process參數將PushService放在其他進程中：

 <!-- Required SDK 核心功能-->
        <!-- 可配置android:process參數將PushService放在其他進程中 -->
        <service
            android:name="cn.jpush.android.service.PushService"
            android:process=":pushcore"
            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>

至此，集成極光推送完畢，那我們怎么使用呢？其實你可以下一個官方的Demo JPushExample研究研究

1：首先我們要在Application中設置JPush調試模式和初始化SDK

/**
 * Created by kebinran on 2017/7/20.
 */

public class APP extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        //設置調試模式
        JPushInterface.setDebugMode(true);
        //init 初始化SDK
        JPushInterface.init(this);
    }
}

2：自定義的廣播接收器並編寫邏輯代碼，你可以更快捷的從JPushExample中復制響應的代碼在上面修改即可

package com.example.kebinran.jpushdemo;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.support.v4.content.LocalBroadcastManager;
import android.text.TextUtils;

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

import java.util.Iterator;

import cn.jpush.android.api.JPushInterface;

/**
 * 自定義接收器
 * 
 * 如果不定義這個 Receiver，則：
 * 1) 默認用戶會打開主界面
 * 2) 接收不到自定義消息
 */
public class MyReceiver extends BroadcastReceiver {
    private static final String TAG = "JIGUANG-Example";

    @Override
    public void onReceive(Context context, Intent intent) {
        try {
            Bundle bundle = intent.getExtras();
            Logger.d(TAG, "[MyReceiver] onReceive - " + intent.getAction() + ", extras: " + printBundle(bundle));

            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);

            } 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);

            } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
                Logger.d(TAG, "[MyReceiver] 用戶點擊打開了通知");

                //打開自定義的Activity
                Intent i = new Intent(context, MainActivity.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);

            } 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){

        }

    }

    // 打印所有的 intent extra 數據
    private static String printBundle(Bundle bundle) {
        StringBuilder sb = new StringBuilder();
        for (String key : bundle.keySet()) {
            if (key.equals(JPushInterface.EXTRA_NOTIFICATION_ID)) {
                sb.append("\nkey:" + key + ", value:" + bundle.getInt(key));
            }else if(key.equals(JPushInterface.EXTRA_CONNECTION_CHANGE)){
                sb.append("\nkey:" + key + ", value:" + bundle.getBoolean(key));
            } else if (key.equals(JPushInterface.EXTRA_EXTRA)) {
                if (TextUtils.isEmpty(bundle.getString(JPushInterface.EXTRA_EXTRA))) {
                    Logger.i(TAG, "This message has no Extra data");
                    continue;
                }

                try {
                    JSONObject json = new JSONObject(bundle.getString(JPushInterface.EXTRA_EXTRA));
                    Iterator<String> it =  json.keys();

                    while (it.hasNext()) {
                        String myKey = it.next().toString();
                        sb.append("\nkey:" + key + ", value: [" +
                                myKey + " - " +json.optString(myKey) + "]");
                    }
                } catch (JSONException e) {
                    Logger.e(TAG, "Get message extra JSON error!");
                }

            } else {
                sb.append("\nkey:" + key + ", value:" + bundle.getString(key));
            }
        }
        return sb.toString();
    }
    
    //send msg to MainActivity
    private void processCustomMessage(Context context, Bundle bundle) {
        if (MainActivity.isForeground) {
            String message = bundle.getString(JPushInterface.EXTRA_MESSAGE);
            String extras = bundle.getString(JPushInterface.EXTRA_EXTRA);
            Intent msgIntent = new Intent(MainActivity.MESSAGE_RECEIVED_ACTION);
            msgIntent.putExtra(MainActivity.KEY_MESSAGE, message);
            if (!ExampleUtil.isEmpty(extras)) {
                try {
                    JSONObject extraJson = new JSONObject(extras);
                    if (extraJson.length() > 0) {
                        msgIntent.putExtra(MainActivity.KEY_EXTRAS, extras);
                    }
                } catch (JSONException e) {

                }

            }
            LocalBroadcastManager.getInstance(context).sendBroadcast(msgIntent);
        }

    }
}

別忘了在AndroidManifest中聲明

  <!-- User defined.  For test only  用戶自定義的廣播接收器-->
        <receiver
            android:name=".MyReceiver"
            android:enabled="true"
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTRATION" /> <!--Required  用戶注冊SDK的intent-->
                <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.CONNECTION" /><!-- 接收網絡變化 連接/斷開 since 1.6.3 -->
                <category android:name="com.example.kebinran.jpushdemo" />
            </intent-filter>
        </receiver>