剖析 Connect You 短信模块源码：BroadcastReceiver 与 HeadlessSmsSendService 如何实现离线收发短信

剖析 Connect You 短信模块源码BroadcastReceiver 与 HeadlessSmsSendService 如何实现离线收发短信【免费下载链接】ConnectYouPrivacy focused contacts and SMS messenger app built with MD3项目地址: https://gitcode.com/gh_mirrors/co/ConnectYouConnect You 是一款注重隐私的开源联系人 短信应用采用 Material Design 3 风格构建。它的短信模块完全运行在设备本地不依赖任何第三方服务器收信靠 Android 系统广播BroadcastReceiver发信靠系统SmsManager加回执接收器配合一个名为HeadlessSmsSendService的无头服务实现了真正的离线收发短信。本文带你逐层拆解这套机制新手也能看懂。短信模块全景4 个 Receiver 1 个 Service整个短信收发链路由以下几类组件协作完成核心代码集中在app/src/main/java/com/bnyro/contacts/util/目录下组件位置职责SmsReceiverapp/src/main/java/com/bnyro/contacts/util/receivers/SmsReceiver.kt接收系统SMS_DELIVER广播入库并弹通知ReplyReceiverapp/src/main/java/com/bnyro/contacts/util/receivers/ReplyReceiver.kt处理通知栏快速回复SmsSentReceiverapp/src/main/java/com/bnyro/contacts/util/receivers/SmsSentReceiver.kt接收发送回执更新状态SmsDeliveredReceiverapp/src/main/java/com/bnyro/contacts/util/receivers/SmsDeliveredReceiver.kt接收对方送达回执更新状态HeadlessSmsSendServiceapp/src/main/java/com/bnyro/contacts/util/services/HeadlessSmsSendService.kt声明为短信类应用支持系统快速回复一条短信从进入手机到发出并回执完整闭环如下收到短信: 基带 → SMS_DELIVER 广播 → SmsReceiver → 系统短信库 → 通知栏(可回复/删除) 发出短信: 用户点击发送 → SmsUtil.sendSms() → 先入库 → SmsManager.sendTextMessage() → SmsSentReceiver(发送回执) → SmsDeliveredReceiver(送达回执) → 状态更新收短信BroadcastReceiver 如何拦截 SMS_DELIVER 广播Android 收到短信后会向系统广播一条android.provider.Telephony.SMS_DELIVER广播。Connect You 的 SmsReceiver 就是专门监听这个广播的守门员它的处理流程分三步过滤广播onReceive第一行就检查intent.action ! SMS_DELIVER只处理短信到达事件其余广播直接忽略解析并入库用Telephony.Sms.Intents.getMessagesFromIntent()拆出短信内容长短信会拆成多条需要逐条处理取出号码、正文、时间戳通过仓库层smsRepo.getOrCreateThreadId()找到对话线程 ID再调用persistSms()写入系统短信数据库弹出可交互通知入库后立刻构建一条 Material 风格的MessagingStyle通知包含三个动作按钮——回复带RemoteInput输入框、删除以及一个隐藏彩蛋如果短信正文中检测到 6 位数字验证码正则(?!\d)\d{6}(?!\d)见 SmsReceiver.kt#L176会额外加一个一键复制验证码按钮。值得一提的是通知里的每个按钮都不是普通跳转而是通过PendingIntent指向另一个BroadcastReceiver点回复触发 ReplyReceiver它取出用户输入的文本后在 IO 协程中调用SmsUtil.sendSms()直接发出回复——整个过程不需要打开应用界面这就是通知栏回短信的实现原理。发短信先入库再发送用两个回执 Receiver 跟踪状态发送逻辑的核心是 SmsUtil 这个工具对象关键方法有sendSms()第 46-74 行发送前先检查信号ConnectionHelper.hasSignalForSms()然后把消息以SmsStatus.NONE状态持久化进短信库拿到自增 ID 后再真正发送sendSmsInternal()第 92-115 行构造两个PendingIntent回执——已发送指向SmsSentReceiver已送达指向SmsDeliveredReceiver连同短信 ID 一起传给SmsManager.sendTextMessage()双卡支持getSmsManager()通过SmsManager.getSmsManagerForSubscriptionId()指定用哪张 SIM 卡发送。两个回执接收器各司其职SmsSentReceiverresultCode RESULT_OK则把状态改为SENT否则标记ERROR界面上会显示重发按钮SmsDeliveredReceiver收到对方网络的回执后把状态更新为DELIVERED即消息气泡变成双勾。此外SmsUtil.kt#L117-L150 还实现了短信长度规则纯 ASCII 每段 160 字符含 Unicode如中文表情每段 70 字符超长文本自动拆分成多条发送。HeadlessSmsSendService源码只有 7 行为什么重要打开 HeadlessSmsSendService你会发现它几乎是个空类——onBind直接返回 null。这正是 Google 官方推荐的无头短信发送服务写法系统检测到应用声明了这个服务后就把它认定为一个短信类应用从而获得进入系统短信应用选择器的资格可被设为主短信应用支持通话中的快速回复Quick Reply场景——系统通过RESPOND_VIA_MESSAGE动作唤起该服务代为发送短信。它的注册在 AndroidManifest.xml#L282-L296声明android.permission.SEND_RESPOND_VIA_MESSAGE权限保护并监听sms、smsto、mms等 scheme 的 intent-filter。真正干活的发送逻辑仍由SmsManager完成服务本身只是一个身份声明。AndroidManifest 中的权限与组件注册清单离线收发的能力一半写在了 AndroidManifest.xml 里主要有三处三大短信权限第 20-23 行READ_SMS读历史短信、RECEIVE_SMS接收短信广播、SEND_SMS发送短信高优先级短信接收器第 239-247 行SmsReceiver使用android.permission.BROADCAST_SMS系统保护权限且 intent-filter 设置priority999保证比系统短信应用更早收到广播隐私关键一行第 43-45 行tools:noderemove移除了依赖库引入的ACCESS_NETWORK_STATE网络权限——配合移除网络权限的思路从底层证明该应用短信功能零联网。本地存储还是系统短信库一键切换Connect You 的仓库层做了抽象应用启动时App.kt#L35-L41 的initSmsRepo()会根据本地存储短信设置决定使用LocalSmsRepo内置 Room 数据库完全脱离系统短信库或默认的 DeviceSmsRepo。DeviceSmsRepo通过系统ContentProviderTelephony.Sms.CONTENT_URI直接读写 Android 内置短信数据库并用ContentObserver监听数据变化、以Flow推送给界面——所以在 Connect You 里发送的短信系统短信应用同样能看到真正做到本地即系统。总结Connect You 的短信模块是一套教科书级的纯本地短信收发实现收SmsReceiver以 999 优先级拦截SMS_DELIVER广播 → 系统短信库 → 可回复/删除/复制验证码的通知发SmsUtil先入库再交给SmsManager两个回执 Receiver 跟踪已发送 / 已送达状态资格声明7 行代码的HeadlessSmsSendService让应用获得系统短信应用身份与快速回复能力离线保障移除网络权限、零服务器依赖短信数据只存在你自己的设备里。理解了广播接收器负责进出、回执接收器负责状态、服务负责身份这三个角色你就能读懂绝大多数 Android 短信类应用的源码结构了。【免费下载链接】ConnectYouPrivacy focused contacts and SMS messenger app built with MD3项目地址: https://gitcode.com/gh_mirrors/co/ConnectYou创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考