Repository navigation
Releases: yungui314/HyperIconPack
Release list
Hyper Icon Pack v0.9.42
更新内容
- 支持检测图标包真实的浅色/深色资源差异,并生成两份可手动切换的独立存档。
- 修复“莫奈线条”等缺少标准 fallback 声明的图标包中,未覆盖应用与已映射图标轮廓不一致的问题。
- 加强原生 monochrome 质量检测,异常或不完整的单色层会自动回退到完整图标渲染。
- 新增 MTZ 图标主题导入,保留静态图标、通用 mask/pattern/border、原主题缩放和
fancy_icons资源。 - 转换应用原始图标时优先读取隔离的 APK 资源,避免当前已应用主题污染下一次转换结果。
- 修复“图标存档”页面可能错误显示旧存档仍在使用中的问题。
- 新增独立的静态 Liquid Glass 实验开关,与 Monet 互斥,关闭时不影响普通转换。
升级说明
归档格式已升级到 35。升级后必须重新转换 APK 图标包;以前导入的 MTZ 也必须重新导入后再应用。旧格式存档会被识别为不兼容,不应继续使用。
已在 Xiaomi 14、HyperOS 3.0.303.0、系统桌面 RELEASE-6.01.05.2407-06081949 上完成构建、安装和主要流程验证。
APK SHA-256:15470C882C5DD2B645CCD4663ED68854B9A220D4D989941AF151E699C1BFE3C8
Hyper Icon Pack v0.9.41
主要更新
- 修复打开应用和返回桌面时,圆形、方形及异形图标短暂闪成圆角矩形的问题。安装器现在会像 Xiaomi 主题商店一样同步
Settings.Global.is_default_icon,并在恢复系统图标时恢复原值。 - 将标准 APK 图标包的
iconback、iconmask、iconupon和缩放规则转换为 HyperOS 原生通用图标资源,新安装或未映射应用可立即继承统一形状。 - 使用非 FullMask 的
ConfigIconMask与PointsMapping,保留显式映射主 PNG 的透明度和圆形、方形、异形轮廓。 - 动态日历改用已验证的
fancy_icons结构,并统一为 256 px 画布,避免日历图标尺寸偏大。 - DRM 保护只识别含 Hyper Icon Pack 转换元数据的活动
icons归档,不再放宽 Xiaomi.runtime目录权限。 - 保持
SupportLayerIcon=false、UseDynamicIcon=false;不重启 Launcher/SystemUI,也不使用运行时动画 Hook。
升级说明
归档格式已升级为 34。v0.9.40 及更早版本生成的图标存档不能直接沿用,请安装新版后重新转换图标包。
校验
- APK SHA-256:
b673bc4ae376e1d62995e5dbf8d7d7a8ced5964ddb8557da72130d6ea9514cd1 - versionCode:
52 - versionName:
0.9.41
Hyper Icon Pack v0.9.40
v0.9.40 更新内容
本版本集中完成转换器模块化,并修复并行转换、增量更新和缓存链路中的稳定性问题。
稳定性修复
- 修复并行 PNG 渲染跨线程复用
Drawable导致部分图标形状异常的问题。 - 修复增量更新可能用应用默认图标覆盖图标包显式映射的问题。
- 修复卸载应用时按包名前缀误删其他应用图标条目的问题。
- 清理旧增量缓存和失效状态,避免历史缓存持续累积或污染后续转换。
- 增量归档写入增加串行化和原子提交,降低并发包变更损坏当前主题归档的风险。
架构调整
- 将完整转换、增量更新、缓存、动态日历、图标解析和 PNG 渲染拆分为独立模块。
- 将 Root 操作和设置页面拆分到独立模块,减少后续修改的耦合范围。
- 动态日历帧复用与普通图标一致的形状、透明度和 Monet 渲染链路。
- 移除实验性 SystemUI 通知图标 Hook,Xposed 静态作用域仅保留
system,通知栏图标继续由 HyperOS 自身规则处理。 - Release 构建启用 R8 和资源压缩。
升级提示
- 归档格式升级为 30。
v0.9.39及更早版本生成的图标存档需要重新转换,请勿继续应用旧格式存档。 - 正式 APK 使用与
v0.9.39相同的发布证书,可直接覆盖正式版升级。
验证
- 46 个单元测试全部通过,0 失败。
- 本地
lintRelease、R8、资源压缩、正式签名和 zipalign 校验通过。 - GitHub Actions 单元测试和 Release 构建通过。
- Xposed scope 校验为仅
system。
APK SHA-256:F42488246B42AC9F33CCE40728035A35CEDA05D194931B3BB02711E8886F5E67
Hyper Icon Pack v0.9.39
v0.9.39 更新内容
本版本主要修复 HyperOS 3 上普通图标出现大黑框、部分图标回退为系统方形样式,以及刷新流程绕开主题商店官方入口的问题。
修复
- 关闭不可靠的 LayerAdaptive 分层读取。实机确认透明 Adaptive 背景层会被当前系统桌面合成为黑色方框;普通图标现在统一使用保留 alpha 的主题主 PNG。
- transform_config.xml 改为 SupportLayerIcon=false,圆形、圆角方形、直角方形和异形图标均由原图透明度决定形状。
- 归档格式升级为 29;v0.9.38 及更早版本生成的存档需要重新转换。
- 安装旧归档时会同时校验 UseDynamicIcon 和 SupportLayerIcon,避免旧配置再次开启分层读取。
- 刷新恢复为 HyperOS 主题商店同源流程:clearCustomizedIcons、resetIcons、themeChangedFlags=0x8 和 ACTION_THEME_CHANGED。
- 删除 cmd appwidget update、dumpsys appwidget 和定向 APPWIDGET_UPDATE;不再单独刷新小组件。
- 刷新过程不杀死、不 force-stop Launcher 或 SystemUI。
动态图标边界
- 动态日历仍只接入图标包已有且完整的经典 MAML 预设;缺少预设时回退静态图标。
- UseDynamicIcon 保持 false,避免系统 stock dynamicicons 覆盖图标包形状和 Monet 结果。
- 动态时钟仍保持静态,未加入不可靠的系统原生方形时钟转换。
验证
- :app:testDebugUnitTest
- lintRelease
- assembleRelease
- APK zipalign 校验通过
- 正式发布证书校验通过
- 实机使用官方 0x8 刷新时 Launcher、SystemUI 和小组件 provider PID 均未变化
APK SHA-256:18B18E3F9222E5079E02D2E0C1D3F705E1B4FBF4D96FFE4FF2AC290A23CC7813
Hyper Icon Pack v0.9.38
0.9.38
Hyper Icon Pack 0.9.38 switches the module to HyperOS-native theme refresh and icon resources.
Highlights
- Removes Launcher/SystemUI/framework animation hooks. Startup and return animations now use HyperOS Adaptive/LayerAdaptive theme resources.
- Adds official theme configuration refresh through
themeChangedFlags=0x8without force-stopping Launcher or SystemUI. - Fixes active archive/source reconciliation on the home page.
- Keeps Root/DRM ownership state truthful and restores only resources managed by this module.
- Preserves full appfilter mappings and package-level fallbacks for installed, disabled, alias, and non-launcher applications.
- Adds strict Global Monet fallback behavior and unit coverage for archive/source refresh logic.
- Supports icon-pack-declared dynamic calendars. Complete calendar frames reuse the static icon shape, alpha, original colors, or Monet output; incomplete declarations fall back to static icons.
- Embeds validated classic dynamic calendar resources in the primary
iconsarchive and disables the stock Adaptivedynamiciconsoverride, preventing square calendar replacements. - Updates documentation for libxposed API 102, native theme refresh, archive format migration, and dynamic-calendar behavior.
Compatibility
- Requires Root and a libxposed API 102-compatible framework.
- The tested target is Xiaomi 14 with HyperOS 3.0.303.0 and Launcher
RELEASE-6.01.05.2407-06081949. - Existing old-format archives must be reconverted before applying them.
- Dynamic clocks remain static unless a future release adds a validated, complete public icon-pack clock declaration.
Verification
lintRelease:app:testDebugUnitTestassembleRelease- APK signature verified with the formal release certificate.
APK SHA-256: C0399BF0D904BEA1D20BDC50BB6CF71DAF588CF3CB6932C1EBDE2FB49700DDA0
Hyper Icon Pack v0.9.36
更新内容
- 全面迁移至 libxposed API 102,要求使用支持 API 102 的 Xposed 框架。
- 图标替换统一由 HyperOS 系统主题资源
/data/system/theme/icons和系统IconCustomizer负责,移除 SystemUI、设置、手机管家、小组件中心等进程中的实时图标 Hook。 - Xposed 静态作用域缩减为系统桌面
com.miui.home,仅保留启动与返回动画兼容逻辑,降低后台注入和资源占用。 - 使用
RemotePreferences同步模块配置,并启用 API 102autoHotReload,安装新版 APK 后可热重载模块代码。 - 新增首页 Xposed API 状态展示,并自动清理旧版本遗留的额外作用域。
- 应用主题后补充刷新桌面小组件图标缓存,避免小组件继续显示上一套图标包。
- README 补充 API 102 架构、作用域和热重载说明。
升级说明
- 从
v0.9.34或更早版本升级后,建议首次重启一次桌面或设备,以清理旧 API 模块状态;之后更新 APK 可使用 API 102 热重载。 autoHotReload只负责模块 APK 代码更新。应用或切换图标存档后,HyperOS 相关进程仍需刷新主题图标缓存,这与 Xposed 热重载是两套机制。- LSPosed 作用域只需启用系统桌面
com.miui.home。
校验
- 包名:
io.github.cl0ura.hypericonpack - 版本:
0.9.36 (47) - SHA-256:
F94F6ADD7114A71E1D72929CAD222C30B34835685701C27FEAE971BF1EF2A64B
Hyper Icon Pack v0.9.34
更新内容
- 优化系统主题应用与恢复流程,只在操作完成后受控刷新桌面和系统界面。
- 移除常驻主题刷新和高频归档校验,减少桌面重载与后台资源占用。
- 优化新安装应用的增量更新,多应用更新时合并处理主题归档。
- 应用日志改为持久保存,并完善 LSPosed / Xposed 日志读取。
- 修复主页已应用图标存档后仍显示“尚未生成”的问题。
- 修复应用列表变化导致主页无法识别当前活动图标来源的问题。
- 更新项目效果图、兼容性说明与开源项目致谢。
测试环境
- Xiaomi 14
- Xiaomi HyperOS 3.0.303.0
- 系统桌面 RELEASE-6.01.05.2407-06081949
- Root + LSPosed
当前尚未在更多机型、系统版本和桌面版本上完成系统性测试,不保证其他环境可用。欢迎提交测试反馈和代码贡献。
文件校验
HyperIconPack-v0.9.34.apk
SHA-256: AF9ACED86B53A8DD37F859AA85FC07F2689C61D1716C096ADD314380077C9EC5
Hyper Icon Pack v0.9.31
首个 GitHub 正式版本。
本次更新
- 重新设计图标包转换的 Xiaomi HyperOS 3 超级岛进度:紧凑态显示图标与百分比,展开态使用原生进度条,并区分进行中、完成和失败状态。
- README 替换为 Pure Icon Pack 与“莫奈线条”的实机 Monet 效果图,并补充测试环境、兼容性说明和 ABK 参考致谢。
- 关于页改为可扩展的贡献者列表,每位贡献者独占一行并显示 GitHub 头像。
- 修复 Pure Icon Pack 等反向遮罩被误判后出现“大方框套透明圆”的问题。
- 增加环境变量驱动的正式签名构建配置。
运行要求
- Root
- LSPosed
- 推荐作用域:系统桌面、系统界面、设置与手机管家
已测试环境
- Xiaomi 14
- Xiaomi HyperOS 3.0.303.0
- 系统桌面 RELEASE-6.01.05.2407-06081949
本项目目前没有在更多机型、系统版本和桌面版本上完成系统性验证,不保证其他环境可用。欢迎提交测试反馈和代码贡献。Monet 转换仍为实验性功能,复杂、半透明或极细线条图标可能存在视觉差异。
正式版使用新的项目专用签名。此前安装的调试版无法直接覆盖安装,需要先备份所需存档和配置,再卸载调试版。
校验
HyperIconPack-v0.9.31.apk
SHA-256: 1C2AE7C92175CC9A91E4946D4605B4C8E9050F2F5B5B5E215BAB3240F184A1D0