Android集成“小米消息推送”详细教程

消息推送这个玩意，大部分APP都有的，你像QQ、淘宝、微博、支付宝、网易新闻等，他们的消息推送简直伤心病狂。
常见的第三方消息推送方案有这些：

• 极光推送
• 友盟推送
• 个推
• 小米推送
• 腾讯信鸽
• 百度云推送
• 阿里云推送

今天不讲别的，就讲讲小米推送的集成教程，说实话挺简单的，步骤也不多，推送效果尚可。

1、下载小米消息推送SDK
下载地址：http://dev.xiaomi.com/mipush/downpage/
里面包括Eclipse和Android Studio开发Demo，包括SDK jar包。
小米推送服务Android版客户端SDK使用指南：http://dev.xiaomi.com/doc/?p=544

2、注册小米账号，并在小米开放平台创建应用
创建应用地址：http://dev.xiaomi.com/myitems
我的应用包名：com.sdc.cfm
创建应用后会得到一些APPID，APPKey，APPSecret等信息。

3、参照Android Studio的开发demo进行集成
先把jar包拷贝到项目的libs文件夹，然后选中jar包右键选择“add library”引入。

4、打开项目的AndroidManifest.xml文件，把Demo中使用的权限拷贝进去。
把权限中“com.xiaomi.mipushdemo”包名替换成自己项目的包名，比如我的包名：com.sdc.cfm

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

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

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

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

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

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

<!-- the following 2 com.xiaomi.mipushdemo should be changed to your package name -->
<permission
android:name="com.sdc.cfm.permission.MIPUSH_RECEIVE"
android:protectionLevel="signature" />

<uses-permission android:name="com.sdc.cfm.permission.MIPUSH_RECEIVE" />
<uses-permission android:name="android.permission.VIBRATE" />

5、把AndroidManifest.xml文件中注册的service和receiver拷贝到自己项目中。
把name中“com.xiaomi.mipushdemo”包名替换成自己项目的包名。

<service
    android:name="com.xiaomi.push.service.XMJobService"
    android:enabled="true"
    android:exported="false"
    android:permission="android.permission.BIND_JOB_SERVICE"
    android:process=":pushservice" />

<service
    android:name="com.xiaomi.push.service.XMPushService"
    android:enabled="true"
    android:process=":pushservice" />

<service
    android:name="com.xiaomi.mipush.sdk.PushMessageHandler"
    android:enabled="true"
    android:exported="true" />
<service
    android:name="com.xiaomi.mipush.sdk.MessageHandleService"
    android:enabled="true" />

<receiver
    android:name="com.sdc.cfm.DemoMessageReceiver"
    android:exported="true">
    <intent-filter>
    <action android:name="com.xiaomi.mipush.RECEIVE_MESSAGE" />
    </intent-filter>
    <intent-filter>
    <action android:name="com.xiaomi.mipush.MESSAGE_ARRIVED" />
    </intent-filter>
    <intent-filter>
         <action android:name="com.xiaomi.mipush.ERROR" />
    </intent-filter>
</receiver>

<receiver
    android:name="com.xiaomi.push.service.receivers.NetworkStatusReceiver"
    android:exported="true">
    <intent-filter>
    <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
    <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</receiver>

<receiver
    android:name="com.xiaomi.push.service.receivers.PingReceiver"
    android:exported="false"
    android:process=":pushservice">
    <intent-filter>
    <action android:name="com.xiaomi.push.PING_TIMER" />
    </intent-filter>
</receiver>

6、参照DemoApplication.java文件在自己的Application文件中初始化小米推送。
比如我的Application文件为MyApplication，记得要在AndroidManifest.xml中命名。
在oncreate()方法中调用initXiaomiPush()方法。

//小米消息推送APP_ID ，APP_KEY 
private static final String APP_ID = " ";
private static final String APP_KEY = " ";
private static DemoHandler sHandler = null;
private static MainActivity sMainActivity = null;

@Override
public void onCreate() {
    super.onCreate();
    initXiaomiPush();
}

/** 初始化小米消息推送 **/
private void initXiaomiPush(){
    // 注册push服务，注册成功后会向DemoMessageReceiver发送广播
    // 可以从DemoMessageReceiver的onCommandResult方法中MiPushCommandMessage对象参数中获取注册信息
    if (shouldInit()) {
        MiPushClient.registerPush(this, APP_ID, APP_KEY);
    }

    LoggerInterface newLogger = new LoggerInterface() {

        @Override
        public void setTag(String tag) {
            // ignore
        }

        @Override
        public void log(String content, Throwable t) {
            Log.d(TAG, content, t);
        }

        @Override
        public void log(String content) {
            Log.d(TAG, content);
        }
    };
    Logger.setLogger(this, newLogger);
    if (sHandler == null) {
        sHandler = new DemoHandler(getApplicationContext());
    }
}

private boolean shouldInit() {
    ActivityManager am = ((ActivityManager) getSystemService(Context.ACTIVITY_SERVICE));
    List<ActivityManager.RunningAppProcessInfo> processInfos = am.getRunningAppProcesses();
    String mainProcessName = getPackageName();
    int myPid = Process.myPid();
    for (ActivityManager.RunningAppProcessInfo info : processInfos) {
        if (info.pid == myPid && mainProcessName.equals(info.processName)) {
            return true;
        }
    }
    return false;
}

public static DemoHandler getHandler() {
    return sHandler;
}

public static void setMainActivity(MainActivity activity) {
    sMainActivity = activity;
}

public static class DemoHandler extends Handler {
    private Context context;
    public DemoHandler(Context context) {
        this.context = context;
    }
    @Override
    public void handleMessage(Message msg) {
        String s = (String) msg.obj;
        if (sMainActivity != null) {
            sMainActivity.refreshLogInfo();
        }
        if (!TextUtils.isEmpty(s)) {
            Toast.makeText(context, s, Toast.LENGTH_LONG).show();
        }
    }
}

7、把DemoMessageReceiver.java文件拷贝到项目中。
然后，修改AndroidManifest.xml文件中DemoMessageReceiver注册的名字，包名修改为自己项目的包名。比如，我的包名：com.sdc.cfm

android:name="com.sdc.cfm.receiver.DemoMessageReceiver"

8、在MainActivity中设置别名等识别标识。

@Override 
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    MyApplication.setMainActivity(this);
    //设置别名，撤销别名（alias）
    MiPushClient.setAlias(MainActivity.this, "demo1", null);
    //MiPushClient.unsetAlias(MainActivity.this, "demo1", null);
    //设置账号，撤销账号（account）
    MiPushClient.setUserAccount(MainActivity.this, "user1", null);
    //MiPushClient.unsetUserAccount(MainActivity.this, "user1", null);
    //设置标签，撤销标签（topic：话题、主题）
    MiPushClient.subscribe(MainActivity.this, "IT", null);
    //MiPushClient.unsubscribe(MainActivity.this, "IT", null);
    //设置接收时间（startHour, startMin, endHour, endMin）
    MiPushClient.setAcceptTime(MainActivity.this, 7, 0, 23, 0, null);
    //暂停和恢复推送
    //MiPushClient.pausePush(MainActivity.this, null);
    //MiPushClient.resumePush(MainActivity.this, null);
}

@Override
protected void onDestroy() {
    super.onDestroy();
    MyApplication.setMainActivity(null);
}

9、运行自己的项目，并在小米推送后台设置推送消息，等待APP接收消息。
设置推送消息：http://admin.xmpush.xiaomi.com/v2/tool/nb

10、到此集成完毕，如果没有意外，会很快收到推送的消息。
推送统计：http://admin.xmpush.xiaomi.com/v2/statistics/push

如有疑问，欢迎指正！

个人简介：
GitHub：https://github.com/sendtion
个人博客：http://sendtion.cn/
简书：http://www.jianshu.com/users/630d98ed1424