English | 中文
Highlights
- Major UI and interaction upgrade: Miuix / Material 3 Expressive redesign, floating bottom bar, dynamic backgrounds, refined motion, and broader responsive layout improvements
- Stronger installer strategy: configurable installer modes, unified authorization handling, and per-profile signature policy controls
- Better notifications and system integration: Xiaomi Super Island support, Control Center tile, improved progress feedback, and more reliable notification behavior
- More complete installation experience: long-press install actions, APK select-all, duplicate package detection, richer install details, and better split / XAPK / ZIP handling
- Extensive stability fixes and internal refactoring across installation sessions, parsing flows, navigation animations, module handling, update behavior, settings, and dependency injection
What's Changed
New Features
- Added: Stable version naming now uses the date-based
26.05format - Added: Configurable installer modes with a redesigned mode selection flow
- Added: Per-profile policy toggles for signature mismatch and unknown signatures @4h9fbZ
- Added: Experimental "Install without user action" option for Android 12+
- Added: Background installation action from the preparation screen, including long-press background install behavior
- Added: Silent update and background update flow improvements
- Added: Android 14+ ownership update handling during session installation
- Added: Control Center tile for quick access to InstallerX @7fMeteor
- Added: Xiaomi Super Island notification support with a configurable blocking interval
- Added: Direct HTTP / HTTPS link handling in the installer flow
- Added: Long-press actions for installation and copying app details, with haptic feedback
- Added: Experimental display of file path and install initiator
- Added: "Select All APKs" option in installer configuration @Prslc
- Added: Package identity checks to detect identical APKs
- Added: Notification when installation analysis fails @HChenX
- Added: KernelSU soft reboot support
- Added: Xposed detection and quick access to LSPosed settings
- Added: Module icon support and
webuiIconhandling - Added: Configurable Toast display modes
- Added: Ghproxy support for update checks and centralized update state handling @hamjin
Improvements
- UI Overhaul: Major redesign across Miuix and Material 3 Expressive interfaces
- Improved: Floating bottom bar support with refined colors, item content behavior, and Material 3 support
- Improved: Animated fluid backgrounds for status cards
- Improved: Background effects, blur rendering, and OS3-inspired background variants
- Improved: Edge-to-edge layouts, landscape layouts, and responsiveness across device sizes
- Improved: Dynamic color support for Miuix installer sheets
- Improved: Direct bitmap color extraction during installer flows
- Improved: Installation progress UX and notification builder strategy
- Improved: Notification style selection, update frequency, and notification reliability
- Improved: Mi Super Island icon and notification behavior
- Improved: Configuration resolution, install flag initialization, installer mode state management, and configuration scope display
- Improved: Module installation log container layout
- Improved: App icon cache clearing, seed color calculation, and icon management
- Improved: APK / XAPK / ZIP / split-selection flows
- Improved: Refined error types, actionable suggestions, and localized descriptions for installation and uninstallation
- Improved: Offline build flavor now removes the
INTERNETpermission - Improved: Automated background cache sweeping
- Improved: Internal state management, dependency injection, settings interactions, and service lifecycle handling
- Improved: Predictive back animation behavior and notification settings @AlexLiuDev233
- Improved: Snackbar dismissal by swipe @AlexLiuDev233
Changes
- Changed: Version naming moved from the old
v2.x.xformat to date-based26.05 - Changed: Installer mode, working mode, managed installer package, and authorization-related logic were further unified
- Changed: Installation and uninstallation exception handling was standardized with clearer enum-based models @AlexLiuDev233
- Changed: Theme and color systems migrated to newer Color Spec / Material Kolor based handling
- Changed: Navigation was refactored around Navigation3 back stack management
- Changed: Recyclers and several service dependencies were migrated into Koin wiring
- Changed: Build tooling and dependencies were updated, including Gradle, AGP, Kotlin, Room, Miuix, and Material 3
- Changed: Documentation website and deployment workflow were removed from the repository
Fixes
- Fixed navigation back animations freezing or being interrupted in certain scenarios @Prslc @AlexLiuDev233
- Fixed back press behavior in the main pager so it returns to the home page when appropriate @Prslc
- Fixed window insets being consumed multiple times @youfeng11
- Fixed APatch detection flag handling and settings padding issues
- Fixed GitHub update channel reset behavior when no custom URL is configured @hamjin
- Fixed multi-APK selection behavior in installer dialogs
- Fixed robustness issues in Xiaomi-specific notifications and network cleanup
- Fixed module icon color extraction and
webuiIconhandling - Fixed several XAPK parsing and installation choice issues
- Fixed primary base split selection not being prioritized correctly
- Fixed APK parsing issues with negative resource IDs @SoClear
- Fixed theme selection dialogs not being scrollable
- Fixed potential InstallerService timeout crashes on Android 13 and below
- Fixed premature APK pre-selection in MixedModuleZip flows @Prslc
- Fixed inaccurate error text for invalid APK installation failures
- Fixed text color and title inconsistencies on installation preparation screens and Miuix dialogs
- Fixed authorization state issues in system app mode @AlexLiuDev233
- Fixed non-module entities not being deselected correctly during module installation
- Fixed redundant toggle behavior when selecting all APKs
- Fixed several issues around notification style detection, update dispatchers, and post-install task parameter passing
- Fixed blur being enabled unexpectedly by default on Android 11 and below @Ephemera42
- Fixed default dynamic color behavior on Android 11 and below @budingxiaocai
- Fixed API-specific theme setting visibility and removed obsolete blur warning behavior @Ephemera42
- Fixed mixed module and APK entities not entering batch mode correctly
Docs & Translations
- Docs: Updated contribution guidelines, supported-version notes, README content, and project status notes
- Docs: Added
AGENTS.mdcollaboration guide - Translations: Thanks to all Hosted Weblate contributors for continued multilingual text improvements and refinements
亮点
- 界面与交互大幅升级：Miuix / Material 3 Expressive 体系重构，新增浮动底栏、动态背景、更细致的动效与更完整的响应式布局适配
- 安装策略进一步增强：新增可配置安装模式、统一授权逻辑，并支持 Profile 级签名策略控制
- 通知与系统集成增强：支持小米超级岛、控制中心磁贴，并优化安装进度反馈与通知稳定性
- 安装体验全面补强：支持长按安装、APK 全选、重复包识别、更丰富的安装详情展示，以及更完善的分包 / XAPK / ZIP 处理
- 大量稳定性修复与底层重构：安装会话、解析链路、导航动画、模块支持、更新流程、设置交互与依赖注入均获得改进
更新内容
新增功能
- 新增：稳定版版本号格式调整为日期式
26.05 - 新增：支持可配置的安装模式，并重构安装模式选择逻辑
- 新增：支持在 Profile 中分别配置“签名不一致”和“未知签名”策略 @4h9fbZ
- 新增：Android 12+ 实验性“无需用户操作安装”选项
- 新增：安装准备界面支持后台安装操作，并补充长按后台安装行为
- 新增：静默更新与后台更新相关流程优化
- 新增：会话安装支持 Android 14+ 安装所有权更新相关处理
- 新增：控制中心磁贴，便于快速进入 InstallerX @7fMeteor
- 新增：小米灵动岛 / 超级岛通知支持，并提供可配置的阻塞间隔
- 新增：安装流程支持直接处理 HTTP / HTTPS 链接
- 新增：长按执行安装、长按复制应用详情，并支持触觉反馈
- 新增：实验性显示安装文件路径与安装发起方
- 新增：APK 选择界面支持“一键全选” @Prslc
- 新增：支持包身份检查机制，以精准识别完全相同的 APK
- 新增：安装分析失败时的通知提示 @HChenX
- 新增：支持 KernelSU 软重启
- 新增：Xposed 检测与快速打开 LSPosed 设置
- 新增：模块图标支持，并补充
webuiIcon相关识别能力 - 新增：可配置 Toast 显示模式
- 新增：更新检查支持 ghproxy，并集中管理更新状态 @hamjin
优化与改进
- UI 重构：大幅升级 Miuix 与 Material 3 Expressive 相关界面结构
- 优化：新增浮动底部导航栏，并完善其配色、内容表现与 Material 3 支持
- 优化：状态卡片加入流体动态背景效果
- 优化：背景特效、模糊渲染与 OS3 风格背景逻辑
- 优化：边到边布局、横屏布局与不同尺寸设备上的界面适配
- 优化：Miuix 安装页动态取色表现
- 优化：安装流程直接基于 Bitmap 进行配色提取
- 优化：安装进度展示与通知构建策略
- 优化：通知样式判断、通知更新频率与通知展示稳定性
- 优化：小米超级岛场景下的图标与通知体验
- 优化：配置解析、安装 Flags 初始化、安装模式状态管理与配置作用域展示
- 优化：模块安装日志区域布局
- 优化：应用图标缓存清理、种子色计算与图标管理逻辑
- 优化：APK / XAPK / ZIP / 分包选择逻辑
- 优化：完善安装与卸载的错误类型分类、修复建议以及本地化文本
- 优化：离线版移除
INTERNET权限 - 优化：后台缓存清理机制，减少手动维护负担
- 优化：安装器内部状态管理、依赖注入、设置交互与服务生命周期处理
- 优化：预测性返回动画行为与通知设置 @AlexLiuDev233
- 优化：支持滑动关闭 Snackbar @AlexLiuDev233
变更
- 变更：版本号命名体系由旧式
v2.x.x调整为日期式26.05 - 变更：安装模式、工作模式、托管安装器包与授权相关逻辑进一步统一
- 变更：部分安装与卸载异常实现统一为更清晰的枚举和标准化错误类型 @AlexLiuDev233
- 变更：主题与配色实现迁移到新的 Color Spec / Material Kolor 方案
- 变更：导航实现重构为基于 Navigation3 的返回栈管理
- 变更：Recycler 与部分服务依赖迁移到 Koin 注入
- 变更：构建链路与依赖栈持续更新，包含 Gradle、AGP、Kotlin、Room、Miuix 与 Material 3 等升级
- 变更：移除文档网站与部署工作流
修复
- 修复：导航返回动画在部分场景下卡住或被打断的问题 @Prslc @AlexLiuDev233
- 修复：主页面返回键在合适场景下返回首页的行为 @Prslc
- 修复：Window Insets 被重复消费导致的布局异常 @youfeng11
- 修复：APatch 检测标记异常及设置页间距问题
- 修复：GitHub 更新通道在未配置自定义地址时的重置逻辑 @hamjin
- 修复：多 APK 场景下安装选择逻辑不够准确的问题
- 修复：小米特定通知与网络清理流程的鲁棒性问题
- 修复：模块图标颜色提取与
webuiIcon支持问题 - 修复：XAPK 解析与安装选择流程中的若干异常
- 修复：分包选择时主包未被正确优先选中的问题
- 修复：某些 APK 资源 ID 为负数时的解析异常 @SoClear
- 修复：主题设置选择弹窗无法滚动的问题
- 修复：Android 13 及以下设备上 InstallerService 可能出现的超时崩溃
- 修复：MixedModuleZip 流程中过早预选 APK 的问题 @Prslc
- 修复：无效 APK 安装失败时的错误提示不准确问题
- 修复：安装准备页与 Miuix 弹窗中的文字颜色和标题显示不一致问题
- 修复：系统应用模式下授权状态异常的问题 @AlexLiuDev233
- 修复：模块安装选择中非模块实体未被正确取消选中的问题
- 修复：“全选 APK” 时的重复选择切换问题
- 修复：若干通知样式判断、更新线程调度与安装后任务参数传递问题
- 修复：Android 11 及以下设备中，背景模糊效果默认开启异常的问题 @Ephemera42
- 修复：Android 11 及以下设备动态取色默认行为问题 @budingxiaocai
- 修复：特定 API 级别下主题设置的可见性异常，并移除过时的模糊提示逻辑 @Ephemera42
- 修复：模块与 APK 混合实体未正确进入批量模式的问题
文档与翻译
- 文档：更新贡献指南、支持版本说明、README 内容与项目状态说明
- 文档：新增
AGENTS.md开发协作说明 - 翻译：感谢所有参与 Hosted Weblate 翻译维护的贡献者，持续完善多语言文本