一个只做一件事的现代 LSPosed 模块：双击状态栏，强制停止当前前台应用，并以动态 Toast 显示实际被停止的应用名称。
当前版本面向 Android 16/17、libxposed API 102 和已 root 设备。APK 提供一个原生设置 Activity、一个可隐藏的 Launcher alias 和一个供 SystemUI 显式绑定的 Bridge Service；没有权限、Provider、清单 Receiver、前台 Service 或开机自启，静态作用域只有 com.android.systemui。
我以前很依赖 CustoMIUIzer 的“双击状态栏关闭当前应用”功能。升级到 HyperOS 4 后，原功能因 SystemUI Hook 点变化而失效；它又是我日常使用频率很高的操作，所以单独做了这个模块。
我日常双持 Xiaomi 17 Ultra for Leica 和 OnePlus 13T，分别运行 HyperOS 4 和 ColorOS 16。0.2.0 已在两部手机上使用同一个 APK 完成实机验证。项目保持单一职责，不依附综合模块的其他功能，便于独立更新、停用和卸载。
模块将厂商相关的触摸入口与通用的强制停止后端分开：
- HyperOS 4 使用
PhoneStatusBarView.dispatchTouchEvent(MotionEvent)观察触摸事件。 - ColorOS 16 Hook
PhoneStatusBarView.onFinishInflate()，为状态栏附加不消费事件的OnTouchListener。 - 两种入口共用系统双击时间、位移阈值和同一个前台任务解析流程。
- 从真实前台任务读取
packageName、应用 label 和 AndroiduserId，不把双开应用固定按用户0处理。 - SystemUI 进程持续绑定模块的
ForceStopBridgeService，以进程 generation 和随机 session token 鉴权；旧 token、错误协议和非 SystemUI 调用均被拒绝。 - Bridge 启动后通过 libsu 6.0.0 预连接 RootService；root 进程取得系统 ActivityManager Binder，并执行
forceStopPackage(packageName, userId)。 - 启动设置页会发出一次幂等 root 连接请求。任务切换、亮屏和解锁只在连接可恢复时触发限频恢复，不建立循环重试。
- SystemUI 启动时一次性判断自身 Binder 后端是否具有强停能力；权限拒绝后对当前进程熔断，避免每次双击重复尝试无效路径。
- 五种执行模式通过同一策略选择 Root 与 SystemUI 后端，成功后显示
已强制关闭<应用名>。
当前固定保护 Android 核心、SystemUI、MiuiHome 和当前输入法。系统设置与本模块自身不在保护名单中。找不到真实任务用户 ID、Hook 结构不匹配或 root/Binder 均失败时，本次操作会停止，不猜测目标。
本模块不修改、重签、替换或重新打包任何厂商 APK，也不修改系统分区文件。
设置页显示 SystemUI 连接、RootService 状态、SystemUI 后端能力，以及最近一次成功执行的后端和耗时。最近执行记录只保存后端类型与耗时，不保存目标包名、应用名、Activity、任务 ID 或用户历史。
执行模式：
| 模式 | 行为 |
|---|---|
| 自动 | Root 已连接时直接使用 Root；否则优先使用已确认可用的 SystemUI，并在允许时等待 Root |
| Root 优先 | 先尝试 Root，允许时回退 SystemUI |
| SystemUI 优先 | 先尝试 SystemUI，允许时回退 Root |
| 仅 Root | 只走 RootService |
| 仅 SystemUI | 只走 SystemUI Binder 后端 |
“后台保护”默认开启。模块只记录并修改自己实际拥有的 Doze 白名单与后台 AppOps 项目；关闭时仅恢复仍由本模块持有的原值，检测到外部改动则保留外部状态。设置页另提供厂商后台设置、系统电池优化设置和应用详情的逐级回退入口。
“隐藏桌面图标”默认关闭。开启后只禁用独立的 Launcher alias，不停止设置页，也不影响 SystemUI Hook、Bridge 或 RootService；覆盖安装会保留当前选择。隐藏后仍可从 LSPosed 的模块设置入口打开，也可以显式启动：
adb -s SERIAL shell am start -n com.wayne.statusbarforceclose/.SettingsActivityMagisk 通常可以在首次请求时弹出授权窗口；KernelSU 的授权策略取决于管理器配置，可能需要先在管理器中明确授权。设置页不把授权弹窗结果当作功能状态，实际连接以 RootService 状态行为准。
下表保留 0.2.0 的核心实机基线。0.3.0 的设置页、持久连接、五种执行模式、事件恢复和后台保护已通过本地门禁，用户也已在两台日用设备上确认双击强制结束功能无异常。新“隐藏桌面图标”开关已在 OnePlus 上完成隐藏、显式重入、恢复和覆盖安装保持状态测试；小米上的同项复测以 docs/device-evidence.md 的最新记录为准。
| 设备 | 系统 | Android | SystemUI Hook | 强制停止结果 |
|---|---|---|---|---|
Xiaomi 17 Ultra for Leica (nezha / 25128PNA1C) |
HyperOS OS4.0.0.10.XPACNXM |
Android 17 / SDK 37 | MIUI_DISPATCH |
libsu RootService，root 进程 uid=0 |
OnePlus 13T (PKX110) |
ColorOS 16，PKX110_16.0.10.500(CN01) |
Android 16 / SDK 36 | OPLUS_INFLATE_LISTENER |
libsu RootService |
两台设备均使用 LSPosed 2.1.1-it 和 libxposed API 102。验证包括状态栏事件捕获、前台微信 user=0 解析、RootService 成功结果、动态 Toast 和 SystemUI 稳定性。用户 ID 999 及其他有效用户的传递由单元测试覆盖，但本次 0.2.0 定版不把它描述为新增的双机实测结果。
以上是精确构建上的实机结果，不代表所有厂商 SystemUI 已自动兼容。未知类结构会 fail closed，不安装模糊 Hook。
要求：
- Android 16 / SDK 36 或更高版本；
- 支持 libxposed API 102 的 LSPosed 实现；
- 设备已 root，并向
StatusBar Force Close授予 root 权限； - LSPosed 可以正常注入
com.android.systemui。
安装步骤：
- 安装签名 APK。
- 向本模块授予 root 权限。
- 打开“状态栏强制结束”，确认连接状态并选择执行模式；建议保持“后台保护”开启，可按需隐藏桌面图标。
- 在 LSPosed 中启用模块，保持作用域为“系统界面” (
com.android.systemui)。 - 重启 SystemUI 或重启设备，使 Hook 生效。
- 打开一个普通应用，双击状态栏验证强制停止、动态 Toast 和最近执行状态。
不同签名的 APK 通常不能覆盖安装。早期 Debug APK 使用 Android Debug 证书；切换到正式签名版本时通常需要先卸载 Debug 版。后续正式版本持续使用本项目自己的独立证书，可以直接覆盖升级。
正式签名证书 SHA-256：
41722a4f43310dcd3695da5505416dea825fef37c4e1ea8913543fc938131d90
结构化诊断受编译期常量 BuildConfig.DIAGNOSTICS_ENABLED 控制：
- Debug：
true，写入 LSPosed 模块日志和 logcat； - Release：
false，R8 移除不可达的诊断分支。
查看 Debug 日志：
adb -s SERIAL logcat -v threadtime -s StatusBarForceClose主要事件包括：
- Hook：
module_loaded、hook_strategy_selected、hook_installed、touch_listener_attached； - 手势与目标：
double_tap_detected、target_resolved、force_stop_start； - 模块桥接：
systemui_bridge_bind、systemui_bridge_ready、bridge_call、libsu_root_connected； - 恢复与策略：
recovery_signal_accepted、recovery_request_result、systemui_execution_plan； - 能力与结果：
systemui_capability_reported、systemui_execution_reported； - root 执行：
root_service_bound、root_force_stop_start、root_force_stop_result； - 最终结果：
force_stop_result、toast_shown、request_released。
提交问题时请提供同一个 requestId 从 double_tap_detected 到 request_released 的完整日志，并删除不相关的个人信息。
$env:JAVA_HOME='JAVA_HOME'
$env:ANDROID_HOME='ANDROID_SDK_ROOT'
./gradlew.bat clean testDebugUnitTest lintDebug assembleDebug assembleDebugAndroidTest assembleRelease --no-daemon构建签名 Release 时额外提供：
$env:ANDROID_KEYSTORE_PATH='KEYSTORE_PATH'
$env:ANDROID_KEY_ALIAS='KEY_ALIAS'
$env:ANDROID_KEYSTORE_PASSWORD='KEYSTORE_PASSWORD'
$env:ANDROID_KEY_PASSWORD='KEY_PASSWORD'
./gradlew.bat clean testDebugUnitTest lintDebug assembleRelease --no-daemon密钥和密码不得写入 Gradle 文件、Git 历史或 Actions 日志。
.github/workflows/ci.yml：对main的 push 和 pull request 执行单元测试、lint、Debug、仪器测试 APK 和混淆 Release 构建，并用同一脚本验证两个 APK 的组件与日志契约。.github/workflows/release.yml：手动触发时生成保留诊断的签名测试包；推送versionCode-versionNametag 时生成关闭诊断的正式 Release。- 发布工作流验证签名证书、包名、版本、SDK、唯一设置 Activity、唯一 Launcher alias、唯一 Bridge Service、图标、零 Android 权限/Provider/清单 Receiver、API 102 元数据、静态作用域、隐藏 stub 未打包、R8 回调保留、日志剥离和 SHA-256。
签名材料仅保存在 GitHub Actions Secrets 中。
StatusBarForceClose/
|-- .github/
| |-- release-notes/
| `-- workflows/
|-- app/
| `-- src/
| |-- androidTest/java/com/wayne/statusbarforceclose/
| |-- main/
| | |-- aidl/com/wayne/statusbarforceclose/
| | |-- java/com/wayne/statusbarforceclose/
| | |-- res/
| | |-- resources/META-INF/xposed/
| | `-- AndroidManifest.xml
| `-- test/java/com/wayne/statusbarforceclose/
|-- hidden-api-stubs/
|-- docs/
|-- LICENSE
|-- SCOPE
|-- SIGNING_CERT_SHA256
|-- SOURCE_URL
`-- SUMMARY
- 当前 APK 为
minSdk 36、targetSdk 37；更早 Android 版本不在本次发布范围内。 - root 强停后端与厂商无关，但状态栏 Hook 入口仍依赖各厂商 SystemUI 结构。
- 当前只为已验证的 HyperOS 4 和 ColorOS 16 结构安装 Hook；其他结构会记录
UNSUPPORTED并停止。 - 模块保留 SystemUI Binder 后端用于具备权限的平台；ColorOS 16 的既有实机结果表明该路径不可用，因此 OnePlus 当前依赖 RootService。
- 模块传递真实 Android 用户 ID；读取失败时不回退到用户
0。 - release 构建不保留 Debug 诊断字符串，需要排障时使用对应提交的 Debug 或签名测试 artifact。