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

0.9.1

Stable

9/2/2026, 8:01:06 AM

0.9.1 更新日志

  1. 修复 Launcher 8.01.02.6230 下 Native Hook 目标识别失败的问题。
    新版 Launcher 中旧版 exact fingerprint 会同时命中两个函数,0.9.1 不再因为多候选直接拒绝安装,而是使用 BackGestureUtils::convert_offset 的完整行为链逐个验证候选,仅在能够唯一证明真实 on_swipe_process 时安装 Hook。

  2. 保持 fail-closed,不为 6230 写死 RVA。
    本次兼容没有加入版本白名单、固定地址、优先新版 pattern 或“取第一个候选”等不安全 fallback;如果多个候选仍无法唯一验证,模块会继续保持原厂行为。

  3. 收紧 semantic resolver 的主 Hook 权限。
    反编译确认当前 MotionEvent semantic graph 在 6230 会定位到外层 MotionEvent* 事件处理函数,与主 Hook 的 w1 / w2 / s0 ABI 不一致。因此 semantic 目前只用于诊断和交叉验证,不再在没有可信 exact 目标时单独接管主 Hook,降低 Launcher 崩溃风险。

  4. 改进 Native diagnostics。
    多候选时会分别记录 candidate RVA、fingerprint、convert_offset RVA、corroborated callsites 和 qualification 结果;失败日志也会区分 exact / semantic candidate 数量及具体 failure reason,方便后续适配 Launcher 更新。

  5. 保持已有 Launcher 兼容路径不变。
    对原本只有一个已验证 exact fingerprint 的 5459 / 6174 / 6179 等版本,仍沿用原来的 exact-authoritative 路径,不额外强制新的行为验证条件,尽量减少回归面。

本次重点

  • 新增 Launcher 8.01.02.6230 安全兼容
  • 多 exact 候选可通过行为证据自动消歧
  • semantic-only 错 ABI 风险收口
  • 诊断信息更完整

Assets

1

0.9.0

Stable

9/1/2026, 6:16:34 AM

0.9.0 更新日志

  1. 新增「丰富侧滑震动反馈」实验功能
    侧滑进入 Ready 状态时会补充一次更自然的系统原生震动反馈,让手势阶段感更清晰。

  2. 优化返回手势震动逻辑
    减少短时间内重复震动的问题,同时尽量保留系统原有的侧滑、停顿和松手反馈。

  3. 重做侧滑动画进度同步
    自定义触发距离后,返回动画会跟随新的阈值平滑延展,不再出现动画提前到位、停住或到达阈值时突然跳动的问题。

  4. 优化高阈值下的完整动画距离
    修复阈值设置越大,Ready 之后还需要继续滑很长距离才能完成动画的问题。现在 Ready 后的动画距离更接近系统原厂手感。

  5. 提升 Launcher 8.x 兼容性与稳定性
    加强 Hook 识别、异常保护和自动恢复机制,系统桌面更新后如果无法安全识别目标,会优先保持原厂行为,降低异常风险。

  6. 新增「启动动画期间立即返回 · Beta」
    从桌面打开 App 后,无需等待启动动画结束即可侧滑返回,保持更连贯的返回操作体验。

  7. 完善免 Root 控制与诊断
    优化 App、SystemUI 与 Launcher 之间的配置同步和状态检测,诊断信息更加完整,排查问题更方便。

本次重点

  • 自定义侧滑阈值的动画体验大幅改善
  • 高阈值下手势距离更合理
  • 震动反馈更自然
  • Launcher 8.x 兼容性与稳定性进一步提升

Assets

1

0.8.1

Stable

8/30/2026, 2:57:40 PM

  1. 修复 0.8.0 正式版中 LSPosed Java 入口类被 R8 裁剪导致的 ClassNotFoundException
  2. 保留资源与无用代码压缩,同时关闭类名和成员名混淆
  3. 增加 Release DEX 入口类完整性校验,防止同类问题再次发布

Assets

1

0.7.1

Stable

8/30/2026, 4:39:08 AM

SwipeGate v0.7.1 prerelease. LSPosed API 102 native_init for HyperOS 4 Launcher 8.0+. Adds Launcher 8.01.02.6174 compatibility, HyOS Runtime private-broadcast control/status transport through SystemUI, configurable 88-300 dp sidebar threshold, selectable native log levels, and stricter native hook health reporting.

Assets

1

0.6.0

Stable

8/29/2026, 2:53:28 PM

SwipeGate v0.6.0 prerelease. LSPosed API 102 native_init for HyperOS 4 Launcher 8.0+. Adds Launcher 8.01.02.6174 compatibility, HyOS Runtime private-broadcast control/status transport through SystemUI, configurable 88-300 dp sidebar threshold, selectable native log levels, and stricter native hook health reporting.

Assets

1

0.5.0

Stable

8/29/2026, 12:03:20 PM

Signed SwipeGate v0.5.0 prerelease. LSPosed API 102 native_init. Supports HyperOS 4 Launcher 8.0+, including RELEASE-8.01.02.5459-260807-08242024-R and RELEASE-8.01.02.6174-260818-08281208-R. Sidebar hold threshold range: 88-300 dp.

Assets

1