消息推送这个玩意，大部分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
