HyperOS 4 系统桌面支持通过「侧滑停顿」呼出手机管家侧边栏。
SwipeGate 可以提高这项手势的触发距离:未达到设定距离时仍执行系统返回,达到后才允许原厂侧边栏停顿逻辑继续触发。
前往 Releases 获取最新构建。
当前提供自动构建版本,适配范围请以本页「当前支持」为准。
| 项目 | 支持范围 |
|---|---|
| 系统 | HyperOS 4 |
| 系统桌面 | Launcher 8.0+ |
| 已测试版本 | RELEASE-8.01.02.5459-260807-08242024-RRELEASE-8.01.02.5465-260807-08262034-R |
| Android | Android 17 / API 37 |
| 架构 | arm64-v8a |
| LSPosed | Modern API 102 |
| 作用域 | com.miui.home |
| Root | 不需要 |
Launcher 8.0+ 为目标兼容范围。模块不会依赖固定 Hook offset,而是扫描 Launcher native 可执行代码并寻找已验证的唯一代码特征。仅地址变化通常无需重新适配;如果目标函数本身的代码特征发生变化,则会停止安装 Hook 并保持原厂行为。
- 安装 APK。
- 在 LSPosed 中启用 HyperOS4 SwipeGate,作用域选择 系统桌面(
com.miui.home)。 - 重启系统桌面或设备,使模块加载。
- 在手机管家中将侧边栏呼出方式设为「侧滑停顿呼出」。
- 打开 SwipeGate,在「主页」中调整触发距离。
配置通过 LSPosed API 102 RemotePreferences 传递,不需要授予 Root 权限。调整后即时生效,无需重启桌面。
可修改范围为 88–300 dp:
88 dp:原厂触发距离89–300 dp:使用设定距离延后侧边栏触发
数值越大,需要向屏幕内侧滑得越远才会进入侧边栏停顿触发。
旧版本留下的 0 仍会被兼容解释为原厂 88 dp,但新界面不再提供低于 88 dp 的可调值。
显示「未激活」
确认 LSPosed 已启用模块、作用域包含 com.miui.home,并确认设备存在 HYOS Runtime,然后重启系统桌面。App 会综合 LSPosed API 102、Launcher UID、作用域和 HYOS Runtime 证据判断状态,不再依赖 Root/logcat。
显示「LSPosed 未连接」
确认正在使用支持 Modern API 102 的 LSPosed,并重新打开模块 App。
功能没有生效
进入 App 的「日志」页复制诊断信息,并在 LSPosed 日志中一并检查 HyperOS4SwipeGateNative / HOOK_SCAN / HOOK_HEALTH。
升级了系统桌面
如果只是 native 地址重新排列,模块会自动重新定位;如果目标函数被重新编译或重构导致 Pattern 不再匹配,则需要追加新版本 Pattern。反馈时请附带 Launcher 完整版本号和诊断信息。
模块通过 LSPosed Modern API 102 native_init 进入 HyperOS 4 Launcher 的 native/Rust 进程,扫描 libapp_launcher.so 的可执行段,在唯一代码特征匹配后才安装 Hook。
配置链路为 App → XposedService RemotePreferences → Launcher Java entry → Launcher cache → native,无需 su。旧系统属性仅保留为升级迁移 fallback。
逆向目标、Pattern 扫描、Hook 策略、安全校验与构建说明见 docs/TECHNICAL.md。
本项目采用 MIT License。
本项目与 Xiaomi / 小米官方无关。
