WidgetEnhancer 将自定义小部件直接接入 HyperOS 原生外屏小部件系统。创建后的小部件会出现在系统的「外屏 → 小部件 → 自定义」中，可以像官方小部件一样添加、删除、排序和使用。
Important
本模块面向 Xiaomi MIX Flip，需要 Root、LSPosed 和 HyperOS 外屏桌面 com.miui.fliphome。
在外屏展示图片或循环视频。
- 支持图片和视频
- 支持裁剪、缩放和位置调整
- 按照外屏比例生成预览
- 视频支持循环播放
显示当前正在播放的音乐，并提供歌词和媒体控制。
- 歌曲名称、歌手、专辑封面与播放状态
- MediaSession 媒体控制
- SuperLyric 同步歌词支持，可覆盖更多音乐客户端
- 在线歌词搜索兼容模式：根据 MediaSession 的歌名、歌手和时长匹配整首歌词，不安装 SuperLyric 也可使用
- 外屏显示上一句、当前句和下一句歌词
- 网易云音乐保留原有 Hook fallback
SuperLyric 可用时优先使用其歌词；兼容模式作为在线搜索兜底。只要音乐客户端能够正常向 Android MediaSession 暴露歌曲信息，理论上都可以尝试使用歌词功能，因此不再局限于单一音乐客户端。
| 操作 | 功能 |
|---|---|
| 单击 | 播放 / 暂停 |
| 双击上半区域 | 上一首 |
| 双击下半区域 | 下一首 |
| 长按上半区域 | 增加音量 |
| 长按下半区域 | 降低音量 |
可以创建包含 1～6 个按钮的快捷小部件，按钮数量会自动匹配对应布局。
支持绑定应用以及常用系统操作，包括：
- 打开应用
- 音量控制与静音
- 手电筒
- 勿扰模式
- 自动旋转
- 锁屏
- 播放 / 暂停
- 上一首 / 下一首
- 部分快捷设置功能
在外屏同步显示最近的 3 条通知，每条显示应用图标、标题和内容。
| 操作 | 功能 |
|---|---|
| 单击通知 | 跳转对应应用 |
| 左滑通知 | 删除该通知 |
需要授予通知使用权，该权限也用于媒体会话读取。
提供一整页 2 × 3 网格，可以自由摆放手机应用提供的 Android AppWidget。
- 支持 1×1、2×1、1×2、2×2、1×3、2×3 槽位
- 支持按住拖动调整位置
- 点按槽位可调整尺寸、圆角或删除
- 支持小部件自身点击和滚动交互
- 首次使用时按系统提示完成 AppWidget 授权
- 支持直接打开系统桌面小部件面板，选择后直接加入当前外屏布局
支持导入外部 .zip / .mtz MAML 小部件包，例如从主题商店提取的 2×3 小部件。
- 可作为系统原生 MAML 小部件导入
- 也可加入 2 × 3 应用小部件页面进行混合布局
- 由 FlipHome 原生 MAML 宿主渲染
- 支持读取系统桌面已经缓存的 MAML 小部件，并通过预览图直接导入
模块自带配置应用，可以直接管理外屏小部件：
- 创建、编辑和删除
- 重命名
- 启用 / 禁用
- 实时预览
- 导入小部件
创建完成后，进入：
设置 → 外屏 → 小部件 → 自定义
即可将其添加到外屏。
WidgetEnhancer 基于 LSPosed / Xposed Hook 实现，主要作用于 Xiaomi MIX Flip 的外屏桌面进程：
com.miui.fliphome
模块将自定义小部件信息注入 HyperOS 原有的小部件列表，并复用系统已有的小部件管理和页面机制。
flowchart TD
A[WidgetEnhancer 配置应用] --> B[小部件配置与媒体数据]
B --> C[LSPosed Hook]
C --> D[com.miui.fliphome]
D --> E[HyperOS 原生小部件列表]
E --> F[添加 / 删除 / 排序 / 持久化]
F --> G[外屏自定义小部件]
因此，小部件的添加、删除、排序、页面管理和持久化会尽可能继续使用 HyperOS 原有逻辑，模块主要负责自定义小部件的数据、配置与显示内容。
当前主要适配 Xiaomi MIX Flip（ruyi）+ HyperOS。
由于不同 HyperOS 版本的内部实现可能存在差异，系统 OTA 后可能需要更新模块才能继续正常使用。
com.miui.fliphome
这是模块的主要 Hook 目标。
android
用于在系统服务中仅为 com.miui.fliphome 放行 AppWidget 绑定权限，从而避免添加应用小部件时重复弹出系统授权确认。使用该功能时需要在 LSPosed 中勾选 android 作用域。
com.miui.home
用于读取系统桌面已经缓存的 MAML 小部件，并在 WidgetEnhancer 中提供预览和导入。
com.miui.personalassistant
用于直接打开 HyperOS 系统桌面的小部件选择面板，并把选中的 AppWidget / MAML 小部件回传到 WidgetEnhancer。
com.netease.cloudmusic
保留网易云音乐歌词 Hook fallback。通用歌词推荐使用 SuperLyric，或直接开启 WidgetEnhancer 内置的在线歌词兼容模式。
com.android.systemui
用于部分高级快捷设置功能。不使用相关功能时无需勾选。
- 从 Releases 下载并安装 APK。
- 在 LSPosed 中启用 WidgetEnhancer。
- 至少勾选
com.miui.fliphome作用域；需要导入系统桌面缓存时勾选com.miui.home，需要直接调用系统桌面小部件面板时勾选com.miui.personalassistant，需要 AppWidget 免授权绑定时同时勾选android。 - 根据需要勾选网易云音乐或 SystemUI；需要高质量通用同步歌词时可安装 SuperLyric，也可以直接使用内置在线歌词兼容模式。
- 重启手机。
- 打开 WidgetEnhancer 创建小部件。
- 进入「设置 → 外屏 → 小部件 → 自定义」添加小部件。
部分功能需要额外系统权限：
| 权限 | 用途 |
|---|---|
| 通知使用权 | 获取媒体播放状态、音乐信息和最近通知 |
| 相机权限 | 控制手电筒 |
| 勿扰模式访问权限 | 控制勿扰模式 |
| 修改系统设置 | 控制自动旋转等系统功能 |
| AppWidget 系统授权 | 未启用 android 作用域时，首次添加第三方应用小部件需完成系统绑定授权 |
不使用对应功能时无需授予相关权限。
从 0.8.3 开始，官方 Release 使用永久固定签名，后续版本会保持同一证书，可直接覆盖升级。
正式签名证书 SHA-256：
996d10e602eb6e0a1cd8a3853128d6ce4d4e456078d93eb2ce27e655d9f89215
Important
0.8.2 及更早版本由临时 CI Debug Key 签名，与 0.8.3 起的正式签名不同。因此从旧版升级到 0.8.3 时，需要最后一次卸载旧版后重新安装；从 0.8.3 开始后续版本可正常覆盖升级。
git clone https://github.com/luckylca/WidgetEnhancer.git
cd WidgetEnhancer
./gradlew assembleRelease构建产物位于：
app/build/outputs/apk/release/
WidgetEnhancer 使用 GNU General Public License v3.0（GPL-3.0） 开源。
你可以在 GPL-3.0 条款下使用、修改和分发本项目。分发修改版本时，需要遵守 GPL-3.0 对源代码公开及许可证保留等要求。
完整协议请参阅 LICENSE。