HeyBox-LiquidGlass

小黑盒液态玻璃 HeyBox-LiquidGlass

API Platform License

✨ 特性

  • 🫧 真·液态玻璃:单 pass AGSL 透镜管线 —— 圆角矩形 SDF 折射、边缘色散、重力传感器高光
  • 💧 玻璃滴选中动效:切换标签时液滴滑动、拉伸、回弹,支持手指拖拽吸附
  • 🌗 深浅色跟随:读取应用真实主题(uiMode)设定前景黑白,运行时再由背景亮度感知实时微调
  • ⚙️ 内置设置:设置 → 长按「通用设置」打开液态玻璃配置(暗/亮底色与不透明度、反色开关、恢复默认)
  • ♿ 降级兜底:Android 13 以下自动退化为轻磨砂管线,渲染器异常不崩溃

📦 安装

  1. 准备一个支持 libxposed API 102 的 LSPosed 环境
  2. 从 Releases 下载 APK 并安装
  3. 在 LSPosed 中启用本模块(作用域已限定 com.max.xiaoheihe)
  4. 强制停止小黑盒后重新打开

已在小黑盒 v1.3.392 (versionCode 1114) 上测试。其他版本如资源 ID 有变动会自动放弃注入并输出日志。 [!WARNING] 使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

🔍 工作原理

Hook Instrumentation.callActivityOnResume
  └─ MainActivity 布局手术:
       fl_container 解除底部约束(内容延伸至屏幕底)
       rg_main / vg_tips / vg_mid_tab 迁入玻璃容器
       └─ API 33+:挂载 LiquidGlassTabBar
            ├─ 原 RadioGroup 隐藏保留(选中状态机制照常工作)
            ├─ 点击玻璃滴   → rb.performClick() → 应用原生切页
            ├─ 应用内切页   → RadioGroup 监听(反射包装) → 液滴滑动
            └─ 发布按钮     → 复用原 vg_mid_tab,居中于预留空位

渲染层基于 QWEA0/Liquid-Glass-Android, 通过 AAR 字节码合并方式集成(含 kotlin-stdlib 与原生模糊库),零位图、全 GPU。

日志 tag:HeyBoxLiquidGlass

🛠️ 构建

无需 Gradle/Android Studio,脚本直接调用 JDK + build-tools:

# 1. 按 build.ps1 头部注释下载工具链(android.jar / build-tools 34 /
#    libxposed api AAR / QWEA0 main AAR / kotlin-stdlib),放入 $ToolRoot
# 2. 执行
.\build.ps1

产物输出至仓库上级目录 HeyBoxLiquidGlass-vX.Y.Z.apk,自动生成 debug 签名。

可调参数

参数 位置 默认
折射强度 / 边缘带 attachQwea0TabBar() 60dp / 16dp
色散强度 同上 0.12
中央空隙宽度 CENTER_GAP_WEIGHT 1.3
主题探测方式 uiMode(跟随应用与系统) —

⚠️ 已知限制

  • 需要 Android 13+;更低版本仅提供轻磨砂降级效果
  • 导航栏覆盖区域内的列表底部条目需滚动后才可见(沉浸式底栏的固有取舍)
  • 小黑盒大版本更新可能导致资源 ID 变化,模块将静默放弃注入

🙏 致谢

📄 License

MIT © 2026 sjtt2

vendored 代码保留原作者版权声明(见 src/com/qmdeve/liquidglass/ 文件头)。

Releases

9/2/2026, 12:53:23 PM

小黑盒液态玻璃底部导航栏 · v1.5.0更新

新增:

  • 加长选中 Tab: 选中的Tab将会稍微宽一些,其他Tab自动适应,参考BetterHeybox,并在此基础上加入了丝滑的动画效果(issue#4)
  • 玻璃条宽度调整: 现在分为自适应、占满、自定义三种模式,可以自由调整玻璃条的整体宽度,在宽屏上观感更好

修复:

  • toast 抬升偶现失效: 清理后台后重开 App药丸 toast 不再抬高——进程级一次性开关导致 watcher 循环无法重建(issue#5)
  • toast 首次出现跳位: 提示条不再先出现在屏幕底部再蹦到玻璃条上方,发现机制从 2 秒轮询改为跟随布局,出现的同一帧就位
  • 旧版样式刷新失效: 小黑盒切换到旧版社区样式后,重复点击当前 tab 不触发刷新——去掉按标题的白名单,重复点击一律交回 App 判断,新版旧版及以后改名都兼容(issue#6)

设置入口:小黑盒「我」页,长按「设置」齿轮按钮,或长按「通用设置」

已知问题:使用热重启小黑盒后,齿轮长按入口可能暂时失效,手动杀进程重启可恢复

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.393 (1119)

更多信息前往主仓库查看,点点star谢谢喵=^•ω•^=

Warning

使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

Assets

1

8/30/2026, 7:51:55 AM

小黑盒液态玻璃底部导航栏 · v1.4.0更新

  • 通知避让: 推荐页「已推荐10条新内容」、「再按一次退出程序」等胶囊toast通知自动抬升到玻璃栏上方,不再被遮挡,抬升高度实时跟随玻璃栏顶部(issue#3)
  • 适配了BetterHeybox模块的导航栏Tab隐藏功能,隐藏导航栏Tab后玻璃栏实时重排等分
  • 新增了加号按钮分离式布局,其他Tab在左边,右边单独一个加号的圆形按钮,在设置面板可以切换经典居中、右侧圆钮、和自动模式,在自动模式下tab为奇数时会自动切到右侧圆钮形态
  • 新增导航栏tab宽度调整(50%–150%)
  • 设置面板每个滑动条(不透明度/高度/偏移/Tab 宽度)标题旁新增 「重置」按钮 ,一键恢复该项默认值,互不影响

设置入口:小黑盒「我」页,长按「设置」齿轮按钮,或长按「通用设置」

已知问题:使用热重启小黑盒后,齿轮长按入口可能暂时失效,手动杀进程重启可恢复

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.393 (1119)

更多信息前往主仓库查看,点点star谢谢喵=^•ω•^=

Warning

使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

Assets

1

8/28/2026, 2:02:41 PM

小黑盒液态玻璃底部导航栏 · v1.3.0更新

  • 实现沉浸式小白条,底部内容实现edge to edge
  • 设置面板更改为更现代化的UI
  • 修复调整导航栏玻璃条高度后按钮不居中的问题

设置入口:小黑盒「我」页,长按「设置」齿轮按钮

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.392 (1114)
更多信息前往主仓库查看,点点star谢谢喵=^•ω•^=

Warning

使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

Assets

1

8/27/2026, 10:41:16 AM

小黑盒液态玻璃底部导航栏 · v1.1.1更新

  • 移植原版导航栏重复点击刷新功能,现在可以和原来一样点一下图标刷新帖子了(issue#2)

设置入口:小黑盒「我」页,长按「设置」齿轮按钮

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.392 (1114)
更多信息前往主仓库查看,点点star谢谢喵=^•ω•^=

Warning

使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

Assets

1

8/26/2026, 4:46:26 AM

小黑盒液态玻璃底部导航栏 · v1.1.1更新

  • 新入口:长按「我」页右上角齿轮打开液态玻璃设置
  • 设置页新增布局区:玻璃条高度(自适应/52–99dp)+ 距屏底悬浮距离(0–40dp)

设置入口:小黑盒「我」页,长按「设置」齿轮按钮

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.392 (1114)
更多信息前往主仓库查看,点点star谢谢喵=^•ω•^=

Warning

使用免Root框架「NPatch」时,需要把破解签名校验改成Extreme,不然会有缺少参数闪退的问题

Assets

1

8/26/2026, 4:38:40 AM

小黑盒液态玻璃底部导航栏 · 首个稳定版

  • 玻璃长条/液泡跟随系统深浅色(暗=黑烟熏底,亮=白磨砂)
  • 文字图标随背景亮度自动切换黑白
  • 玻璃滴选中动效 + 重力感应高光 + 边缘色散折射
  • 暗亮两套底色颜色与不透明度独立可调、恢复默认

设置入口:小黑盒设置页长按「通用设置」

要求:Android 13+(API 33),LSPosed 支持 libxposed API 102
测试版本:小黑盒 v1.3.392 (1114)

Assets

1