android jpush(極光推送)快速集成

在日常生活中,我們經常見到手機上的軟件在通知欄提醒,各種新聞,軟件更新提示等等。。都涉及到了推送服務。

推送服務,可以主動、及時地向您的用戶發起交互,向其發送聊天消息、

日程提醒、活動預告、進度提示、動態更新等。

精準的目標用戶和有價值的推送內容可以提升用戶忠誠度,提高留存率與收入。

本文介紹的是  極光推送 與android 的集成。

官網:www.jiguang.cn

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/ 對應同名的目錄下。
注:複製layout、values文件夾中的內容時,要將重複文件的內容合併,而非簡單覆蓋。

6、配置 AndroidManifest.xml

根據 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的部分是必須的代碼,用戶自定義的部分不是必須的。
7、創建 一個類繼承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

  1. package com.text.push;  
  2.   
  3. import android.content.BroadcastReceiver;  
  4. import android.content.Context;  
  5. import android.content.Intent;  
  6. import android.os.Bundle;  
  7. import android.util.Log;  
  8.   
  9. import org.json.JSONException;  
  10. import org.json.JSONObject;  
  11.   
  12. import cn.jpush.android.api.JPushInterface;  
  13.   
  14. /** 
  15.  */  
  16. public class PushReceiver extends BroadcastReceiver {  
  17.     private static final String TAG = "PushReceiver";  
  18.   
  19.     //當受到消息,會回調onReceive()方法,onReceive中解析  
  20.     @Override  
  21.     public void onReceive(Context context, Intent intent) {  
  22.   
  23.         Bundle bundle = intent.getExtras();  
  24.         Log.d(TAG, "onReceive - " + intent.getAction());  
  25.   
  26.         //註冊  
  27.         if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {  
  28.   
  29.             //收到自定義消息  
  30.         }else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {  
  31.             //自定義消息可以發送json數據  
  32.             System.out.println("收到了自定義消息。消息內容是:" + bundle.getString(JPushInterface.EXTRA_MESSAGE));  
  33.             // 自定義消息不會展示在通知欄,完全要開發者寫代碼去處理  
  34.         } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {  
  35.             System.out.println("收到了通知");  
  36.             // 在這裏可以做些統計,或者做些其他工作(通知欄被點擊)  
  37.         } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {  
  38.             System.out.println("用戶點擊打開了通知");  
  39.             // 在這裏可以自己寫代碼去定義用戶點擊後的行爲  
  40.             //保存服務器推送下來的附加字段。這是個 JSON 字符串。  
  41.             String extras = bundle.getString(JPushInterface.EXTRA_EXTRA);  
  42.             System.out.println("附加信息:"+extras);  
  43.             try {  
  44.                 JSONObject obj = new JSONObject(extras);  
  45.                 String url = obj.getString("url");  
  46.                 System.out.println("url:"+url);  
  47.                 //跳瀏覽器  
  48.             } catch (JSONException e) {  
  49.                 e.printStackTrace();  
  50.             }  
  51.         } else {  
  52.             Log.d(TAG, "Unhandled intent - " + intent.getAction());  
  53.         }  
  54.     }  
  55.  
9、配置和代碼說明

必須權限說明

權限 用途
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/


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章