【快速搞定】2分鐘搞定極光推送(極光推送Android端集成)
一翘紊、前言
2分鐘只是一個虛數(shù)哈公壤,不過只要你速度快,兩分鐘還真是能搞定的哦衬潦。在2.1.8版本以前,極光的配置還是非常麻煩的植酥,需要在清單文件(AndroidManifest.xml)里面各種配置,篇幅非常大弦牡∮淹裕可能極光的開發(fā)者也意識到了這點,所以在2.1.8之后就加入了gradle的配置驾锰,簡化了非常多的配置步驟卸留。本文旨在通過簡潔的步驟來快速完成極光的配置。(登錄椭豫、注冊和創(chuàng)建應用小白都會耻瑟,這里就不貼教程了,直接上配置)
二赏酥、SDK配置
第一步喳整、Gradle配置(Module的build.gradle)
首先,確保你的 ** minSdkVersion ** 在15及以上版本裸扶,然后defaultConfig中加入下面的代碼(AppKey需要換成你的應用哦):
ndk {
//選擇要添加的對應cpu類型的.so庫(不需要的刪除即可)框都。
abiFilters 'armeabi', 'armeabi-v7a', 'armeabi-v8a', 'x86', 'x86_64', 'mips', 'mips64'
}
manifestPlaceholders = [
JPUSH_PKGNAME: applicationId,
JPUSH_APPKEY : "6c86501ae0e99b5cfd30b1d0", //JPush上注冊的包名對應的appkey(*換成你的*)
JPUSH_CHANNEL: "developer-default", //暫時填寫默認值即可.
]
來張圖更直觀一點:
第二步、添加依賴
還是Module的build.gradle文件中哦
compile 'cn.jiguang.sdk:jpush:3.0.1' // 此處以JPush 3.0.1 版本為例呵晨。
compile 'cn.jiguang.sdk:jcore:1.1.0' // 此處以JCore 1.1.0 版本為例魏保。
至此,只需同步一下即可自動配置sdk
如果報錯的話摸屠,需要在Project的gradle.properties文件中添加下面的代碼:
android.useDeprecatedNdk=true
第三步谓罗、混淆
在ProGuard文件(即proguard-rules.pro)中加入混淆代碼:
-dontoptimize-dontpreverify-dontwarn cn.jpush.**-keep class cn.jpush.** { *; }
第四步、初始化
新建一個MyApplication類(繼承至Application)季二,并在清單文件(AndroidManifest.xml)的application節(jié)點添加name屬性關聯(lián)MyApplication檩咱。在MyApplication的onCreate方法中加入初始化的代碼:
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate(); //初始化sdk
JPushInterface.setDebugMode(true);//正式版的時候設置false,關閉調試
JPushInterface.init(this); //建議添加tag標簽胯舷,發(fā)送消息的之后就可以指定tag標簽來發(fā)送了
Set<String> set = new HashSet<>();
set.add("andfixdemo");//名字任意税手,可多添加幾個
JPushInterface.setTags(this, set, null);//設置標簽
}
}
第五步、創(chuàng)建自定義廣播接收器
極光推送是需要自定義一個廣播器來接收推送消息的需纳。下面是官方demo的MyReceiver芦倒。(限于篇幅,省略了部分代碼不翩,需要的可以到最后給出的github中或官方demo下載)
自定義接收器:如果不定義這個 Receiver兵扬,則:
- 默認用戶會打開主界面
- 接收不到自定義消息
public class MyReceiver extends BroadcastReceiver {
private static final String TAG = "JPush";
@Override
public void onReceive(Context context, Intent intent) {
Bundle bundle = intent.getExtras();
Log.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);
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));
processCustomMessage(context, bundle);
} 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));
//在這里根據(jù) JPushInterface.EXTRA_EXTRA 的內容處理代碼麻裳,比如打開新的Activity, 打開一個網(wǎng)頁等..
} 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());
}
}
// 打印所有的 intent extra 數(shù)據(jù)
private static String printBundle(Bundle bundle) { ...//省略了 }
//send msg to MainActivity
private void processCustomMessage(Context context, Bundle bundle) { ...//省略了 }
}
還沒完器钟,因為廣播接收器是android四大組件之一津坑,所以需要在清單文件中加入下面的配置哦。
<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.ACTION_RICHPUSH_CALLBACK" />
<!--Optional 用戶接受Rich Push Javascript 回調函數(shù)的intent-->
<action android:name="cn.jpush.android.intent.CONNECTION" />
<!-- 接收網(wǎng)絡變化 連接/斷開 since 1.6.3 -->
<category android:name="com.hdl.jpushdemo" />
</intent-filter>
</receiver>
第六步傲霸、測試
1疆瑰、 進入極光推送管理后臺,選擇當前應用昙啄,推送穆役,發(fā)送通知,填下推送的內容梳凛,選擇目標人群耿币,點擊發(fā)送即可。
2韧拒、 手機端