jpush java api_JPush極光推送Java服務器端API

產品功能說明

極光推送(JPush)是一個端到端的推送服務，使得服務器端消息能夠及時地推送到終端用戶手機上，讓開發者積極地保持與用戶的連接，從而提高用戶活躍度、提高應用的留存率。極光推送客戶端支持 Android, iOS 兩個平台。

本 Android SDK 方便開發者基於 JPush 來快捷地為 Android App 增加推送功能。

主要功能

保持與服務器的長連接，以便消息能夠即時推送到達客戶端

接收通知與自定義消息，並向開發者App 傳遞相關信息

主要特點

客戶端維持連接占用資源少、耗電低

SDK豐富的接口，可定制通知欄提示樣式

服務器大容量、穩定

jpush-sdk_v1.x.y.zip 集成壓縮包內容

AndoridManifest.xml

客戶端嵌入SDK參考的配置文件

libs/jpush-sdk-release1.x.y.jar

SDK Java 開發包

libs/armeabi/libjpush.so

SDK native 開發包

example

是一個完整的 Android 項目，通過這個演示了 JPush SDK 的基本用法，可以用來做參考。

Android SDK 版本

目前SDK只支持Android 2.1或以上版本的手機系統。

SDK集成步驟

1、導入 SDK 開發包到你自己的應用程序項目

解壓縮 jpush-sdk_v1.x.y.zip 集成壓縮包

復制 libs/jpush-sdk-release1.x.y.jar 到工程 libs/ 目錄下

復制 libs/armeabi/libjpush.so 到工程 libs/armeabi 目錄下

如果您的項目有 libs/armeabi-v7a 這個目錄，請把 libjpush.so 也復制一份到這個目錄。

2、配置 AndroidManifest.xml

根據 SDK 壓縮包里的 AndroidManifest.xml 樣例文件，來配置應用程序項目的 AndroidManifest.xml 。

主要步驟為：

復制備注為 "Required" 的部分

將備注為替換包名的部分，替換為當前應用程序的包名

將AppKey替換為在Portal上注冊該應用的的Key,例如(9fed5bcb7b9b87413678c407)

3、添加代碼

JPush SDK 提供的 API 接口，都主要集中在 cn.jpush.android.api.JPushInterface 類里。

基礎 API

init 初始化SDK

setDebugMode 設置調試模式

調用示例代碼(參考 example 項目)

init 只需要在應用程序啟動時調用一次該 API 即可。

以下代碼定制一個本應用程序 Application 類。需要在 AndoridManifest.xml 里配置。請參考上面 AndroidManifest.xml 片斷，或者 example 項目。

4、測試確認

確認所需的權限都已經添加。如果必須的權限未添加，日志會提示錯誤。

確認 AppKey(在Portal上生成的)已經正確的寫入 Androidmanifest.xml 。

確認在程序啟動時候調用了init(context) 接口

確認測試手機(或者模擬器)已成功連入網絡

客戶端調用 init 后不久，如果一切正常，應有登錄成功的日志信息

啟動應用程序，在 Portal 上向應用程序發送自定義消息或者通知欄提示。詳情請參考管理Portal。

在幾秒內，客戶端應可收到下發的通知或者正定義消息

如果 SDK 工作正常，則日志信息會如下圖所示：

如圖所示，客戶端啟動分為 4 步：

檢查 metadata 的 appKey 和 channel ，如果不存在，則啟動失敗

初始化 JPush SDK，檢查 JNI 等庫文件的有效性，如果庫文件無效，則啟動失敗

檢查 Androidmanifest.xml，如果有 Required 的權限不存在，則啟動失敗

連接服務器登錄，如果存在網絡問題，則登陸失敗,或者前面三步有問題，不會啟動JPush SD

AppKey的獲取

進入極光的官方網站，登錄注冊，建立一個應用，創建成功后，點擊該應用進入詳情頁面就可以獲取appkey了

https://www.jpush.cn