?
官方文檔:
http://docs.jiguang.cn/jpush/client/Android/android_sdk/
?
手動集成步驟:
- 解壓縮 jpush-android-release-2.x.y.zip 集成壓縮包。
- 復制 libs/jpush-sdk-2.x.y.jar 到工程 libs/ 目錄下。
- 復制 libs/(cpu-type)/libjpush2xy.so 到你的工程中存放對應cpu類型的目錄下。
- 復制 res/ 中drawable-hdpi, layout, values文件夾中的資源文件到你的工程中 res/ 對應的目錄下。
說明 1:若沒有res/drawable-xxxx/jpush_notification_icon這個資源默認使用應用圖標作為通知icon,在5.0以上系統將應用圖標作為statusbar icon可能顯示不正常,用戶可定義沒有陰影和漸變色的icon替換這個文件,文件名不要變。
說明 2:使用android studio的開發者,如果使用jniLibs文件夾導入so文件,則僅需將所有cpu類型的文件夾拷進去;如果將so文件添加在module的libs文件夾下,注意在module的gradle配置中添加一下配置:
android {......sourceSets {main {jniLibs.srcDirs = ['libs']......}......}......}
配置 AndroidManifest.xml
根據 SDK 壓縮包里的 AndroidManifest.xml 樣例文件,來配置應用程序項目的 AndroidManifest.xml 。
主要步驟為:
- 復制備注為 "Required" 的部分
- 將備注為替換包名的部分,替換為當前應用程序的包名
- 將AppKey替換為在Portal上注冊該應用的的Key,例如(9fed5bcb7b9b87413678c407)
溫馨提示
如果使用android studio, 可在AndroidManifest中引用applicationId的值,在build.gradle配置中 defaultConfig節點下配置,如:
defaultConfig {applicationId "cn.jpush.example" // <--您應用的包名……}
<!--激光推送開始 -->
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<permission
android:name="com.lvshandian.huxinhoutai.permission.C2D_MESSAGE"
android:protectionLevel="signature" />
<uses-permission android:name="com.lvshandian.huxinhoutai.permission.C2D_MESSAGE" />
<permission
android:name="com.lvshandian.huxinhoutai.permission.JPUSH_MESSAGE"
android:protectionLevel="signature" />
<!-- Required -->
<uses-permission android:name="com.lvshandian.huxinhoutai.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.VIBRATE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--激光推送結束 -->
?
<!--極光推送開始-->
<!-- Rich push 核心功能 since 2.0.6 -->
<activity
android:name="cn.jpush.android.ui.PopWinActivity"
android:exported="false"
android:theme="@style/MyDialogStyle" />
<!-- Required SDK核心功能 -->
<activity
android:name="cn.jpush.android.ui.PushActivity"
android:configChanges="orientation|keyboardHidden"
android:exported="false"
android:theme="@android:style/Theme.NoTitleBar">
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="com.lvshandian.huxinhoutai" />
</intent-filter>
</activity>
<!-- Required SDK核心功能 -->
<service
android:name="cn.jpush.android.service.DownloadService"
android:enabled="true"
android:exported="false" />
<!-- Required SDK 核心功能 -->
<!-- 可配置android:process參數將PushService放在其他進程中 -->
<service
android:name="cn.jpush.android.service.PushService"
android:enabled="true"
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>
<!-- since 1.8.0 option 可選項。用于同一設備中不同應用的JPush服務相互拉起的功能。 -->
<!-- 若不啟用該功能可刪除該組件,將不拉起其他應用也不能被其他應用拉起 -->
<service
android:name="cn.jpush.android.service.DaemonService"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="cn.jpush.android.intent.DaemonService" />
<category android:name="com.lvshandian.huxinhoutai" />
</intent-filter>
</service>
<!-- 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="com.lvshandian.huxinhoutai" />
</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=".receiver.JpushReceiver"
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 回調函數的intent-->
<action android:name="cn.jpush.android.intent.CONNECTION" />
<!-- 接收網絡變化 連接/斷開 since 1.6.3 -->
<category android:name="com.lvshandian.huxinhoutai" />
</intent-filter>
</receiver>
<!-- Required . Enable it you can get statistics data with channel -->
<meta-data
android:name="JPUSH_CHANNEL"
android:value="developer-default" />
<meta-data
android:name="JPUSH_APPKEY"
android:value="df28ed0fc4f9fe8b37078764" />
<!-- </>值來自開發者平臺取得的AppKey-->
<!-- 極光推送結束-->
//初始化
JPushInterface.init(mContext);
JPushInterface.setDebugMode(true);
@Override
protected void onPause() {
super.onPause();
JPushInterface.onPause(this);
}
@Override
protected void onResume() {
super.onResume();
JPushInterface.onResume(this);
}
Android里配置:
sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}
遇得到的問題:
1.極光推送集成不成功:
解決辦法:
查看包名是否一致,將包名全部替換;
2.初始化三處:
解決辦法:
1)在Application中初始化;
2)在第一個啟動的Activity中配置注冊極光;
3)在gradle中添加;
3.找不到os文件
解決辦法:
如果是主os文件,每個文件夾下都得復制一個;
4.推送消息不同
通知和自定義消息不同;