一个 APK,两副面孔:
- 普通 App:列表浏览 + 新增记录 + 按条件删除(时间 / 号码 / 来电去电 / 来信去信 / 正文关键字)。
- LSPosed 模块:注入
com.android.providers.telephony与com.android.providers.contacts两个 provider 进程,在里面替 App 执行真正落库的动作。
目标机型:红米 K70 Ultra(HyperOS,Android 14/15,已 root + LSPosed)。
Android 10+ 起,WRITE_SMS / WRITE_CALL_LOG 属于受限权限:
- 普通签名的应用即使声明了也拿不到,用户也没法手动授予;
- 系统在 AMS 解析 provider 阶段就已经拒绝(典型日志:
Permission Denial: writing com.android.providers.telephony.SmsProvider uri ... requires android.permission.WRITE_SMS); - 所以「直连 ContentResolver」这条路在大多数机子上必然失败。
三条可行路线对比:
| 方案 | 是否需要 root | 数据一致性 | 代价 |
|---|---|---|---|
| A. 成为默认短信 / 默认拨号应用 | 否 | 好 | 会接管全部短信/通话,侵入性极强 |
B. root + su -c content ... 命令 |
是 | 一般(shell 引号/文本解析,易出脏数据) | 值要转义,content query 输出靠文本解析 |
| C. LSPosed 模块在 provider 进程内执行(本项目主通道) | 是 | 好(走 provider 正常 insert/delete,threads 表、变更通知由系统维护) |
需要装模块 + 勾 scope |
结论:LSPosed 不是唯一解,但在这个需求下它是最干净的解——写入发生在 provider 进程内, 属于「自己访问自己」,权限检查直接放行;而且不需要改系统分区、不需要抢默认应用角色。
本项目把三条路都留了口子:直连 → 模块 → root 依次尝试,谁通用谁,UI 上会显示当前用的是哪条通道。
# 本地编译(需要 JDK 17 + Android SDK 34,local.properties 里配 sdk.dir)
./gradlew assembleDebug # 产物:app/build/outputs/apk/debug/app-debug.apk在线出包:推送
v*形式的 tag(如v1.1.3)会自动触发 GitHub Actions 构建 release APK 并发布到 Releases;也可在 Actions 页面手动 Run workflow 下载 APK。release 包默认用 debug 签名,可直接安装。
-
安装 APK(debug 包用默认 debug 签名,后续升级要一直用同一签名)。
-
打开 LSPosed → 模块 → 启用「通话短信工具箱」。
-
点「作用域」,只勾这两个:
com.android.providers.telephony(短信)com.android.providers.contacts(通话记录)
-
勾完必须让这两个进程重启一次才生效:
su -c "kill $(su -c 'pidof com.android.providers.telephony')" su -c "kill $(su -c 'pidof com.android.providers.contacts')"
或者干脆重启手机(更省事)。
-
打开 App → 点右上角「自检」,看到
✅ LSPosed 模块(provider 进程内执行) ✅ 通话记录 → com.android.providers.contacts pid=... uid=... ✅ 短信记录 → com.android.providers.telephony pid=... uid=...就说明通道就绪。列表顶部状态栏会显示「通道 LSPosed 模块」。
右上角「配置」= SetupActivity,把"为什么不通 / 现在该点哪"直接摆在面前:
- 结论卡:一句话说清当前状态(模块就绪 / 只有 root 兜底 / 一个通道都没有)+ 下一步该干什么
- 四条明细:① 已安装 APK 的模块元数据(会真的去解压你装的那个 APK 读
META-INF/xposed/*, 校验入口清单格式)②短信 provider ③通话 provider ④root - 按钮:重新检测 / 授权 root / 打开 LSPosed / 重启短信·通话服务 / 手动强制停止 / 复制诊断
- 三个通道全不可用时,主界面顶部会出现黄色提示条,首次还会自动跳进配置页
1.1.0 起
module.prop的minApiVersion从 102 降到 101(去掉了仅 102 才有的HookBuilder.setId),这样只支持 API 101 的旧 LSPosed 也能加载本模块。
这条报错不代表没 root,而是"找到了 su 但当前应用的 SELinux 域不允许 exec"。所以改成逐条路径探测并把结果全部展示:
su(PATH) / /system/bin/su / /system/xbin/su / /sbin/su
/debug_ramdisk/su(Magisk) / /data/adb/magisk/su
/data/adb/ksu/bin/su(KernelSU) / /data/adb/ap/bin/su(APatch)
最后再兜一层:sh -c "su -c id"
配置页的「诊断详情」会把每条路径的真实输出列出来,卡在哪一条一目了然。 点「授权 root」会用 15s 超时重新探测(留出点授权框的时间)。
- 列表:号码 / 类型(来电、去电、未接、拒接、已拦截、语音信箱)/ 时间 / 时长
- 新增:指定号码、指定时间、类型、时长
- 删除:
- 长按单条 → 精确删除(按
_id) - 「按条件删除」→ 号码(模糊)+ 时间区间 + 类型
- 「清空」→ 全清(二次确认)
- 长按单条 → 精确删除(按
- 删除前会先统计匹配条数并弹出确认。
- 列表:号码 / 类型(收件、发件、草稿、发件箱、失败、待发)/ 时间 / 正文摘要
- 新增:指定号码、指定时间、收信/发信、正文
- 删除:同上,另加「正文关键字」条件
- 「自检」:逐条通道探测 + 打印 provider pid/uid
- 「日志」:进程内环形日志(300 条),现场没电脑时可直接看错误原因
- 所有写操作失败都会自动降级并保留失败原因(状态栏 / 日志里能看到是谁失败了)
app/src/main/java/cn/ftqp/callsms/
├── core/ # 与「怎么落库」无关的通用层
│ ├── Target.java # 两类目标:uri、号码列/时间列/类型列、类型枚举
│ ├── Filter.java # 条件 → selection / 字面量 SQL(root 通道用)
│ ├── Router.java # 引擎路由:直连 → 模块 → root,粘住上次成功的
│ ├── Engine.java # 通道接口
│ ├── DirectEngine.java # 直连 ContentResolver(大多数机型会被拒)
│ ├── ModuleEngine.java # 有序广播 → provider 进程
│ ├── RootEngine.java # su + /system/bin/content
│ ├── Bridge.java # App ↔ provider 进程的协议常量
│ ├── Json.java / Times.java / Logs.java / OpResult.java / Shell.java
├── xposed/
│ ├── ModuleEntry.java # API 102 入口(Hook ContentProvider.attachInfo)
│ └── ProviderBridge.java # 跑在 provider 进程里的执行器
└── ui/ # 纯代码建 View,不依赖 material
├── MainActivity.java
├── RecordsPanel.java
└── Ui.java
app/src/main/resources/META-INF/xposed/
├── java_init.list # 入口类
├── module.prop # minApi=102 targetApi=102 staticScope exceptionMode=protective
└── scope.list # 两个 provider 包
关键实现点:
- Hook 点:
android.content.ContentProvider#attachInfo(Context, ProviderInfo)。 框架类、签名稳定,provider 启动必然经过;在它返回后把arg0(provider 的 Context)交给ProviderBridge,注册一个动态广播接收器。attachInfo是实例方法,getThisObject()就是 provider 本体。 - 为什么用广播而不是 AIDL/Binder:模块是注入进别人进程的,没有可 declare 的 Service 组件;
动态广播是唯一零侵入的「反向调用」方式。用有序广播拿回执(
setResultData),失败/无接收者能立刻区分。 - 限额:单次最多回传 200 行、单字段 800 字(Binder 单次事务 1MB)。
- 安全:
uri白名单(只允许content://sms、content://call_log/calls),API 34+ 校验getSentFromPackage()是否为io.github.fangtianq.callsms;另在 Manifest 里声明了 signature 级io.github.fangtianq.callsms.permission.BRIDGE备用。 - 不做的事:不 hook
system_server、不 hook SystemUI、不改资源、不碰framework。 scope 出问题最多影响短信/通话两个 provider 进程,LSPosed 里关掉模块即可恢复。
| 现象 | 原因 | 处理 |
|---|---|---|
| 自检里模块 ❌ | scope 没勾 / 勾了没重启进程 / 模块没启用 | 勾 scope → 重启手机 |
| 只有通话 ✅、短信 ❌ | 只勾了一个包 | 两个都要勾 |
| 显示「通道 root」 | 模块没生效,走了 su 兜底 | 看自检;root 通道对正文含换行的短信解析不全 |
写入报 no such column: new/is_read/presentation |
该 ROM 的 calls 表少了可选列 |
已做自动降级(去掉可选列重试一次) |
写入报 Permission Denial |
走的是直连通道 | 说明模块没生效,属预期;修好模块即消失 |
| LSPosed 里看不到模块 / 提示 API 版本不符 | LSPosed 太老 | 1.1.0 已把 minApiVersion 降到 101;仍不行就升级 LSPosed |
| 配置页说「模块元数据有问题」 | 你装的是旧包(入口清单里带 # 注释,LSPosed 会把它当类名 → 静默不加载) |
重装最新 APK 后重启手机 |
Cannot run program "su": error=13 |
找到 su 但应用域不允许 exec(不是没 root) | 看配置页「诊断详情」的逐路径结果;在 Magisk/KernelSU 里给本应用授权 |
| 短信写进去 MIUI 短信不刷新 | 会话列表缓存 | 强停短信 App 再打开 |
| 长按记录提示「缺少 _id」 | 1.1.1 已修:root 通道解析 content query 输出时,把 Row: 0 _id=1 的行号吃进了第一个列名,键变成 "0 _id" |
升级到 1.1.1+;即便仍拿不到 _id,现在会自动退回「号码+时间+类型」组合删除 |
libxposed/api不打进 APK,用compileOnly。仓库里以app/libs/libxposed-api-102.jar形式内置(取自官方io.github.libxposed:api:102.0.0的classes.jar), 好处是离线也能编译;想走仓库依赖就把app/build.gradle.kts里那行换成compileOnly("io.github.libxposed:api:102.0.0")。- UI 只用
androidx.appcompat,不引入 material / recyclerview,减少依赖面。
图标由 tools/IconGen.java 从 tools/icon-src.jpg 现场生成(不依赖 PIL/ImageMagick,只用 JDK):
E:/000/jdk17/bin/java tools/IconGen.java tools/icon-src.jpg app/src/main/res- 先按人像视觉中心(高度 48% 处)裁正方形,再双三次插值缩放到 48/72/96/144/192
- 自适应图标前景层:108dp 画布、内容只占中间 72dp(66.7%)+ 四角小圆角,
这样圆形/方圆/水滴遮罩都不会切到脸;背景色取自照片平均色
#7C8187
换图只需替换 tools/icon-src.jpg 后重跑上面那条命令。
- 批量导入(CSV:号码,时间,类型,时长/正文)
- 按「重复号码 + 时间窗」去重后再写
- 写前预览 diff(将写入哪些行)
- 定时任务:每天固定时间清理超过 N 天的记录
- 把条件保存成「规则」,一键复用