WidgetEnhancer 将自定义小部件直接接入 HyperOS 原生外屏小部件系统。创建后的小部件会出现在系统的「外屏 → 小部件 → 自定义」中，可以像官方小部件一样添加、删除、排序和使用。

在外屏展示图片或循环视频。

• 支持图片和视频
• 支持裁剪、缩放和位置调整
• 按照外屏比例生成预览
• 视频支持循环播放

显示当前正在播放的音乐，并提供歌词和媒体控制。

• 歌曲名称与歌手
• 专辑封面
• 当前歌词与下一句歌词
• 播放状态
• 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 宿主渲染

模块自带配置应用，可以直接管理外屏小部件：

• 创建、编辑和删除
• 重命名
• 启用 / 禁用
• 实时预览
• 导入小部件

创建完成后，进入：

设置 → 外屏 → 小部件 → 自定义

即可将其添加到外屏。

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 目标。

com.netease.cloudmusic

用于获取更完整的网易云音乐同步歌词数据。

com.android.systemui

用于部分高级快捷设置功能。不使用相关功能时无需勾选。

1. 从 Releases 下载并安装 APK。
2. 在 LSPosed 中启用 WidgetEnhancer。
3. 至少勾选 com.miui.fliphome 作用域。
4. 根据需要勾选网易云音乐或 SystemUI。
5. 重启手机。
6. 打开 WidgetEnhancer 创建小部件。
7. 进入「设置 → 外屏 → 小部件 → 自定义」添加小部件。

部分功能需要额外系统权限：

不使用对应功能时无需授予相关权限。

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。