Skip to content

新增 HyperOS 3 副卡数据通道激活实现,并修复蜂窝分流的网络与 DNS 选择 - #3

Merged
Linoleic merged 3 commits into
Linoleic:masterfrom
RunawayBoat:codex/hyperos-secondary-cellular
Oct 30, 2026
Merged

Linoleic merged 3 commits into
Linoleic:masterfrom
RunawayBoat:codex/hyperos-secondary-cellular

Conversation

@RunawayBoat

@RunawayBoat RunawayBoat commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

本 PR 包含两个可独立采用的改动:副卡数据通道激活,以及蜂窝分流的系统默认网络与 DNS 选择修复。

在测试副卡通道激活时,发现副卡已获得独立接口、IP、路由和 DNS,直接绑定该 Android Network 可以访问网络,但经 MultiRoute 分流的应用仍可能无法加载。进一步排查发现,UID 策略路由和网络查询接口返回值的修改,并不足以同步 netd 中的每应用默认网络,因此补充了第二部分修复。

测试环境

项目 信息
机型 小米 14
型号 / 设备代号 23127PN0CC / houji
处理器 高通骁龙 8 Gen 3(SM8650)
ROM HyperOS OS3.0.300.4.WNCCNXM
Android Android 16 / API 36
权限环境 Magisk Root、LSPosed

以下验证结果均来自这台设备。

一、副卡数据通道激活

入口与调用

本 PR 不包含上述两种副卡激活方案的开关 UI,仅提供核心实现与调用接口。开关的位置、样式及状态交互交由维护者结合项目现有界面设计自行实现并接入,避免将实验原型中的界面设计直接引入项目。两种方案应互斥选择,也可通过 select(context, 0) 关闭。

DualSimController 复用项目已有的 SuHelper 执行 Root 命令,提供以下挂起函数:

DualSimController.select(context, 1) // 双卡状态属性方式
DualSimController.select(context, 2) // 受限网络请求方式
DualSimController.select(context, 0) // 停止
val mode = DualSimController.status()

控制器使用已安装 APK 的 sourceDir 作为 CLASSPATH,通过 setsid 启动独立 app_process,入口为 com.multiroute.cellular.DualSimDaemon。Root 进程持续持有请求,生命周期独立于应用界面。

select() 返回进程启动或停止的检查结果;status() 返回识别到的单个进程所用方式(1 / 2),否则返回 0。这两个结果不代表网络已连接或通过互联网验证,网络状态仍需结合 ConnectivityManager 回调及通道信息判断。

框架初始化与副卡选择

独立进程先调用 Looper.prepareMainLooper();检查 TelephonyFrameworkInitializer.getTelephonyServiceManager(),为空时创建并设置 TelephonyServiceManager;再通过 ActivityThread.systemMain() / getSystemContext() 获取系统 Context。显式初始化电话服务用于处理独立进程访问 SubscriptionManager 时遇到的空指针问题。

通过 SubscriptionManager.getDefaultDataSubscriptionId() 获取默认数据订阅,查询活动订阅列表,选取唯一一个非默认订阅作为副卡,不硬编码订阅 ID。默认数据订阅无效、不在活动订阅中、没有副卡或存在多个非默认活动订阅时,不申请副卡网络并保持监听。启动时先注册 OnSubscriptionsChangedListener 和默认数据订阅变化广播,再读取状态;两类事件在主 Handler 上做 300 毫秒防抖,仅主副卡订阅发生变化时释放旧请求并重新申请。未使用周期轮询。

两种网络请求方式

两种方式均立即并行注册两条独立请求:一条仅要求 INTERNET,另一条要求 INTERNET + MMS。共同请求模板为:

new NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
    .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
    .setNetworkSpecifier(new TelephonyNetworkSpecifier.Builder()
        .setSubscriptionId(secondary).build());

第二条请求在该模板上增加 NET_CAPABILITY_MMS。此处能力为同时满足条件;卡1的 cmnet 在原先合并请求下出现 NO_SUITABLE_DATA_PROFILE,因此保留独立的 INTERNET 请求以适配不同时支持 MMS 的上网 APN。两条请求可由同一个网络满足,不强制建立两个接口;单条注册异常不撤销另一条,两条均注册失败时记录错误并清理。代码不设置原先试验实现中的 15 秒后备等待。

方式一:双卡状态属性。 读取并保存 ril.multisim.dualdata_status 原值(读取默认值为 2),原值不是 1 时先设为 1,再发起请求;因订阅事件重建请求时再次检查并确保该属性为 1。清理时,仅当本进程曾修改属性且当前值仍为 1,才尝试恢复原值。该检查不能判断其他进程是否也设置过相同值。

方式二:受限网络请求。 在两条请求上均调用 removeCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED),不写入双卡状态属性。实际网络能否供其他应用使用,还取决于系统网络访问控制和分流配置。

两种方式均不主动修改默认数据卡,不调用彩信发送接口。MMS 仅作为网络请求能力使用,实际 APN 选择、连接建立及计费由系统和运营商处理。

持有、切换与清理

Root 进程为两条请求分别注册 NetworkCallback 并运行 Looper。onAvailable、onLost、onUnavailable 以 MultiRouteDualSim 标签记录日志,并区分请求能力及目标订阅。onUnavailable 仅记录事件,不因单条请求不可用而终止另一条请求。

控制器使用 Mutex 串行处理切换,通过 ps -A -o PID,ARGS 匹配自身入口及方式参数。切换时向旧进程发送 SIGTERM,确认退出后启动新进程;若同一方式已有单个进程运行则直接返回。

入口通过 finally 和 JVM shutdown hook 尝试注销订阅监听、广播接收器及两条网络回调,取消待执行任务,并恢复方式一修改的属性。强制终止或运行时崩溃不能保证执行清理,属性恢复属于尽力处理;进程死亡后,Android 服务负责释放其网络请求。

不配置开机自启,也不自动拉起退出的进程。持续持有副卡通道可能增加耗电,并产生副卡流量或漫游费用。

入口通过类名由 app_process 调用,混淆规则保留:

-keep class com.multiroute.cellular.DualSimDaemon { public static void main(java.lang.String[]); }

二、蜂窝分流的系统网络与 DNS 选择修复

问题原因

Linux UID 策略路由只影响数据包出口,不能同步 netd 使用的每应用默认网络。应用的 DNS 解析、新建套接字标记和默认网络回调仍可能指向另一张 SIM;仅修改 getActiveNetwork 等查询结果也不能替代这些系统状态。

实现

Hook ConnectivityService.createNrisFromMobileDataPreferredUids,将 MultiRoute 明确分配到蜂窝接口的 UID 按接口分组。根据接口当前 NetworkAgent 的 TelephonyNetworkSpecifier 构建指定订阅的系统多层请求,保留原有移动数据偏好优先级,并提供系统默认网络回退。若目标网络缺少 NOT_RESTRICTED 能力,系统侧请求也相应移除该要求。

由 ConnectivityService 自身同步 netd UID 范围、每应用默认网络及回调,使普通 DNS 解析和新连接跟随所选蜂窝网络。未能构建指定订阅请求时退回原系统方法。未分配的 UID,以及其他工具加入移动数据偏好但未被 MultiRoute 指定蜂窝目标的 UID,保留原系统处理。

应用同步规则、发布缓存后,发送规则变化通知。system_server 接收器沿用已有发送方检查,在 ConnectivityService Handler 上刷新缓存,并根据接口、订阅及受限状态的变化重建移动数据偏好。这样即使 UID 名单不变、只是切换了目标 SIM,也会刷新系统状态;清空规则同样通知系统。

对已分配蜂窝接口的 UID,生成 IPv4 和 IPv6 路由规则。若该接口的 IPv6 路由表没有默认路由,再增加同 UID 的 IPv6 不可达规则,防止空表查找继续落到另一张 SIM。每次同步及开机恢复时重新判断,由现有优先级清理流程撤销旧规则。不可达规则使 IPv6 连接快速失败,应用是否回退 IPv4 取决于其网络实现。

本次修复不替换已有 DNS DNAT 规则生成逻辑。

与副卡激活的关系

分流修复不调用副卡激活的类或方法,可以独立编译和采用。它只要求目标蜂窝网络已存在,可以是主卡,也可以是系统或其他工具建立的副卡通道。

副卡激活代码只负责建立并持有网络请求,不自行绑定其他应用的套接字或增加 UID 策略路由。

当前分流目标仍按接口名保存。接口名可能在网络重建或重启后变化,保存接口名不等于永久绑定某张 SIM。

验证结果

  • 本地 172 项单元测试通过,包含默认数据订阅切换、无有效默认订阅、缺少副卡及多副卡歧义的选择测试;Debug APK 构建和签名验证通过。
  • 从测试设备的网络服务 DEX 核对了新增 Hook 所需隐藏方法的签名;安装并重启后确认 Hook 加载成功。
  • 两种激活方式均完成副卡通道建立实验;方式二不修改双卡状态属性。后续分流及实际页面验证使用方式二。
  • 实测副卡具有独立接口、地址、路由和 DNS,并通过系统联网验证;直接绑定副卡 Network 的 HTTPS 请求成功。
  • 分流修复后,ConnectivityService 和 netd 均将指定应用的每应用默认网络指向副卡,另一个保持原有主卡分流的 UID 未随之切换。设备上确认生成了相应 IPv6 不可达规则。
  • 真实 ChatGPT 进程出现成功 DNS 记录,以及使用副卡地址、对应网络标记的双向 TCP 连接。

应用依赖的验证

ChatGPT 的“选择套餐”页面仍出现灰色加载占位时,发现 Google Play 商店和 Google Play 服务未分流,仍走 Wi-Fi,Play 服务存在多个重试中的 HTTPS 连接。

将 ChatGPT、Google Play 商店和主用户 Google Play 服务一并分配到副卡并重启 ChatGPT 后,系统确认三个 UID 的默认网络均指向副卡,Play 商店和 ChatGPT 均建立副卡连接,截图确认套餐价格、功能说明和升级按钮正常加载。验证时原有 ChatGPT DNS DNAT 规则已恢复。

这说明跨进程联网的功能可能需要同时配置相关依赖。Google 组件也服务于其他应用,因此该配置仅作为使用说明,不由代码自动应用。测试未执行购买或发送聊天消息。

并行请求补充验证与关闭行为

同一测试设备上,默认数据订阅为 2、副卡订阅为 15、双卡状态属性为 1,使用独立限时程序并行提交两条均移除 NOT_RESTRICTED 要求的请求。两条请求间隔约 2 毫秒,约 5.5 秒获得同一副卡 Network,约 6.9 秒通过系统联网验证;55 秒观察期间未收到丢失回调,结束时系统确认两条实验请求均释放。此结果仅验证上述卡片和属性状态组合,不将其扩大为其他组合的验证结论。并行逻辑随后合入核心实现。

关闭激活方案仅释放本进程的请求。若应用分流的系统网络偏好或应用本身仍持有副卡请求,通道可能继续存在;此实现不自动撤销这些分流配置,也不保证接口立即消失。

AI 辅助说明

本次实现、问题排查及 PR 正文使用 OpenAI Codex(GPT-6.1-Sol)辅助完成。测试设备及相关实验操作由贡献者提供并授权。源码沿用项目 GPL-3.0 许可。

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review 🔄 Running since 2026-10-29T04:38:10.498737Z 21361db PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Linoleic commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

感谢提供实现和详细的验证记录。我们已在另一台 HyperOS 设备(Android 17 / API 37)上补做双卡与双 Wi-Fi 环境下的验证:副卡互联网通道可以建立,两个测试 UID 分别使用不同 SIM 的 HTTPS 请求通过,按 UID 统计的两个出口 TCP443 包数分别为 12/0 与 0/12。

集成过程中补充了以下修复,代码已放在 #4:

  • 78686e6:统一使用场景覆盖后的有效在线配置,为模块创建的请求约束具体 Network;适配 Android 17 的刷新入口,以及 UID 集合不变时更换目标卡的重建逻辑。
  • ce35568:修复目标通道丢失 IPv6 默认路由后可能静默使用另一张 SIM 的问题;该行为已实机复现并完成修复前后对照。
  • 9b6fa92:正常停用改为由后台进程先释放请求、恢复原属性并确认,再退出,避免依赖 SIGTERM 下未可靠执行的 Java 清理。
  • b4bbbf2:补充双语 Unreleased 说明。

本地 182 项 JVM 测试、Release 构建和针对性实机回归通过;完整整合版本的远端 Actions 也已通过,包括单元测试、Release APK、正式签名和更新清单检查。现已通过 merge commit 将 #4 合入 master(51fd5dc),本 PR 也已被 GitHub 标记为已合并,原有提交及作者记录完整保留。

验证边界:当前设备未出现同一 SIM 下两个互联网承载的拓扑,这部分有候选选择单元测试,但不声称已实机复现。当前仍按接口持久化;稳定 SIM 身份绑定和正式操作界面后续推进。异常强杀后的属性恢复仍为尽力处理。

合并后的 master 分支 CI 也已全部通过,正式签名校验与 APK 产物上传成功。

Linoleic added a commit that referenced this pull request Oct 30, 2026
整合 PR #3 的副卡数据通道实现及多蜂窝分流补充修复,保留原作者提交记录。

有效配置、每应用默认网络、Android 17 刷新兼容、IPv6 回退与受控停用已完成针对性实机回归;整合版本 CI 通过。
@Linoleic
Linoleic merged commit bf0fb5c into Linoleic:master Oct 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants