{"id":13440179,"url":"https://github.com/MiPushFramework/MiPushFramework","last_synced_at":"2025-03-20T09:32:22.761Z","repository":{"id":24338634,"uuid":"101242194","full_name":"MiPushFramework/MiPushFramework","owner":"MiPushFramework","description":"[Archived, FORK: https://github.com/NihilityT/MiPushFramework] Let supported push service run system-ly on every Android devices","archived":false,"fork":false,"pushed_at":"2022-08-12T14:51:19.000Z","size":5118,"stargazers_count":2192,"open_issues_count":91,"forks_count":171,"subscribers_count":60,"default_branch":"master","last_synced_at":"2025-03-17T14:58:54.981Z","etag":null,"topics":["android","mipush","miui","push","xiaomi","xposed"],"latest_commit_sha":null,"homepage":"https://github.com/NihilityT/MiPushFramework","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MiPushFramework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-24T01:51:43.000Z","updated_at":"2025-03-17T10:12:21.000Z","dependencies_parsed_at":"2022-07-15T13:47:15.324Z","dependency_job_id":null,"html_url":"https://github.com/MiPushFramework/MiPushFramework","commit_stats":null,"previous_names":[],"tags_count":70,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiPushFramework%2FMiPushFramework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiPushFramework%2FMiPushFramework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiPushFramework%2FMiPushFramework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiPushFramework%2FMiPushFramework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MiPushFramework","download_url":"https://codeload.github.com/MiPushFramework/MiPushFramework/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244585904,"owners_count":20476835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","mipush","miui","push","xiaomi","xposed"],"created_at":"2024-07-31T03:01:20.458Z","updated_at":"2025-03-20T09:32:22.756Z","avatar_url":"https://github.com/MiPushFramework.png","language":"Java","readme":"# MiPushFramework\n\n[![Build Status](https://travis-ci.org/MiPushFramework/MiPushFramework.svg?branch=master)](https://travis-ci.org/MiPushFramework/MiPushFramework)\n[![License GPL-3.0](https://img.shields.io/badge/license-GPLv3.0-blue.svg)](https://github.com/MiPushFramework/MiPushFramework/blob/master/LICENSE)\n![Min Android Version](https://img.shields.io/badge/android-lollipop-%23860597.svg)\n\n在非 MIUI 系统上体验小米系统级推送。\n\n![](https://raw.githubusercontent.com/MiPushFramework/MiPushFramework/master/art/tab_events.jpg)\n![](https://raw.githubusercontent.com/MiPushFramework/MiPushFramework/master/art/tab_permissions.jpg)\n![](https://raw.githubusercontent.com/MiPushFramework/MiPushFramework/master/art/ask.jpg)\n![](https://raw.githubusercontent.com/MiPushFramework/MiPushFramework/master/art/tab_settings.jpg)\n![](https://raw.githubusercontent.com/MiPushFramework/MiPushFramework/master/art/tab_apps.jpg)\n\n## 什么是小米系统级推送，为什么会有这个项目\n\n小米推送是小米公司提供的推送服务，许多 App 都在使用（如酷安）。\n\n它非常轻量，会在 MIUI 设备上自动启用系统推送，而非 MIUI 设备则在后台保持长连接。\n\n\n\n### 系统级推送\n\n类似 GCM，小米推送的系统级推送是在 MIUI 完成的。应用在启动时，会判断如果是 MIUI ROM 则向系统注册推送，推送工作都由系统完成，应用无需后台，更省电。\n\n然而在非 MIUI，每个使用小米推送的应用都会在后台启动一个 `XMPushService`， 10个应用就有10个，20个就有20个服务.. 非常耗电耗内存费流量。\n\n\n\n### 本项目的意义\n\n本项目就是想让任何不用MIUI的用户都能用上小米的系统推送，这样既能保证推送，又保证了无需后台。\n\n\n## 注意\n\n* 请勿使用 黑域、绿色守护、Xposed一些模块 对 `Push` 做操作，可能导致推送不稳定\n* 只有推送功能。其他完整功能（如查找手机）请使用 MIUI\n* 服务本身不需要 Root、Xposed 支持，但是为了伪装为MIUI设备，建议使用伪装增强模块\n\n\n\n## 优点\n\n* 简单，安装非常简单\n* 使用后，其他应用的 `XMPushService` 会自动禁用，就像在 MIUI，同时还能保证推送\n* 完整事件记录，可以监控每个应用的 注册和推送\n* 拦截小米推送产生的不必要唤醒，也能阻止它读取您的隐私\n\n\n\n\n## 开始使用\n\n安装步骤非常简单 ：\n\n* 前往 [Releases 标签](https://github.com/MiPushFramework/MiPushFramework/releases)，下载最新的 Release APK ，并安装。\n* 跟着向导进行设置。\n\n\n## 反馈问题\n\n遇到任何问题，请先看看 Issues 里面有没有人提过。（常见问题：无法收到推送）\n如果没有找到答案，请为每个问题提交一份 Issue，并务必带上如下内容，以便开发者解决：\n\n* 你的 ROM 是什么，Android 版本是什么\n* 有没有使用框架等工具\n\n同时，请使用 设置-获取日志 获取你的日志文件，写进 Issue。\n\n## 日志\n\n框架会自动记录日志，保存到私有目录。您可以前往 设置-高级配置 中清理。\n\n\n\n## 参与项目\n\n请参考 [Contribution Guideline](CONTRIBUTION.md)\n\n## 已知问题\n\n* 对于部分小众的ROM （如 360OS）导致无法正常工作的情况，我们只会竭尽全力保证推送的运行，其它不妨碍推送的「特殊适配」会被忽略。对于这些情况，建议您更换更好的 ROM 以获得最佳体验。\n* 努比亚ROM应用（第三方使用 MiPush 的应用）可能不会自动禁用其 XMPushService 并启动服务，请尝试将框架设为系统应用\n* 锤子 ROM 下，Push 可以正确收到通知，但是通知栏没有提示 #143\n* 开发者学生党，开学了更新可能不太及时，请谅解\n* 一些通知 Feature 可能无法使用（如通知都会显示为推送框架发出，而不是目标应用）\n\n## 感谢\n\n* @Rachel030219 提供文件\n* Android Open Source Project, MultiType, greenDao, SetupWizardLibCompat, Condom, MaterialPreference，GreenDaoUpgradeHelper, epic, Log4a，helplib，RxJava RxAndroid，RxActivityResult，RxPermissions, hiBeaver\n* 酷安 @PzHown @lmnm011223 @苏沐晨风丶（未采纳） 提供图标\n\n\n# License\n\nGPL v3，有些狗不遵守开源协议（非本项目），请**务必**遵守开源协议\n","funding_links":[],"categories":["HarmonyOS","Java"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiPushFramework%2FMiPushFramework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMiPushFramework%2FMiPushFramework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiPushFramework%2FMiPushFramework/lists"}