HyperOS4 SwipeGate Logo

HyperOS4 SwipeGate

延后 HyperOS 4 侧滑停顿触发,不改变返回手势。

Build APK Release Android 17 LSPosed API 102 License

介绍

HyperOS 4 系统桌面支持通过「侧滑停顿」呼出手机管家侧边栏。

SwipeGate 可以提高这项手势的触发距离:未达到设定距离时仍执行系统返回,达到后才允许原厂侧边栏停顿逻辑继续触发。

下载

前往 Releases 获取最新构建。

当前提供自动构建版本,适配范围请以本页「当前支持」为准。

当前支持

项目 支持范围
系统 HyperOS 4
系统桌面 Launcher 8.0+
已测试版本 RELEASE-8.01.02.5459-260807-08242024-R
RELEASE-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 并保持原厂行为。

安装与使用

  1. 安装 APK。
  2. 在 LSPosed 中启用 HyperOS4 SwipeGate,作用域选择 系统桌面(com.miui.home
  3. 重启系统桌面或设备,使模块加载。
  4. 在手机管家中将侧边栏呼出方式设为「侧滑停顿呼出」。
  5. 打开 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 / 小米官方无关。

鸣谢

Releases