Skip to content

Releases

v2.9.156 — 快捷方式全链路修复 + 负一屏时序闸

Choose a tag to compare

本次发布范围:v2.9.146 → v2.9.156(versionCode 162 → 172)

快捷方式(本版重点)

桌面上的「快捷方式」指第三方应用通过 pin 创建、指向文件/联系人/功能的图标。

  • 重复条目:抽屉里同一条快捷方式出现两个 —— 表里只写不清理。现在按系统 pinned 集合权威对账(DB v24 新增 dismissed 列),历史残留行自动清掉。
  • 图标不对:此前一律用"创建快捷方式的应用"的图标。现在取快捷方式自身图标,并套 MIUI IconCustomizer.generateIconStyleDrawable 裁成与桌面一致的形状/内容占比。
  • 删不掉:抽屉长按快捷方式项 → 确认移除;同时取消系统 pin,原生桌面上的那个图标一起消失。移除的记录不会被下一次同步"自愈"回来。
  • 实时刷新:LauncherApps.Callback.onShortcutsChanged 主动推送 + 回桌面 / 开抽屉兜底对账,在别处删掉的快捷方式不会残留。
  • 图标设计器:快捷方式进入设计器列表(含缩略图,由桌面进程回带),设计即时生效;删除快捷方式时一并清理它的图标设计数据。

负一屏

  • PA 侧 startListening 时序闸:provider 未就绪时挂起重试(上限 45s),修"开机后立刻滑负一屏,微件显示无法添加微件"。
  • 僵尸 appWidgetId 条件放行(provider 为空才允许清理),移除就绪自杀重载(避免连杀把 PA 拖死)。
  • assets/scope.list 补 com.miui.personalassistant,覆盖安装不再冲掉 PA 作用域。

抽屉图标

  • 装载回归单段 + 图标按块解码独立超时,修"重启手机后抽屉图标整批变字母占位"。

安装

  1. 需要 LSPosed,作用域:com.miui.home、com.miui.personalassistant;
  2. 模块首页确认权限齐备后再开启第四桌面;
  3. 覆盖安装后建议重启桌面(切换一次模式即会触发)。

数据库升级到 v24(自动迁移,不丢数据)。

v2.9.123-blur-restart

Choose a tag to compare

@adaozi adaozi released this 21 Oct 10:55

v2.9.123-blur-restart(versionCode 139)

汇总 v2.9.98 → v2.9.123(versionCode 114 → 139)的全部装机批次,均已真机回归。

上游同步与功能(v2.9.98 – v2.9.121)

  • 上游同步 v1.2.0:调色板风格(PaletteStyle)、图标圆点/隐藏(S4)、搜索过滤(S3)、字体库全局接管(S5)、主页区块顺序(S6)、弹层滑动灵敏度(Lab)
  • 应用堆(App Stack):文件夹横向堆渲染 + 独立管理页(1.2.0 S4c/S6d)
  • 弹层小组件:文件夹弹层内添加/调整尺寸/全宽回写(hotfix folders2/3)
  • 负一屏:WidgetScreen 动作接 MIUI 原生 personalassistant(FEED_STATE 状态机 + showOverlay 兜底)
  • 字母条双击:可配置动作(默认锁屏);主页区块拖拽排序;日历区块;图标快照缓存(性能)

装机修复(v2.9.122 search-shortcut-fix)

  1. 抽屉启动搜索背景错乱:搜索浮层打开时抽屉页未让位,应用列表从搜索页底下透出 → 抽屉可见性与首页同构
  2. 设置·隐藏应用页缺应用:设置页(模块进程)枚举可见集少于宿主 → 新增宿主应用清单跨桥(Snapshot.appCatalog)按 key 补差集
  3. 应用列表不显示桌面快捷方式:saved_shortcuts.showInAppList 从未被消费 → 并入主列表(appsWithShortcuts),启动走 startShortcut
  4. 右滑面板「编辑收藏」点了没反应:附加行 onClick(); onDismiss() 顺序清掉刚设的 overlay → dismissFirst 先关弹层再导航

本版重点(v2.9.123 blur-restart)

  1. pin 快捷方式真修:saved_shortcuts 恒 0 行 —— MIUI 添加流程不走旁听 hook;且框架层 PinItemRequest 类型常量与 compat 不同(SHORTCUT=1)。三重修复:框架 accept hook 正确常量 + FLAG_MATCH_PINNED 公开查询面自愈同步(挂载/回桌面触发,幂等)+ 落库行无 activity 容错(startShortcut 不依赖 activity)
  2. 切模式后状态栏露壁纸(blur-gap):原生桌面 ↔ 第四模式来回切后,会话内 Compose 根被量矮一个状态栏高度(2296/2400),模糊壁纸/遮罩盖不住状态栏条带。按实测结论落地:切进第四模式(状态沿 关→开)自动重启宿主桌面(600ms 延迟、3s 冷却、进程冷启不触发无循环)。附带加固:窗口 decorFitsSystemWindows 强制 + View padding 硬闸门 + blurLayer ANOMALY 长期看门狗日志

安装

  • LSPosed 勾选作用域 com.miui.home(OS2/OS3 家族自动判别),重启桌面生效
  • 前置:媒体/通知访问权限;更新后请重启一次桌面

Full Changelog: v2.9.97-wallpaper-follow...v2.9.123-blur-restart

v2.9.96 — GraceLauncher v1.1.9 全量同步 + 装机回归修复

Choose a tag to compare

@adaozi adaozi released this 18 Oct 10:15

上游 GraceLauncher v1.1.9 全量同步(S1S6b,v2.9.8894)

  • Grace Button 可移动:设置 → Grace Button → 右上角外观 → 「位置和大小」,支持 1:1 预览拖动 + 对齐/边距/大小精调
  • 分区可见性:位置和大小页「显示范围」——仅首页 / 仅应用列表 / 两者
  • 图标设计师大更新:图标可显示为圆点或隐藏;支持用应用自身图标主色重着色(HSB 微调)
  • 主题调色板 9 风格:设置 → 主题 → 调色板风格(TonalSpot/Vibrant/Expressive 等,动态取色同样生效)
  • 文件夹自动隐藏:文件夹编辑页开关,成员从应用列表隐藏(手动 ∪ 派生集合贯通列表/搜索/工作资料)
  • 收藏编辑直达:应用弹层新增「编辑收藏」,打开即自动选中该应用
  • DB v21→v22(paletteStyle / folders.autoHideApps),40 条新界面文案含官方中文

装机回归修复

  • v2.9.87:「写了但没实现」全量审计整改(时钟自定义应用/设为默认启动器/私密空间入口等 13 项断链)
  • v2.9.96:文件夹「自动隐藏内部的应用」开关点不动 —— 设置桥快照线格式漏 autoHideApps,已修

安装:LSPosed 模块,勾选作用域 com.miui.home(小米桌面),重启桌面生效。详见 README。

Full Changelog: v2.9.86-os4b-jb9...v2.9.96-autohide-fix

v2.9.55-sync-reveal — 天气链路重构 + 审计整改 + 结构性重构 + 实机修复批(vc 69→88)

Choose a tag to compare

@adaozi adaozi released this 14 Oct 05:04

自 v2.9.35-graceicon1 以来 22 个版本合并发布(v2.9.36 ~ v2.9.55,versionCode 68 → 88)。

新特性 / 架构

  • 天气数据源重构(v2.9.36-miuiweather):移除外部 Breezy Weather 依赖,改直读小米天气 Provider。装机实锤 provider 存在调用方白名单(hasAccessProvider 仅放行 com.miui.home),天气读取上移宿主进程(GraceWeatherHostEngine)——桌面进程内直推,设置页随设置快照回带
  • 本地化(v2.9.46~48):模块页退出多任务行为修正 + 硬编码文本全量资源化、B6.x 桌面文案中文翻译补齐、设置页残留英文收尾

稳定性 / 性能

  • v2.9.37-auditfix:全仓代码审计(177 文件 ~18k 行)P0 级修复批
  • v2.9.38-colorlaw:P1 铁律整改(语义化颜色全覆盖)
  • v2.9.39-cleanup:P2 死代码清理 + 主线程编码治理
  • v2.9.41-perf:热路径反射缓存(GestureIsolator / HomeController / MainHook)+ 时钟节拍统一
  • v2.9.53-icon-perf:重启桌面后字母索引滑动卡顿修复

结构性重构

  • v2.9.43-refactor1:壁纸效果层抽离
  • v2.9.44-refactor2:WidgetController 抽离
  • v2.9.45-refactor3:GraceButton 过渡状态机抽离

实机修复批

  • v2.9.40-setbk:设置页返回堆叠修复
  • v2.9.42-minusoff:负一屏预留线整体清除
  • v2.9.49-settings-home:设置页退出直达桌面
  • v2.9.50-folder-icon:文件夹自定义图标主页生效
  • v2.9.51-icon-snapshot:单个图标设计保存不生效
  • v2.9.52-refresh-keep:安装/卸载刷新期列表不再整列消失
  • v2.9.54-favorites-first:重启桌面后应用区延迟 1-2 秒
  • v2.9.55-sync-reveal:首页内容等收藏区就绪后整体出现(消除分步揭示闪烁)

说明

  • MIUI 内置部件(gadget:时钟/一键清理/全局搜索)尝试(v2.9.56/57)已回退,挂起待后续,不在本版
  • 逐版本细节见 docs/PORTING.md

安装

  1. 安装 APK → LSPosed 启用模块,作用域勾选 系统桌面(com.miui.home)
  2. 重启系统桌面
  3. 打开模块 App 完成前置闸自检(hook 生效 / 通知监听 / root 保活)
  4. 开启第四桌面

SHA-256:95447077385ce5d9ba0dfa44cf24089dea46743edcf1c072394342e5441f68a7

v2.9.35-graceicon1 — 上游 v1.1.8 全量对齐 + 图标装饰链落地

Choose a tag to compare

@adaozi adaozi released this 11 Oct 11:13

v2.9.35-graceicon1 — 上游 v1.1.8 全量对齐 + 图标装饰链落地

自 v2.9.20 之后的第 15 个版本(v2.9.21 → v2.9.35),一次补发。

版本信息

项目 值
versionName 2.9.35-graceicon1
versionCode 68
包名 com.homemode4miui
APK SHA-256 791d46ab0d202963f620b16aacbbbdc770bc82492fc256edce355422f2096d1f
签名 与 v2.9.20 同一 keystore(SHA-256 88a95369…afd0),可直接覆盖安装
许可证 GPL-3.0

主要更新

宿主适配

  • OS2 / OS3 双版本自动判别:hook/HostCompat 按 versionCode 分家族路由(OS3 = RELEASE-6.01.03.1927,Launcher 重构后方法整体上移 BaseLauncher),同一份模块两族通吃

GraceLauncher 上游同步(v1.1.4 → v1.1.8,全量对齐完毕)

  • S1+S2:Room schema v21 + A-Z 列表 / 列表外观
  • S3:桌面手势 + Lab + 搜索下拉关闭
  • S4:Grace Button 挂载与过渡状态机
  • S5:字体管理器(assets 架构定制)
  • S7:dimWallpaper 自定义遮罩色 + 文件夹左滑开首项
  • S8:Work Profile 数据面 + 抽屉渲染 + 工作资料设置页与应用编辑器(严格 managed 过滤,双开语义零影响)
  • appwidget pin 补齐 —— 上游 v1.1.8 功能面全量对齐完毕

性能与根因修复

  • 功耗 + 冷启动专项五项根因修复(perf1–perf5)
  • 自托管 Recomposer 帧时序根修(scrubfix)
  • 无障碍三动作降级为第三层兜底 —— MIUI 原生路径逆向实锤(锁屏 = ExtraStatusBarManager 广播、通知栏/快捷设置 = statusbar 服务反射)
  • 搜索 FAB 移除(与 GraceButton 重叠遮挡手势);搜索打开时 GraceButton 禁用+隐藏门控
  • 日志导出补内容级 tag 过滤(此前 1 分钟可导出 6MB)

图标与细节(本版新增)

  • 应用图标设计生效:上游 LauncherViewModel.decorate / applyDesign 装饰链补移植,自定义图标 / 图标包保存即生效
  • GraceButton 图标修复:宿主进程模块资源解析根修(Resources$NotFoundException → createPackageContext 模块资源表)
  • 字母索引左边缘触摸修复(leftTouchEnabled 补传)
  • 设置页「添加自定义小组件」修复(ADD_WIDGET 跨进程桥,对齐桌面端 picker 语义)
  • 时钟面板移除私密空间入口行(上游对齐)
  • 应用名统一为 HomeMode4Miui

社区

  • QQ 群「桌面第四模式」(群号 578966891)开通,扫码入口见 README

安装步骤

  1. 下载下方 HomeMode4Miui-v2.9.35-graceicon1.apk 并安装
  2. 在 LSPosed 中启用模块,作用域勾选「系统桌面(com.miui.home)」
  3. 重启系统桌面(或重启手机)
  4. 系统设置 → 桌面 → 切换到第四种桌面模式

环境要求

  • 小米 / Redmi 设备,HyperOS 或 MIUI,已 root 并安装 LSPosed
  • minSdk 33(Android 13+)
  • 开发基准宿主:OS2 = RELEASE-5.39.40.10843、OS3 = RELEASE-6.01.03.1927。其它桌面版本可能存在 hook 签名漂移,详见仓库文档《移植到其它小米桌面版本》

已知限制

  • MIUI 原生「全部小组件」中的特色卡片(私有原子组件框架)不经标准 AppWidgetProvider 注册,标准 widget picker 枚举不到,属框架边界
  • widget 本体点击在部分机型可能无效(SecurityException,不崩桌面,修复跟进中)
  • 天气数据依赖 Breezy Weather Provider

完整设计文档与移植指南见 README。

v2.9.20-grace-dualapp

Choose a tag to compare

@adaozi adaozi released this 09 Oct 14:50

HomeMode4Miui 首个公开发布 🎉

一个 LSPosed 模块,为小米桌面 com.miui.home(HyperOS)以原生同款方式新增「第四种桌面模式」——不是换皮、不是借壳,而是真的 class CustomLauncherMode extends LauncherMode,与原生经典 / 抽屉 / 极简三种模式平级注册进宿主 LauncherModeController。

底座之上已全量移植 GraceLauncher(Kotlin + Jetpack Compose,GPL-3.0)桌面 UI,运行在宿主 com.miui.home 进程内;设置全家桶与通知/媒体/天气数据源运行在模块 App 进程,两进程经显式广播桥通信。

版本信息

项目 值
versionName 2.9.20-grace-dualapp
versionCode 53
包名 com.homemode4miui
签名 SHA-256 88a9536994a63fcb590b78f5d83b0119c114fa30bab3f7482e50306be367afd0
许可证 GPL-3.0

功能亮点

  • 第四桌面模式:与原生三模式平级注册,原生设置页内即可切换
  • GraceLauncher UI 全量移植:Compose 渲染的桌面主屏(时钟、日期、favorites 列表)
  • 双进程架构:宿主进程负责 UI 渲染与手势隔离,模块进程负责设置/监听/天气,广播桥互通
  • 手势隔离:手势只属于其自身 View,不与系统手势冲突
  • 收藏增删即时刷新、时钟字体/样式切换
  • 零崩溃铁律:全部 hook 点逐一隔离降级,异常带 stack trace 记录,桌面永不崩

安装步骤

  1. 下载下方 HomeMode4Miui-v2.9.20-grace-dualapp.apk 并安装
  2. 在 LSPosed 中启用模块,作用域勾选「系统桌面(com.miui.home)」
  3. 重启系统桌面(或重启手机)
  4. 系统设置 → 桌面 → 切换到第四种桌面模式

环境要求

  • 小米 / Redmi 设备,HyperOS 或 MIUI,已 root 并安装 LSPosed
  • minSdk 33(Android 13+)
  • 开发基准宿主:com.miui.home RELEASE-5.39.40.10843(HyperOS)。其它桌面版本可能存在 hook 签名漂移,详见仓库文档《移植到其它小米桌面版本》

已知限制

  • 模块按 hook 签名匹配宿主版本,非基准版本的 MIUI Home 需自行适配(欢迎提 issue 附日志)
  • 天气数据依赖 Breezy Weather Provider

完整设计文档与移植指南见 README。