个推真是个磨人的小妖精啊...啊.....

个推官网：个推官网

android文档：android 个推文档

推送的Json串中带url时踩过的坑：JsonObject解析url报Method threw 'org.json.JSONException' exception.

1、创建个推应用

登录 http://dev.getui.com ，选择登记应用并填写应用名称和包名信息，完成应用创建

image image

点击应用配置，获取到相应的AppID、AppKey、AppSecret信息：

image

2、配置依赖

添加Maven库地址

在以项目名为命名的顶层build.gradle文件中，添加个推maven库地址，如下所示：

//Maven URL地址
maven {
    url "http://mvn.gt.igexin.com/nexus/content/repositories/releases/"
}

在app/build.gradle文件中引用个推SDK依赖库，如下图所示：

dependencies {
 implementation 'com.getui:sdk:2.12.5.0'
}

在app/build.gradle文件中的android.defaultConfig下指定所需的 CPU 架构：

android {
  ...
  defaultConfig {
    ...
    ndk {
      abiFilters "armeabi", "armeabi-v7a", "x86_64"
    }
  }
}

配置个推应用参数

在app/build.gradle文件中的android.defaultConfig下添加manifestPlaceholders，配置个推相关的应用参数：

manifestPlaceholders = [
    GETUI_APP_ID : "APP_ID",
    GETUI_APP_KEY : "APP_KEY",
    GETUI_APP_SECRET : "APP_SECRET"
]

请根据在后台创建应用获取到的应用参数进行相应替换APP_ID、APP_KEY、APP_SECRET的值

适配Android P

Android9.0以上默认不支持http通信，为保证SDK正常使用
请在application节点下新增该属性

<application android:usesCleartextTraffic="true">

3、添加权限声明

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<uses-permission android:name="android.permission.VIBRATE" />

<uses-permission android:name="android.permission.GET_TASKS" />

<!-- 支持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" />

<!-- 浮动通知权限 -->

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<!-- 自定义权限 -->

<uses-permission android:name="getui.permission.GetuiService.${applicationId}" />

<permission

    android:name="getui.permission.GetuiService.${applicationId}"

    android:protectionLevel="normal" >

</permission>

<!-- 个推SDK权限配置结束 -->

4、导入通知栏图标

为了修改默认的通知图标以及通知栏顶部提示小图标，请在资源目录的res/drawable-ldpi/、res/drawable-mdpi/、res/drawable-hdpi/、res/drawable-xhdpi/、res/drawable-xxhdpi/等各分辨率目录下，放置相应尺寸的文件名为push.png和push_small.png图片

建议的push.png图片尺寸如下 ：(但是我好像没遵守也行)

ldpi:4848
mdpi:6464
hdpi:9696
xhdpi:128128
xxhdpi:192*192

建议的push_small.png图片尺寸如下：(但是我好像没遵守也行)

ldpi:1818
mdpi:2424
hdpi:3636
xhdpi:4848
xxhdpi:7272
xxxhdp:9696

5、 接收推送服务事件

在 接收推送服务事件项目源码中添加一个继承自com.igexin.sdk.GTIntentService的类，用于接收CID、透传消息以及其他推送服务事件。请参考下列代码实现各个事件回调方法：

public void onReceiveMessageData(Context context, GTTransmitMessage msg)是透传消息的处理

通知推送时下面有个高级设置，这个里面的透传消息可以在那里设置，如果后端使用的NotificationTemplate模板，那么点击后才会回调此方法，在这个里面可以 进行消息处理并进行分发跳转, 可以用EventBus传递到所有界面透传消息也会传到这个方法里面,绑定别名推送不分IOS还是android，android会直接走到这个里面，会导致自动跳转，透传的message中可以写一个type，标记是android还是IOS，客户端进行判处理(我是这样解决的)

package com.getui.demo;

import android.content.Context;
import android.os.Message;
import android.util.Log;

import com.igexin.sdk.GTIntentService;
import com.igexin.sdk.PushConsts;
import com.igexin.sdk.PushManager;
import com.igexin.sdk.message.FeedbackCmdMessage;
import com.igexin.sdk.message.GTCmdMessage;
import com.igexin.sdk.message.GTTransmitMessage;
import com.igexin.sdk.message.SetTagCmdMessage;

import org.json.JSONObject;

/**
 * 继承 GTIntentService 接收来自个推的消息, 所有消息在线程中回调,
 * 如果注册了该服务, 则务必要在 AndroidManifest中声明, 否则无法接受消息<br>
 * <p>
 * onReceiveMessageData 处理透传消息<br>
 * <p>
 * onReceiveClientId 接收 cid <br>
 * <p>
 * onReceiveOnlineState cid 离线上线通知 <br>
 * <p>
 * onReceiveCommandResult 各种事件处理回执 <br>
 */
public class IntentService extends GTIntentService {

    public DemoIntentService() {

    }

    @Override
    public void onReceiveServicePid(Context context, int pid) {

    }


    @Override
    public void onReceiveMessageData(Context context, GTTransmitMessage msg) {
        byte[] payload = msg.getPayload();
        String message = new String(payload);
        Log.i(TAG, "onReceiveMessageData: " + message);
        try {
            JSONObject json = new JSONObject(message);
            String pushType = json.getString("PHONE_TYPE");
            if ("ANDROID".equals(pushType)) {
                //new UsuallyEvent(message, UsuallyEvent.PUSH)是自己写的Event
                EventBus.getDefault().post(new UsuallyEvent(message, UsuallyEvent.PUSH));
            }
        } catch (Exception e) {
            Log.e(TAG, e.toString());
        }

    }

    @Override
    public void onReceiveClientId(Context context, String clientid) {

        Log.e(TAG, "onReceiveClientId -> " + "clientid = " + clientid);

    }

    @Override
    public void onReceiveOnlineState(Context context, boolean online) {

    }

    @Override
    public void onReceiveCommandResult(Context context, GTCmdMessage cmdMessage) {

    }

    @Override
    public void onNotificationMessageArrived(Context context, GTNotificationMessage msg) {

    }

    @Override
    public void onNotificationMessageClicked(Context context, GTNotificationMessage msg) {

    }

}

在AndroidManifest.xml中配置上述 IntentService 类：

<service android:name="com.getui.demo.IntentService"/>

6、 初始化SDK并注册com.getui.demo.IntentService

PushManager.getInstance().initialize(this.getApplicationContext(),PushService.class);
// com.getui.demo.IntentService 为第三方自定义的推送服务事件接收类
PushManager.getInstance().registerPushIntentService(this.getApplicationContext(), com.getui.demo.IntentService.class);

7、测试

连接手机或启动Android模拟器，编译运行你的工程，查看logcat信息。在搜索框中输入clientid，如果能显示clientid is xxx日志，则说明个推SDK已经成功运行起来了,去后台推送就行了：

image