MiPush Framework使用指南 |
您所在的位置:网站首页 › 手机配置文件不存在什么意思 › MiPush Framework使用指南 |
指南版本
ver=v0.8.1
latest-update=2024.02.23
以下内容全文为MiPush Framework使用指南,请分享给有需要的人
声明
本文档
依据MiPush版本:v0.3.11+即频道最新内测版
【查看】
依据设备:一加9PRO Color14
本文档是原Q群内精华消息,现已重新排版优化,并加入自己的理解,欢迎指正
如搬运本文档的任何内容,请说明文档来源
本文作者:冰之梦殇520
MiPushFramework维护者:NihilityT
交流
QQ频道:点击加入
更多:(加群,教程,文件)
手机版:请点击左上角三条杠查看更多
电脑版:请看顶部导航栏
更新日志
0. 应用、工具与环境
0.1 依赖环境
Android 5+
ROOT
Magisk或KernelSU
Lsposed
免ROOT
LSPatch
0.2 依赖工具
推送服务(通)
官方下载
云盘下载
MiPus(通)
官方下载
云盘下载
配置文件(通)
官方下载
云盘下载
伪装模块(非MIUI)
云盘下载
0.3 应用获取
PS:部分应用使用其他应用商城下载的包可能存在伪装没效果或没用的情况,可以尝试使用以下两种包
小米应用商店网页版下载应用安装包方法: 手机浏览器输入网址: m.app.mi.com/details?id=(此处填应用包名) 例如下载今日头条 链接为: m.app.mi.com/details?id=com.ss.android.article.news 点击:免费下载 开始拼图验证 通过后自动下载华为应用市场网页版下载应用安装包方法: 手机浏览器输入网址: appgallery.huawei.com 选择一个应用,例如酷安,点击进入,这时网址显示为: appgallery.huawei.com/app/C10414599 把网址改成: appgallery.cloud.huawei.com/appdl/C10414599 在 huawei.com 前增加个 cloud. 在 app 后面加入 dl 回车,下载 1. 安装与配置 1.1 服务安装-ROOT 1.1.1 VCD为1003003000 PS1:此版本不推荐Color系统的手机使用 PS2:MIUI推荐使用此版本,无需精简 打开 核心破解 的前四个功能开关![]() 除小米MIUI机型外,其余系统需先进行需进行相应伪装,已成功伪装后打开相应的应用进行注册 打开目标应用即可自动进行注册,未触发注册可能是伪装不到位或注册异常,对于注册异常的应用,参考如下方式进行解决: 对于 root 用户,前往注册异常应用的数据目录:/data/data/应用包名/shared_prefs/ ,删除该目录下的mipush.xml文件并重启应用 对于无 root 用户,需要清空应用数据或卸载重装软件特别注明: 全部都显示异常的,可以直接用MT管理器去data/data目录下搜mipush,然后全删,重新注册即可 如果还是注册异常,检查一下是否启用了全局广告拦截的软件、模块或者hosts文件,关了重启再试;还是不行,检查/data/data/com.xiaomi.xmsf/shared_prefs 路径下是否有push_message_ids.xml文件生成,没有的话手动新建一个,记得改一下权限与别的文件权限相同无法自动注册的,在推送服务里面点击相应应用的图标进行强制注册 2.2.2 注册成功 在0.3.10+开始,【注册成功】这个词汇不再显示了 ,内测版已恢复 已注册 样式,但如果掉注册,并不会实时更新,还是更推荐以下2种方式 强制注册后有显示【已允许某应用注册推送】这种Toast就代表【注册成功】 前往【/data/data/应用包名/shared_prefs/mipush.xml】中查看是否有【regID】这个参数,如果有就是【注册成功】 2.2.3 强制注册具体操作
强制注册成功
强制注册失败
如果出现下图情况
如果强制注册还是无法注册的,排查伪装方法及广告拦截、网络权限等 2.2.4 注册异常注册异常表示应用注册推送失败或者信息异常,遇到这种情况请按照下列顺序排查 如果您曾经卸载过push服务或者清空过push数据 您需要卸载并重新安装之前已经注册过的应用(比如微博,支付宝,淘宝之类的App) 常见情况就是所有应用都显示注册异常 所以请勿卸载重装PUSH部分应用特性导致注册异常 比如酷安开启绿色纯净之后会导致注册异常 部分应用(如百度地图)在设置中关闭推送,会导致注册异常 部分应用(如云音乐)关闭后台运行权限后也会主动反注册,这种需要关闭相关优化 还有情况就是真的只是误报,这种情况请忽略备份恢复过push数据 如果rom重刷之后恢复之前数据可能是无效的 如果有这种情况建议按照清空过push数据来处理有的应用显示异常但是可以收到推送 目前出现在微博的情况比较多,暂时无视注册异常的标记 这种情况暂时认为是误报,请忽略 3. 配置文件 3.1 配置文件使用介绍 PS1:该篇主要讲解怎么使用配置文件,不介绍配置文件怎么写,有兴趣学习的可以自行了解 PS2:部分说明仍然缺少,欢迎投稿 3.1.1 基础配置 PS1:基础配置由原来的一个拆分成了三个 PS2:不需要懂他是什么原理,直接三个全用就行 0_基础配置_工具.json 0_基础配置_开关.json 0_基础配置_消息样式相关.json 3.1.2 前置配置1_前置配置.json 使用任何1_前置配置_xxx都需要其配合其使用1_前置配置_清除预设通知组-黑名单.json 目前的作用是将单个应用的通知聚合成一组,本身聚合的可以不用管 3.1.3 后置配置 PS:后置配置由可以理解为全局配置2_后置配置.json PS:使用任何2_后置配置_xxx都需要其配合其使用2_后置配置_自动提取意图.json PS1:提取意图即从数据里面提取出 intent![]() 2_后置配置_移除通知副标题.json PS:如图![]() 2_后置配置_只显示一条消息-白名单.json PS:添加入该白名单的应用,收到新消息时会覆盖旧消息,且不分联系人及消息类型,只显示最新一条消息。2_后置配置_点击时清理会话通知组-白名单.json PS:如QQ有3-4条MiPush消息,当点开QQ软件时,通知栏将清空QQ的消息2_后置配置_收到消息后台唤醒应用-白名单.json PS:收到消息的APP将拉起处理推送的服务2_后置配置_消息样式为每条消息添加起始标识.json PS:为每个消息的开头添加个-2_后置配置_堆叠同一会话的所有通知-白名单.json PS1:原MiPushFramework的按钮功能,新版改为配置文件实现功能 PS2:大意为:堆叠同一会话就是把人按一列排起来,成组就把列合成一组,不管列的人数是多少。分组就是明确哪些列合成一组,哪些列合成另一组。2_后置配置_将透传消息作为通知显示-白名单.json PS1:原MiPushFramework的按钮功能,新版改为配置文件实现功能 PS2:部分消息为透传消息![]() 2_后置配置_屏蔽运营消息-黑/白名单.json PS1:运营消息一般为广告通知,在MiPush中有专门的通知渠道,该配置将会把所有运营消息渠道的通知全部拦截,即MiPush不通知运营消息渠道的消息 PS2:该配置属于全局拦截,有些APP例如抖音等,运营消息发送的是正常的消息,所以,自行斟酌使用黑/白名单![]() 2_后置配置_直接打开意图-黑/白名单.json PS1:直接打开意图可以理解为使用小窗打开该APP PS2:部分APP,例如闲鱼等,不使用该配置可能导致消息跳转白屏 PS3:与自动提取意图相配合:【直接打开意图是让通知有可能通过小窗打开,自动提取意图是增加这个支持的范围】2_后置配置_将标题相同的通知视为同一会话-黑/白名单.json PS1:按联系人分别显示最新一条消息(每个联系人或群组单独分组,不成堆,且只显示最新一条) PS2:该配置属于全局配置,自行斟酌使用黑/白名单 3.1.4 应用配置 QQ PS:建议直接拉满 1. `com.tencent.mobileqq_QQ.json` 2. `com.tencent.mobileqq_QQ_MessagingStyle.json` 3. `com.tencent.mobileqq_QQ_分离消息样式的个人、群组会话.json` 4. `com.tencent.mobileqq_QQ_含“-”符号的群昵称提取首词作为群昵称.json` 5. `com.tencent.mobileqq_QQ_群头像支持(不装则显示具体群友头像).json` 飞书 1. `com.ss.android.lark_飞书.json` 2. `com.ss.android.lark_飞书_MessagingStyle.json` 招商银行 1. `cmb.pb_招商银行.json` 2. `cmb.pb_招商银行_卡号替换.json` 其他 1. `com.xingin.xhs_小红书.json` 2. `com.zhihu.android_知乎.json` 3. `com.taobao.idlefish_闲鱼.json` 4. `com.jingyao.easybike_哈啰.json` 5. `com.ss.android.ugc.aweme_抖音.json` 6. `com.alibaba.android.rimet_钉钉.json` 3.1.5 群友配置 1. `1_全局单个应用通知成组.json` 2. `com.sina.weibo_微博.json` 3. `com.jingdong.app.mall_京东.json` 4. `com.tencent.wework_企业微信.json` 5. `com.autonavi.minimap_高德地图.json` 6. `com.eg.android.AlipayGphone_支付宝.json` 3.2 配置文件说明 原文: https://github.com/NihilityT/MiPushConfigurations 配置文件可以做到以下事情: 修改通知显示效果 通知到来时唤醒屏幕 通知到来时触发通知被点击效果(仅触发效果,未实际点击通知) 配置文件名 配置名根据以下格式命名,共分为四个部分:${package}_${appname}_${optional_function}-${exclusive_description}.json 不同部分的含义分别为: 必填:${package},应用包名 使用包名来区分配置针对的是什么应用 特殊包名: 0,基础配置,必需下载 1,全局前置配置 2,全局后置配置 必填:${appname},应用名 用于快速识别配置针对的是什么应用 可选:${optional_function},功能名 一个应用的配置可以由多份配置文件组成,使用不同的 ${optional_function} 来标识不同的能力 可选:${exclusive_description},互斥能力描述 配置中存在相同 ${optional_function} 时,说明这一组配置文件为互斥配置,只有一个配置生效,此时应只保留其中一个配置文件 互斥示例(${optional_function} = 群消息整形): com.tencent.mobileqq_QQ_群消息整形-群名标题前添加发送者.json com.tencent.mobileqq_QQ_群消息整形-群名移动至 subtext.json配置使用方式 设置配置目录,入口位于:推送服务 - 设置 下载所需配置放入该目录中 (可选)若需自定义通知图标,可以在配置目录下创建icon文件夹,将AndroidNotifyIconAdapt仓库的json文件放入其中 可从GitHub下载或云盘下载中获取配置类型 配置共分为两类: 主配置:具有实际包名的配置项(${package}_${appname}.json) { "version": "0.1.0", "configs": { "com.coolapk.market": [ "大图标显示成圆形" ] } } 子配置:提供引用项被主配置引用(${package}_${appname}_${optional_function}-${exclusive_description}.json) { "version": "0.1.0", "configs": { "大图标显示成圆形": [ { "newMetaInfo": { "extra": { "__mi_push_round_large_icon": "" } }, "stop": false } ] } } 配置执行流程 弹出通知时,通过会经过配置进行整行或忽略,执行流程如下: 执行 ^ 配置(1_${appname}.json) 执行应用配置,如 com.coolapk.market(com.coolapk.market_酷安.json) 执行 $ 配置(2_${appname}.json)在配置执行过程中,若遇到一个匹配成功的配置,其配置中未定义 "stop": false,则整个流程结束 4. 通知 4.1 通知图标 4.1.1 自定义通知图标 对MIUI_CN和Flyme无作用 安装推送服务最新版 在配置目录下面创一个icon文件夹,把图标.json放进去; 图标下载:GitHub下载或云盘下载 强行停止推送服务 4.1.2 MIUI通知图标 由于部分用户总是不自己研究,故,不在提供方法,请自行探索隐藏内容,输入密码后查看 4.2 通知展示 4.2.1 通知为什么没有头像 没有相应参数的时候就是用首字作为头像 4.2.2 为什么我没有推送服务几个字![]() ![]() 怎么开启悬浮通知(QQ群聊消息为例)
操作方法
![]() 缘由: 经过某些不知名的神奇操作后,可能会丢失不重要通知栏起因: MIUI会折叠一些推送消息,归类为不重要通知 但是根据缘由来看,消息就 ≈ 无了 所以要全部设置通知为重要![]() 操作: 通知过滤规则设成重要 否则有推送消息记录,通知栏因缘由被吞 把不重要消息的收纳栏显示出来了 如果默认还不出现在通知栏。去MIUI原生通知图标那可以开启收纳栏![]() ![]() ![]() ![]() 关于终端 Termux终端:官网 MT管理器:官网冰箱解冻失败失败: 检查推送服务的高级配置是否打开了冰箱解冻支持的开关; 检查是否把冰箱加入了墓碑冻结名单; 前两项无问题,重新打开冰箱解冻支持的开关; 还是无法赋权,可尝试手动赋权,命令: pm grant com.xiaomi.xmsf com.catchingnow.icebox.SDK无法拉起QQ电话: 给推送服务显示在其他应用上层的权限; 加载配置文件。安卓13卡使用情况权限界面。 打开终端,输入su回车 授予使用情况访问权限 appops set com.xiaomi.xmsf android:get_usage_stats allow 授予显示在其他应用上层权限 appops set com.xiaomi.xmsf SYSTEM_ALERT_WINDOW allow推送服务双开 :PS:指令仅在MIUI上通过测试 打开终端,输入su回车 授予使用情况访问权限 appops set --user 999 com.xiaomi.xmsf android:get_usage_stats allow 授予显示在其他应用上层权限 appops set --user 999 com.xiaomi.xmsf SYSTEM_ALERT_WINDOW allow 6. 名词解释 6.1 什么是分应用? 模块的名字为:MiPush 可以以应用身份发出通知,而不是以推送服务的身份 好处:以目标应用身份来通知,像应用本身发出的 该应用为XP模块,需勾选系统框架并重启才能进行分应用通知 此外,MiPush也有【伪装】的作用 6.2 什么是透传消息? 直接发送给APP的消息,不会在通知栏显示 补充:小米推送已于2022年9月12日0点起,针对非 MIUI 官方应用,停止提供透传消息下发的服务详情 6.3 关于精简 MiPush Framework最初是为了非MIUI也能享受到MIUI的推送服务,为了实现功能,和官方小米服务框架包名相同 MIUI是自带小米推送的,如果为了通知自定义使用这个第三方的MiPush,需要先使用模块精简原有的小米服务框架 使用Delta版面具,请不要开强制使用超级用户列表,会导致精简模块失效 6.4 关于新版本 从0.3.10开始,推送服务进行分包,【versionCode=1003003000】【 versionCode=105】两种 推荐将【推送服务】安装为系统应用,拥有系统应用身份能让所有应用检测到推送服务(所有系统上) 在MIUI上,优先推荐【核心破解安装】,安装完成后是【系统应用】,不需要使用精简,当然,你也可以使用精简方案 在Color上,优先推荐使用【versionCode=105】 如果使用versionCode=1003003000后,若注册总是注册没反应,请使用versionCode=105的版本 在0.3.10+开始,【注册成功】这个词汇不再显示 【如何查看自己注册成功】 6.5 关于版本号 因为:版本号会跟随语义化版本号定义:https://semver.org/ 所以:你会看到推送服务的版本号【versionCode=1003003000】跟【versionCode=105】的版本号不太一样 7. FAQ 7.0 推送服务不推送部分解决方法 7.1 常用应用问题解决 7.1.1 QQ 7.1.1.1 QQ注册 云盘下载 安装MiPush、推送通知 前往LSPosed中,勾选推荐作用域、QQ 重启手机 打开推送通知,查看QQ是使用系统推送,但尚未注册,还是注册失败 使用系统推送,但尚未注册 前往LSPosed中,取消勾选QQ,接着重启QQ,再勾选QQ重启QQ,这时再看QQ是什么注册情况,如果依旧尚未注册,可以尝试重启手机,再重复一次此操作 若一直为尚未注册,可以试试强制注册 则尝试使用MiPushDeviceFake或MiPushfaker,倘若变成注册失败,请看下面 注册失败![]() ![]() 能收到正常推送消息,但收不到QQ推送电话的消息 QQ版本问题,建议换8.9.18版本,测试推送后再覆盖安装回别的版本也能保持QQ电话推送)能收到QQ电话推送,但是拉不起QQ; 需排查是否加载了配置,如果成功加载了配置文件 再排除是否给推送服务显示在其他应用上层的权限,如果无法给权限,终端命令赋权: su appops set com.xiaomi.xmsf SYSTEM_ALERT_WINDOW allow 还有处于miui的QQ分身界面,有电话推送时也不会拉到QQ主应用 位于QQ分身界面,也不会拉起主应用QQ收到QQ电话推送且能拉起QQ,但是不能接通 排查是否杀了QQ的msf进程,这个影响接通速度 排查QQ的冷启动速度,QQ刚安装,没编译完成,冷启动太慢也会影响接通,解决办法就是手动给QQ编译,无法手动编译就杀死打开QQ多重复几轮,QQ就被系统编译了 排查是否登着电脑QQ(电脑版tim不影响),这个会导致QQ无法接通亮屏时能拉起QQ电话和接通电话,但是息屏状态时,能点亮屏幕且拉起QQ,但是无法弹出QQ电话那个界面 justpush模块的影响,关掉重启就可以了。 7.1.4 QQ下载 QQ下载的文件一般位于/storage/emulated/0/Android/data/ com.tencent.mobileqq/Tencent/QQfile_recv/ 非root的情况可以通过保存副本复制一份到下载目录 root也可以用QAuxiliary或者其他重定向至下载目录。 7.1.2 酷安 7.1.2.1 酷安注册-不推送云盘下载 MIUI 卸载酷安,安装官方酷安12.4.2版 先不要启动酷安 对酷安隐藏root后再启动酷安进行注册推送和登录帐号非MIUI(方法1) 卸载酷安,安装官方酷安12.4.2版 先不要启动酷安 安装MiPushDeviceFake和mipush模块,两个模块都勾上酷安来进行伪装,然后再打开酷安进行注册登录非MIUI(方法2) 卸载当前酷安,安装13.0.1内置MiPushDeviceFake版的酷安 先不要启动酷安 安装MiPush模块,模块勾选酷安。 然后再打开推送服务来强制注册 Tip1:酷安注册很容易,难就难在注册成功不推送,所以,使用内置版的13.0.1酷安注册成功后,【强制停止】酷安,测试推送,如果刚注册完,【强制停止】推送没用,重启手机并打开酷安,再次测试 Tip2:如果不行,也对酷安隐藏root后再启动酷安进行注册推送 Tip3:(需要ROOT)如果你推送没有问题了,且不喜欢修改的酷安,可以通过核心破解并打开图中功能,进行酷安版本切换![]() ![]() |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |