在日常生活中,我們經常見到手機上的軟件在通知欄提醒,各種新聞,軟件更新提示等等。。都涉及到了推送服務。
推送服務,可以主動、及時地向您的用戶發起交互,向其發送聊天消息、
日程提醒、活動預告、進度提示、動態更新等。精準的目標用戶和有價值的推送內容可以提升用戶忠誠度,提高留存率與收入。
本文介紹的是 極光推送 與android 的集成。
1、註冊登錄賬戶。
2、進入開發者服務後臺
3、創建應用
此處我用的是和android 的集成,ios的沒填,輸入應用名稱 和 自己要集成軟件的包名
4、下載demo
demo下載解壓,得到目錄結構
5、手動集成
- 解壓縮 jpush-android-release-3.x.y.zip 集成壓縮包。
- 複製 libs/jcore-android_v1.x.y.jar 到工程 libs/ 目錄下。
- 複製 libs/jpush-android_v3.x.y.jar 到工程 libs/ 目錄下。
- 複製 libs/(cpu-type)/libjcore1xy.so 到你的工程中存放對應cpu類型的目錄下。
- 複製 res/ 中drawable-hdpi, layout, values文件夾中的資源文件到你的工程中 res/ 對應同名的目錄下。
根據 SDK 壓縮包裏的 AndroidManifest.xml 樣例文件,來配置應用程序項目的 AndroidManifest.xml 。
主要步驟爲:
- 複製備註爲 "Required" 的部分
- 將標註爲“您應用的包名”的部分,替換爲當前應用程序的包名
- 將標註爲“您應用的Appkey”的部分,替換爲在Portal上註冊該應用的的Key,例如:9fed5bcb7b9b87413678c407
AndroidManifest 示例
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="您應用的包名"
android:versionCode="303"
android:versionName="3.0.3"
>
<uses-sdk android:minSdkVersion="9" android:targetSdkVersion="23" />
<!-- Required -->
<permission
android:name="您應用的包名.permission.JPUSH_MESSAGE"
android:protectionLevel="signature" />
<!-- 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.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" />
<!-- Optional. Required for location feature -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用於開啓 debug 版本的應用在6.0 系統上 層疊窗口權限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.GET_TASKS" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:name="Your Application Name">
<!-- 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="您應用的包名"/>
</intent-filter>
</service>
<!-- Required SDK核心功能-->
<receiver
android:name="cn.jpush.android.service.PushReceiver"
android:enabled="true" >
<intent-filter android:priority="1000">
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />
<category android:name="您應用的包名"/>
</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核心功能-->
<activity
android:name="cn.jpush.android.ui.PushActivity"
android:configChanges="orientation|keyboardHidden"
android:theme="@android:style/Theme.NoTitleBar"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="您應用的包名" />
</intent-filter>
</activity>
<!-- SDK核心功能-->
<activity
android:name="cn.jpush.android.ui.PopWinActivity"
android:configChanges="orientation|keyboardHidden"
android:exported="false"
android:theme="@style/MyDialogStyle">
<intent-filter>
<category android:name="android.intent.category.DEFAULT" />
<category android:name="您應用的包名" />
</intent-filter>
</activity>
<!-- Required SDK核心功能-->
<service
android:name="cn.jpush.android.service.DownloadService"
android:enabled="true"
android:exported="false" >
</service>
<!-- Required SDK核心功能-->
<receiver android:name="cn.jpush.android.service.AlarmReceiver" />
<!-- User defined. 用戶自定義的廣播接收器-->
<receiver
android:name="您自己定義的Receiver"
android:enabled="true">
<intent-filter>
<!--Required 用戶註冊SDK的intent-->
<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 用戶打開自定義通知欄的intent-->
<action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
<!-- 接收網絡變化 連接/斷開 since 1.6.3 -->
<action android:name="cn.jpush.android.intent.CONNECTION" />
<category android:name="您應用的包名" />
</intent-filter>
</receiver>
<!-- Required. For publish channel feature -->
<!-- JPUSH_CHANNEL 是爲了方便開發者統計APK分發渠道。-->
<!-- 例如: -->
<!-- 發到 Google Play 的APK可以設置爲 google-play; -->
<!-- 發到其他市場的 APK 可以設置爲 xxx-market。 -->
<!-- 目前這個渠道統計功能的報表還未開放。-->
<meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
<!-- Required. AppKey copied from Portal -->
<meta-data android:name="JPUSH_APPKEY" android:value="您應用的Appkey"/>
</application>
</manifest>
上方註釋標註Required的部分是必須的代碼,用戶自定義的部分不是必須的。
Application,初始化Application天然是單例的,可以把一些全局信息和全局的方法寫在Application中。
public class ExampleApplication extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); JPushInterface.init(this); } }
這樣,基本的功能都配置完了。
可以在極光官網推送實驗了。
8、自定義消息類 會用到上方代碼Receiver(註釋爲:<!-- User defined. 用戶自定義的廣播接收器-->)
MyReceiver.java
- package com.text.push;
- import android.content.BroadcastReceiver;
- import android.content.Context;
- import android.content.Intent;
- import android.os.Bundle;
- import android.util.Log;
- import org.json.JSONException;
- import org.json.JSONObject;
- import cn.jpush.android.api.JPushInterface;
- /**
- */
- public class PushReceiver extends BroadcastReceiver {
- private static final String TAG = "PushReceiver";
- //當受到消息,會回調onReceive()方法,onReceive中解析
- @Override
- public void onReceive(Context context, Intent intent) {
- Bundle bundle = intent.getExtras();
- Log.d(TAG, "onReceive - " + intent.getAction());
- //註冊
- if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
- //收到自定義消息
- }else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
- //自定義消息可以發送json數據
- System.out.println("收到了自定義消息。消息內容是:" + bundle.getString(JPushInterface.EXTRA_MESSAGE));
- // 自定義消息不會展示在通知欄,完全要開發者寫代碼去處理
- } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
- System.out.println("收到了通知");
- // 在這裏可以做些統計,或者做些其他工作(通知欄被點擊)
- } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
- System.out.println("用戶點擊打開了通知");
- // 在這裏可以自己寫代碼去定義用戶點擊後的行爲
- //保存服務器推送下來的附加字段。這是個 JSON 字符串。
- String extras = bundle.getString(JPushInterface.EXTRA_EXTRA);
- System.out.println("附加信息:"+extras);
- try {
- JSONObject obj = new JSONObject(extras);
- String url = obj.getString("url");
- System.out.println("url:"+url);
- //跳瀏覽器
- } catch (JSONException e) {
- e.printStackTrace();
- }
- } else {
- Log.d(TAG, "Unhandled intent - " + intent.getAction());
- }
- }
- }
必須權限說明
權限 | 用途 |
---|---|
You Package.permission.JPUSH_MESSAGE | 官方定義的權限,允許應用接收JPUSH內部代碼發送的廣播消息。 |
RECEIVE_USER_PRESENT | 允許應用可以接收點亮屏幕或解鎖廣播。 |
INTERNET | 允許應用可以訪問網絡。 |
WAKE_LOCK | 允許應用在手機屏幕關閉後後臺進程仍然運行 |
READ_PHONE_STATE | 允許應用訪問手機狀態。 |
WRITE_EXTERNAL_STORAGE | 允許應用寫入外部存儲。 |
READ_EXTERNAL_STORAGE | 允許應用讀取外部存儲。 |
WRITE_SETTINGS | 允許應用讀寫系統設置項。 |
VIBRATE | 允許應用震動。 |
MOUNT_UNMOUNT_FILESYSTEMS | 允許應用掛載/卸載 外部文件系統。 |
ACCESS_NETWORK_STATE | 允許應用獲取網絡信息狀態,如當前的網絡連接是否有效。 |
官方文檔
http://docs.jiguang.cn/jpush/client/Android/android_guide/