Skip to content

HyperHand 3.3.4

Latest

Choose a tag to compare

@zPan2327 zPan2327 released this 20 Nov 09:53

HyperHand 3.3.4 差异对比(GitHub v3.3.3 → 本地最新版)

对比基线

项 GitHub 版 本次最新版
版本 3.3.3 3.3.4
versionCode 30303 30304
GitHub tag v3.3.3(commit bd5788a) v3.3.4
LSP 仓库 tag 30303-3.3.3 30304-3.3.4
签名指纹 912FA6BF…6A7A 912FA6BF…6A7A(不变,可直接覆盖安装)

对比方式:导出 GitHub v3.3.3 源码树,与本地工作区逐文件 diff(排除 build / 缓存 / 本地配置)。
结果:18 个已有文件修改,新增 15 个文件(10 个 MIUIX 对话框宿主 + G2 圆角工具 + 5 份 SonyPods 参考源码),
不计文档/截图约 +1,100 / −600 行。


一、设置页交互全面 MIUIX 化(本次最大改动)

目标:设置页与对话框不再手写近似实现,逐字复用 SonyPods / MIUIX 源码,只替换中文文案。

1. 改动即时保存生效,去掉二次保存

  • MainActivity.java / SettingsPage.java:任何开关 / 数值 / 选择改动后立刻全量广播给
    SystemUI 写入 Settings.Global,不再需要点「保存并立即生效」。
  • 移除设置页底部保存按钮与悬浮保存胶囊;顶栏副标题由「改动保存后立即生效」改为
    「改动后立即生效」;第一个 tab 副标题「单手模式增强」删除,只留「概览」。
  • 重启对话框移除「未保存会丢失」提示;重启作用域去掉第二个确认框——第一个对话框点确定后
    直接重启对应进程(/systemui 或桌面)。

2. 选择类交互统一改为 MIUIX Dropdown

  • 新增依赖 top.yukonga.miuix.kmp:miuix-preference-android:0.9.4-rc01(glass/build.gradle.kts)。
  • 原「触发模式 / 缓动曲线 / 拉开哪个」三个手写单选对话框,以及约 23 个数值行的 Slider
    参数子页,全部改为 MIUIX OverlayDropdownPopup(DropdownImpl 选项行 + 勾选态 + 每项说明)。
  • 新增全屏透明 Compose 宿主 MiuixDropdownHost.kt 把 popup 桥接进 Java 设置页:锚点按被点行
    定位、空间不足自动翻到上方、无弹窗时把触摸还给下层;切页 / 返回 / 重启前自动收起。
  • 依赖开关的项(慢滑距离、模糊半径、拉开哪个等)补上 MIUIX 禁用态,值不清零、再打开保留。

3. 数值设置改为 MIUIX 单列 NumberPicker

  • 新增 MiuixNumberPickerHost.kt + LocalNumberPicker.kt:带数字的设置项由 Dropdown 改为
    SonyPods「临时电量岛显示时长」同款 MIUIX NumberPicker 单列滚轮对话框。沿用「索引 = 值」
    数据流,min/max/step 生成的有限选项 + 回写链路完全不变。
  • LocalNumberPicker.kt 从 MIUIX 0.9.4-rc01 源码复制并修复测量时序:itemHeightPx 直接由
    itemHeight × density 取整派生,移除 onSizeChanged 二次测量——修复首次打开时偶发只显示
    一个数字、第二次打开才正常的问题。

4. 选择行箭头改为 MIUIX 上下双箭头

  • Icons.java 新增 ArrowUpDownView:逐字复制 miuix-ui 的 10×16dp ArrowUpDown 矢量路径。
    触发模式 / 缓动曲线 / 拉开哪个及所有数值行右侧的 > 换成该双箭头;只有真正跳转新页面的行
    (关于页链接)保留 >。

5. 复选框形状对齐 MIUIX

  • MiuixCheckbox.java:26dp 圆形 CircleShape、未选中 secondary 实心(非描边)、勾路径取
    miuix viewport(23f) 三点坐标 (5,9.4)→(10.3,14.9)→(17.9,5.1) 按比例换算,描边宽
    size×0.09,按物理弹簧(987/0.6)在 secondary/primary 间过渡。Theme.java 新增 secondary
    色(light #E6E6E6 / dark #505050)。

6. 关于页 / 对话框 / 许可

  • 新增 7 个对话框宿主:InfoDialogHost.kt、SonyPodsDialogHost.kt、SimpleDialogs.kt、
    RestartScopeDialog.kt、IslandDurationDialog.kt 及 DialogStrings.kt——信息类 / 重启 /
    时长等对话框统一由 MIUIX OverlayDialog 渲染,与宿主同处一个 window。
  • MIT 许可改为中文翻译在前、英文原文在后,保留 HyperHand · MIT License 字标。
  • 字标字重改为 800(Theme.wordmark(),不识别数值字重的 ROM 回退 Bold);Logo 用
    G2RoundedRect.java 的 G2 连续曲率圆角(Kyant0/Shapes 算法逐行移植)。

二、概览页

  • 新增 StatusCardHost.kt:状态卡从 Java 手写 FrameLayout 换成真正的 MIUIX Card
    (pressFeedbackType = PressFeedbackType.Tilt、showIndication = true),倾斜 / 高亮 / 回正
    全由 MIUIX 原生实现——按住边角持续形变、松手回正,手感与 SonyPods 一致;不再用 Java 手写
    rotationX/Y + cameraDistance 复刻(大卡上会透视爆炸)。module 侧 Canvas 图标 View 经
    AndroidView 原样嵌入,零视觉差异;颜色与右下角图标位置按原版逐像素还原。
  • 两张小卡文案改为「单手模式增强 / 快捷菜单滑选(已启用 / 已禁用)」;状态值字重加粗。
  • 副标题「单手模式增强」删除,只留「概览」。

三、功能修复

1. 底栏液态玻璃「上下冒黑块」

  • ViewBackdrop.kt:原先采样区被 wanted.intersect(source) 裁到 source 边界,底栏贴底时
    折射 padding 越出 source,位图铺不满 layer,透明缝被 lens/色散按 half4(0) 采样成纯黑。
    改为保留完整 layer 区域(仅整体不相交才放弃该帧),并新增 fallbackColor:capture 用页面
    底色铺底(PorterDuff.SRC)、drawImage 前先 drawRect 铺满,任何未覆盖缝隙都是不透明
    页面底色。DampedDragAnimation.kt:pressProgress 加 coerceIn(0f,1f),避免连点 / 快拖时
    spring 越界叠加出错配中间态。

2. 菜单开着时点背景图标误开其它 App

  • ShortcutSlide.java:新增 hostAnchorX/Y——菜单弹出瞬间记下长按宿主图标 A 的按下锚点。
    菜单开着时只有点在 A 上才「关菜单 + 打开 A 的 App」;点背景模糊的其它图标 B 走
    isHostIcon()(图标矩形是否含锚点,外扩 8dp 容差)判定为 false 后只关菜单、不打开 B。
    不受图标重排 / View 复用影响。

3. 滑选交互其它一致性

  • PagePager.java / Ui.java:底栏弹性、横滑边界阻尼、切页速度等手势曲线对齐 MIUIX
    MiuixOverscrollEffect,修正快速来回拖动时的越界回弹与指示器反馈。

四、文档

  • README.md:调参流程由「改数值 → 保存 → 生效」改为「自动保存、立即生效」;新增维护者
    签名一致性警告(hyperhand.keystore 与 Secret ANDROID_KEYSTORE_B64 必须同一把,当前指纹
    912FA6BF…6A7A),发版只走 CI 打 tag 一条路,避免竞态覆盖导致用户无法覆盖安装。
  • docs/发布到模块仓库.md:新增「必须保持一致的『三处密钥』」小节,列明本地 / Secret / CI
    恢复三处位置与当前指纹。
  • docs/sonypods-dialogs-reference/:新增 5 份 SonyPods 原版对话框源码作为逐字复刻的参考底稿。
  • CHANGELOG.md:3.3.4 正式版条目,完整记录上述改动。

五、变更文件清单

修改(18):CHANGELOG.md、README.md、docs/发布到模块仓库.md、glass/build.gradle.kts、
HyperGlassBarView.kt、ViewBackdrop.kt、DampedDragAnimation.kt、AboutPage.java、Icons.java、
MainActivity.java、MiuixCheckbox.java、MiuixDialog.java、OverviewPage.java、PagePager.java、
SettingsPage.java、ShortcutSlide.java、Theme.java、Ui.java

新增(15):

  • glass/.../glass/dialogs/:DialogStrings.kt、InfoDialogHost.kt、IslandDurationDialog.kt、
    LocalNumberPicker.kt、MiuixDropdownHost.kt、MiuixNumberPickerHost.kt、RestartScopeDialog.kt、
    SimpleDialogs.kt、SonyPodsDialogHost.kt、StatusCardHost.kt
  • module/.../hyperhand/G2RoundedRect.java
  • docs/sonypods-dialogs-reference/:AppPickerDialog.kt、LeAudioAlertDialog.kt、
    LeAudioPairingHelpDialog.kt、PodImageConfigDialog.kt、README.md

六、发布与安装

  • GitHub:zPan2327/HyperHand tag v3.3.4,CI 自动构建并把签名 APK 挂到 Release。
  • LSP 仓库:Xposed-Modules-Repo/io.github.zpan2327.hyperhand tag 30304-3.3.4,同步 Release + APK。
  • 签名指纹不变(912FA6BF…6A7A),可直接覆盖安装 3.3.3,无需卸载;需支持 libxposed API 102 的框架。