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/
简书://www.greatytc.com/users/630d98ed1424

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,347评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,435评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,509评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,611评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,837评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,987评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,730评论 0 267
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,194评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,525评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,664评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,334评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,944评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,764评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,997评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,389评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,554评论 2 349

推荐阅读更多精彩内容

  • 前言 在Android开发中,消息推送功能的使用非常常见。 为了降低开发成本,使用第三方推送是现今较为流行的解决方...
    Carson带你学安卓阅读 36,494评论 17 134
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • 想看吐槽的点链接: 一步步走来的消息推送 详细集成指南,请点这里! android消息推送的好消息: 安卓统一推送...
    元涛阅读 1,587评论 0 6
  • 记忆看不到明天 眼泪数不清过往 卑微挽不回昨天 抱歉对不起曾经 落日余晖美得让我想哭 句句欺骗伤得让我窒息 曾经我...
    魅惑琉璃阅读 196评论 4 0
  • 《深度学习的艺术》这本书是知乎大V采铜的作品,虽然书的内容不多,但其中所包含的思想却值得去认真地思索,通过阅读对自...
    致远007阅读 417评论 0 3