消息推送這個玩意,大部分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.lxweimin.com/users/630d98ed1424