一、整合SDK(這裡推薦自動整合)
1.確認android studio的 Project 根目錄的主 gradle 中配置了jcenter支援。(一般預設支援)
buildscript {
repositories {
jcenter()
}
...
}
allprojects {
repositories {
jcenter()
}
}
2.在 module 的 gradle 中添加依賴和AndroidManifest的替換變數
android {
...
defaultConfig {
applicationId "xx.xxx.xxxx"<code>//JPush上註冊的包名
...
ndk {
//選擇要添加的對應cpu類型的.so庫。
abiFilters 'armeabi', 'armeabi-v7a', 'armeabi-v8a','x86', 'x86_64', 'mips', 'mips64'
}
manifestPlaceholders = [
JPUSH_PKGNAME : applicationId,
JPUSH_APPKEY : "你的appkey", //JPush上註冊的包名對應的appkey.
JPUSH_CHANNEL : "developer-default", //暫時填寫預設值即可.
]
...
}
...
}
dependencies {
compile 'cn.jiguang:jpush:2.2.0'
...
}
二、在AndroidManifest中配置許可權
<!-- 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" />
三、代碼
建立一個Application,並添加一下代碼
@Override
public void onCreate() {
super.onCreate();
JPushInterface.setDebugMode(true); // 設定開啟日誌,發布時請關閉日誌
JPushInterface.init(this); // 初始化 JPush
}
說明:
1.init 只需要在應用程式啟動時調用一次該 API 即可
2.以上 Application 類。需要在 AndoridManifest.xml 裡配置
到此,極光推送的準系統已經完成,推播通知後應用程式會接收到通知,通知預設表徵圖為應用程式圖示,點擊通知會開啟程式首頁。
但是,當你的應用程式是開啟狀態時,點擊通知後會重新運行一次程式並開啟首頁,顯然這不是我們想要的,我們還需要配置接受到通知之後的響應動作。
四、自訂一個接收器
/**
* 自訂接收器
*
* 如果不定義這個 Receiver,則:
* 1) 預設使用者會開啟主介面
* 2) 接收不到自訂訊息
*/
public class MyReceiver extends BroadcastReceiver {
private static final String TAG = "JPush";
@Override
public void onReceive(Context context, Intent intent) {
Bundle bundle = intent.getExtras();//接收到的訊息
if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
String regId = bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);
Log.d(TAG, "[MyReceiver] 接收Registration Id : " + regId);
//send the Registration Id to your server...
} else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
Log.d(TAG, "[MyReceiver] 接收到推送下來的自訂訊息: " + bundle.getString(JPushInterface.EXTRA_MESSAGE));
} else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
Log.d(TAG, "[MyReceiver] 接收到推送下來的通知");
int notifactionId = bundle.getInt(JPushInterface.EXTRA_NOTIFICATION_ID);
Log.d(TAG, "[MyReceiver] 接收到推送下來的通知的ID: " + notifactionId);
} else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
Log.d(TAG, "[MyReceiver] 使用者點擊開啟了通知");
//開啟自訂的Activity
Intent i = new Intent(context, TestActivity.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())) {
Log.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);
Log.w(TAG, "[MyReceiver]" + intent.getAction() +" connected state change to "+connected);
} else {
Log.d(TAG, "[MyReceiver] Unhandled intent - " + intent.getAction());
}
}
}
並在 AndoridManifest.xml 中配置
</pre>
<pre><!-- 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="xx.xxx.xxxx" />
</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" android:exported="false"/>
<!-- User defined. For test only 使用者自訂的廣播接收器-->
<receiver
android:name=".MyReceiver"
android:enabled="true"
android:exported="true">
<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.ACTION_RICHPUSH_CALLBACK" /> <!--Optional 使用者接受Rich Push Javascript 回呼函數的intent-->
<action android:name="cn.jpush.android.intent.CONNECTION" /><!-- 接收網路變化 串連/斷開 since 1.6.3 -->
<category android:name="cn.zmit.yanmai" />
</intent-filter>
</receiver></pre>
<pre>