個推安卓推送SDK集成步驟詳解

以下是一位開發者在集成個推安卓推送SDK時候的親身經歷：
作者：吃飽了想睡。

概述

公司准備采用個推作為第三方推送平台，我作為客戶端的頭號小鳥，掐指一算已經畢業 0.1 年了，Leader 准備把這個簡單而又獨立的功能點交給我來處理，我緊張兮兮的打開官網集成文檔 學習了起來。其實早在自己大二的時候就集成過個推 SDK，溜達一圈又回來集成個推推送SDK了，發現現在的個推 SDK 與當年相比，集成起來真的方便多了。這次集成的是Android推送SDK，希望這篇文章，可以讓同學們可以更加快捷的集成個推推送。

思維導圖

詳細步驟

下載 demo

我的師傅大鳥哥告訴我，集成各類 SDK 的第一步驟都是下載個 Demo，先把 Demo 跑起來看看是什么鬼。咱也不敢問，咱也不敢說，先去下載個Demo玩玩。我選擇的是國內版本的個推 SDK，大家可以自行選擇要下載的版本。使用 AS 3.1 把 Getui_SDK_Demo_AS_maven 這個工程直接運行起來，出現了下面這個界面(此處已經對我個人參數進行了手動馬賽克)。

好了，按我大鳥哥的意思至少 demo 已經成功運行起來了，接下去就是去把上述的 APPID，APPKey 等參數換成自己的，那么這些參數又是怎么來的呢?

創建個推應用

看完 Demo 后，慌兮兮打開官網集成文檔，原來那些參數是需要創建應用才會獲得的，而 cid 是個推SDK 回調的，沒啥說的，那就 “注冊登錄-創建應用-獲取配置” 三連擊

注冊登錄賬號：

創建應用

登入成功后，點擊我的應用進入，再接着點擊右上角的《創建應用》就可以創建屬於自己的應用了，因為我已經創建完成，所以此處有城牆一樣厚的馬賽克🐩🐩🐩

填寫自身 APP 的基礎信息

敲黑板！！！，iOS 是默認不勾選的，聽說 iOS 有自帶的推送系統？先不管了，勾上再說，他們愛用不用。

獲取配置數據

由於我已經注冊完成了，填完后的界面就要靠大家自行腦補了。應用創建成功后，就可以查看我們創建的 APP 所綁定的配置信息了。

看到這里，我終於知道了之前 Demo 里面的那些配置信息是哪里來的了，為了保證我這些參數是有效的， 我還來了一波騷操作：把 Demo 里面的工程的包名換成自己創建 APP 的包名，appid等信息也進行了替換，發現成功拿到了 cid，問了下他們技術支持，大概意思是只要拿到 cid，集成就完成了 90 %！！！，鳥弟我激動的搓起了小手。后面的思路就清晰了，無非是把 Demo 里東西拷到自己的項目里面就完事了嘛。

添加依賴及配置

我使用 Maven 的方式集成了 2.13.2.0 版本的 SDK，選用 Maven是為了方(偷)便(懶)的集成！如果是選擇手動集成的，請瘋狂戳我
先看下他們的資料包的內容

看這個資料包，發現要導入的東西還是蠻多的，各種資源，我選擇了 Maven 集成，那么 jar 包& so 就無需導入了

添加 maven 庫

• 在項目根目錄的 build.gradle 中添加 maven 庫，不然 load 不到 jar 包

allprojects {
    repositories {

        maven {
          url 'http://mvn.gt.igexin.com/nexus/content/repositories/releases'
        }
    }
}

• 在 項目/app 目錄下的 build.gradle 中配置jar 包

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.getui:sdk:2.13.2.0'
}

配置之前創建的 appid 等

依葫蘆畫瓢，這里就直接從 demo 那邊拷過來就行了
千萬千萬要小心，認真核對每一個參數，如果出現空格或者 Appid 與 AppKey寫反這類的低級錯誤真的要檢查到哭😭😭😭

manifestPlaceholders = [
    GETUI_APP_ID : "你的 APPID",
    GETUI_APP_KEY : "你的 APP_KEY",
    GETUI_APP_SECRET : "你的 APP_SECRET"
]

導入個推 res 文件

千萬千萬別忘了，我之前就在這個地方踩了坑，使用 maven 集成就不再需要 so 文件，切記！

• 把 Getui_SDK_Demo_AS_maven/資源文件/res 里面的文件一一對應導入到自己項目中的 app/src/main/res 下面

配置可選權限

可選可不選的權限，我這邊是寫上了，因為我項目中正好也需要用到這些權限，美滋滋~

      <!-- 支持iBeancon 需要藍牙權限 -->
    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <!-- 支持個推3.0 電子圍欄功能 -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

配置自定義服務

Demo 里面還配置了自定義的 service，我也搞了后，官網上有這么一句話

為了讓推送服務在部分主流機型上更穩定運行，從2.9.5.0版本開始，個推支持第三方應用配置使用自定義Service來作為推送服務運行的載體

都這么說了，鳥弟我二話不說就 new 一個自定義服務，進行空實現即可

package com.xinwenwang.xy;

import com.igexin.sdk.PushService;

public class XyPushService extends PushService {

}

新建的 service 千萬別忘了把新建的 service 注冊到 AndroidManifest.xml 中，多么痛的領悟

<service
  android:name="com.xxxx.yyyy.XyPushService"
  android:exported="true"
  android:label="PushService"
  android:process=":pushservice">
</service>

深入一想也可以理解為啥要加個空實現的 service,就像集成微信分享一樣，微信分享也要求繼承一個指定的 activity。

編寫集成

這么一步步的走下來，要配置挺多東西的，終於要開始初始化 SDK 了 🤷‍♀️🤷‍♀️🤷‍♀️

初始化 SDK

com.igexin.sdk.PushManager.getInstance().initialize(getApplicationContext(), com.xxxx.yyyy.XyPushService.class);

我這邊是在開屏頁初始化個推推送的，大家可以隨意，只要在 activity 初始化即可，建議是初始化越早越好

接收推送服務事件

那么問題來了，搞了上面這么多東西，推送的消息或者透傳是怎么個接收法呢？一頭霧水有木有!我又跑回去看了看 Demo，發現還有個叫 DemoIntentService 的玩意，打開一看里面有很多很多的回調，鳥哥說的話果然帶勁呀，Demo 理解透，項目集成快！
建議大家直接把 Demo 中的 DemoIntentService 拷到自己的項目中，如果需要修改一些DemoIntentService 里面的內容，自便哈。記得修改個名字，不然放在自己的項目里面真的太 low 了！我暫名為 XyPushIntentService。

• 在AndroidManifest.xml中配置上述 IntentService 類：

       <!-- 用戶自定義服務繼承自GTIntentService,作為SDK與APP橋梁服務,用來接收各種消息和命令回復-->
        <service android:name=".XyPushIntentService"
            android:permission="android.permission.BIND_JOB_SERVICE"/>

• 在個推SDK初始化后，注冊上述 IntentService 類

// XyPushIntentService 為第三方自定義的推送服務事件接收類
PushManager.getInstance().registerPushIntentService(getApplicationContext(), XyPushIntentService.class);

測試

總算集成完了，導入上述東西需要細心些哈，漏了一步有的你難受的。
項目跑起來后，在 XyPushIntentService 會有 cid 的回調，最直觀的方法是在 logcat 里面輸入 clientid ，就可以看到在控制台輸出日志了，這個 clientID 相當於此 APP 在該設備上的唯一識別碼。

最后一步肯定是創建通知了。

這邊只是創建了一個最最最簡單的樣式僅供參考，我看這界面上的功能估計可以滿足各種運營的玩法了，我這邊就不獻丑了：）。
推送測試消息的時候，應用一定要在前台，在前台，在前台，重要的事情說三遍

尾聲

首次集成這類大型 SDK 讓我意想不到的順利，我和我的小伙伴們都😮驚呆了😮，后面我再仔細閱讀了下個推的文檔，他們家的功能還是很齊全的，我僅是進行了最基礎的集成而已，不過也可以滿足產品與運營的需求了。不得不提一句，他們的技術支持服務確實夠勁（此處確實是一條廣告實錘了~）,回復的快而准。現在我得趕緊去寫 Bug 了，告辭👋👋👋~~~

轉載自：https://blog.csdn.net/u013651405/article/details/99891093
作者：吃飽了想睡