MiPushFramework normal 与 vc105 版本怎么选一文读懂两种推送模式的差异【免费下载链接】MiPushFrameworkLet supported push service run system-ly on every Android devices项目地址: https://gitcode.com/gh_mirrors/mipu/MiPushFramework下载 MiPushFramework 时不少用户会在 normal 与 vc105 两个版本之间纠结同样是让手机用上小米系统级推送为什么会有两个版本它们到底有什么区别本文将从消息传递方式、兼容性、使用场景三个角度带你一文读懂 MiPushFramework 两种推送模式的差异并给出清晰的版本选择建议帮你快速做出决定。一、先搞清楚MiPushFramework 是干什么的MiPushFramework 是一款让非 MIUI 系统也能享受小米系统级推送的开源框架。它的核心价值在于让支持小米推送MiPush的 App 不需要常驻后台也能稳定收到消息从而省电、省内存、省流量。简单来说在 MIUI 手机上小米推送由系统完成App 无需后台在非 MIUI 手机上官方方案是每个 App 各自在后台拉起一个推送服务非常耗资源MiPushFramework 通过伪装为系统级推送服务com.xiaomi.xmsf让任意 Android 设备都能获得接近 MIUI 的系统级推送体验。而normal 与 vc105 版本就是这套框架的两种构建形态它们的核心差异在于消息传递方式。二、核心差异startService 与 bindService 两种消息传递方式1. vc105 版本使用 startService 传统方式vc105 版本采用startService()方式传递推送消息。App 通过Context.startService()启动XMPushService并在onStartCommand中处理 Intent 消息流程直接、传统兼容性非常好。这个版本对应推送服务105 版本号见 push/build.gradle 中vc105flavor 的versionCode 105。2. normal 版本使用 bindService Messenger 方式normal 版本对应 108 及以上的推送服务版本采用bindService()Messenger方式传递消息。App 与推送服务建立绑定连接后通过 Messenger 通道收发消息通信更高效、可控性更强。其消息链路可以参考 mipush_hook/readme.md 中的架构图Application通过Context.bindService()连接到XMPushService.Messenger再由send(what:17)触发onStart处理消息。3. 两种模式对比一览对比项vc105 版本normal 版本消息传递方式startService传统bindServiceMessenger推送服务版本号105108 及以上兼容性更好适配老系统较新个别 ROM 不兼容官方推荐备选方案✅ 首选方案典型适用场景COS 等特殊 ROM绝大多数用户三、我该选哪个版本版本选择建议来了根据项目官方说明目前建议优先使用 normal 版本遇到问题再切换为 vc105 版本。具体建议如下✅大多数用户默认选择直接使用normal 版本功能完整、体验最佳推送异常时的备选如果 normal 版本收不到推送或推送不稳定可切换到vc105 版本排查是否与消息传递方式有关MIUI 用户优先 normal 版本另一个好处是应用不会在重启系统后变回官方版本省去反复替换的烦恼COSColorOS 等用户建议使用vc105 版本目前已知 COS 系统无法使用 Bind 方式传递消息改用 startService 方式的 105 版本更稳妥。四、从源码看两种模式的实现差异如果你感兴趣可以在源码中看到两种模式的实现痕迹版本定义push模块的 build.gradle 中定义了normal、vc105、prebuilt三种 flavor其中vc105显式将versionCode设为105Messenger 实现normal 版本的绑定通信实现在 XMPushServiceMessenger.java架构说明两种启动方式的完整调用链见 mipush_hook/readme.md 中的流程图。另外注意 push/build.gradle 中的注释SDK 要求 XMSF 版本号不低于 105才会将消息交给系统级推送服务处理这也是 vc105 版本命名的由来。五、版本选择常见问题FAQQ1normal 和 vc105 哪个推送更稳定A对绝大多数 ROM 来说 normal 版本更稳定但如果你的 ROM 不兼容 Bind 方式如 COSvc105 反而更稳。Q2切换版本需要重新配置吗A建议切换前先按向导重新设置一遍并确认给予com.xiaomi.xmsf足够的权限避免推送不稳定。Q3安装后收不到推送怎么办A优先确认是否为系统应用、是否被省电策略限制再考虑切换版本试试。六、总结一句话版本选择口诀默认 normal异常换 vc105MIUI 用 normalCOS 用 vc105。两种推送模式的差异本质上是bindService与startService两种消息传递方式的取舍——normal 更新更高效vc105 更传统更兼容。理解了这一点你就能根据自己的 ROM 快速做出选择了。【免费下载链接】MiPushFrameworkLet supported push service run system-ly on every Android devices项目地址: https://gitcode.com/gh_mirrors/mipu/MiPushFramework创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
