在非 MIUI 系统上使用接近 MIUI 的小米系统级推送。
MiPushFramework 以 com.xiaomi.xmsf 的形式提供系统推送服务:接入小米推送的应用把推送委托给统一的框架进程,而不是各自常驻后台运行 XMPushService。项目同时保留通知改写、事件观测、配置规则、焦点通知、HyperIsland 超级岛和 Android 实况通知等兼容能力,当前开发分支最低支持 Android 9.0(API 28)。
这不是小米官方项目,也不保证所有 ROM 或所有应用都能获得相同行为;涉及厂商 ROM、目标应用策略、系统权限和 Xposed/LSPosed 环境时,实际效果以设备验证为准。
本 fork 仍以非 MIUI 设备上的系统级小米推送为核心目标,但已把早期单体推送代理改造成分层的 XMSF 兼容运行时:
- XMSF 外部契约由产品代码托管:
:xmsf应用模块将xmsf/shell/打包为com.xiaomi.xmsf,由 shell 保留外部应用会访问的包名、组件名、Provider、Service、Intent 与桥接入口;面向 stock 的行为通过 shell 自有适配层承接,而不是把新业务直接堆进 Xiaomi runtime。 - 长连接、协议与业务分层:
vendor/保留仍在工作的 Xiaomi 长连接、网络与运行时栈,pinned/固定 thrift/protobuf 等协议序列化表面,core/放平台无关的运行时契约与统计模型;新增业务优先走xmsf适配器或corefacade。 - 运行时管线重建:推送入口从
MiPushFacadeService进入PushRuntime与PushRuntimeExecutionBridge,再衔接 shell 的XMPushServiceABI facade、私有 vendorXMPushServiceCore、下游PushMessageProcessor与通知发布层;覆盖注册重放、待处理队列、连接状态、下游投递、通知计数与兼容降级等状态管理。 - xmsf 运行时独立交付:运行时 APK 独立打包交付(
:xmsf:*模块族),设置项展示运行时状态与版本探测。 - 管理端现代化:
manager/模块族(contract / port / application / client / ui / xmsfDelivery)承担 Compose 管理界面与设置入口,运行时依赖 Koin、Room、DataStore;应用注册、事件、通知记录、配置加载与运行时操作都有明确的 UI/adapter 边界。 - 通知发布对齐 stock XMSF:
MIPushNotificationPublishHelper、NotificationController、NotificationManagerEx对齐分组、点击、按钮、VoIP、SweetTag、focus 删除与渠道兼容行为,普通通知、配置显式焦点通知与生成式超级岛代理区分不同路径。 - Hook 与超级岛独立运行面:
xposed/维护 libxposed/LSPosed 入口、SystemUIMiPushIslandHook、XMSFUnlockFocusAuthHook与 provider 同步的IslandPreferences;HyperIsland 代理通知不与原始通知栏通知混入同一分支,并避让独立 HyperIsland 模块。 - 面向新平台的通知语义:进度类推送通过
ProgressStyleBuilder在 Android 16+ 使用Notification.ProgressStyle与 promoted ongoing,低版本保留常规进度通知;非 MIUI/AOSP 路径避免泄漏miui.focus.param、miui.focus.pics等 MIUI 私有 extras。 - 诊断与可观测落在代码里:
LogBundleExporter负责 JSONL 日志选择与旧文本日志清理;归档、敏感字段脱敏与采集范围由magisk-xposed-kit的日志策略按构建类型判定,发行构建不导出、只在设备上脱敏落盘且设置页不显示日志导出、保留天数与清理入口,debug 构建才导出并采集 LSPosed 日志、全量 logcat 与 root 诊断;设置项只能提高脱敏、不能取消它;root/shell 行为通过AppRootAccessFacade、BoundedShellRunner等受控入口执行。导出需要 root 权限:归档包含/data/adb/lspd/log等模块日志目录,非 root 设备在选择保存位置前即会被拦截;正式版不采集这类 root 诊断,需要完整导出请安装 debug 构建(CI 产出的 debug 包即可)。
Release 页面通常提供 normal 和 vc105 两类构建,核心区别是目标应用向 XMSF 传递消息的方式。
| 版本 | versionCode | 传递方式 | 建议 |
|---|---|---|---|
normal |
1003003000 |
bindService |
默认首选,稳定性更好 |
vc105 |
105 |
startService |
兼容旧路径或部分 bind 异常 ROM |
小米推送 SDK 会根据 XMSF 的 versionCode 选择传递方式:versionCode >= 106 使用 bindService,versionCode == 105 使用 startService。
优先尝试 normal;如果某些 ROM 或应用无法通过 bind 路径传递消息,再切换到 vc105。在 MIUI 上使用 normal 还有一个额外好处:重启后更不容易被系统还原成官方 XMSF。
- @Rachel030219 提供文件。
- @KiritoXDone 提供新版分层自适应启动图标(layered adaptive launcher icon)。
- Android Open Source Project, AndroidX, Jetpack Compose, Material 3, Kotlin, kotlinx.coroutines, kotlinx.serialization, Koin, Room, DataStore, Navigation, Lifecycle, AppCompat, libxposed API, LSPosed HiddenApiBypass, libsu, Napier, Miuix, JetBrains Markdown, JUnit, MockK, Robolectric, Detekt, Kover, KSP。
- HyperIsland 提供超级岛实现参考。
- HyperIsland-ToolKit 提供 HyperIsland SDK 支持。
- 酷安 @PzHown @lmnm011223 @苏沐晨风丶(未采纳)提供图标。
如果本项目对你有帮助,欢迎支持开发者。你的支持会直接用于项目维护与持续迭代。
赞助名单与说明请见:赞助与捐赠文档。
| 支付宝收款码 | 微信赞赏码 | 微信收款码 |
|---|---|---|
![]() |
![]() |
![]() |


