LSPosed

LSPosed v2.2.1 从本次更新开始，安装包使用 XZ 压缩以减小体积，2024 年 8 月后的所有 root 实现均已支持 XZ 压缩方式。 Starting with this update, installation packages use XZ compression to reduce their size. All root implementations released after August 2024 support XZ compression.

新增 - 恢复提供 riscv64 ABI 支持 - 支持 Android 17 QPR 3 - 提升 KernelSU 最低管理器版本要求到 1.0.1 - 新增开发者模式与命令行工具 lspctl，支持管理模块及作用域等功能 - 新增禁用安全模式的选项 - 新增横移返回手势开关 改进 - 大幅优化调用链性能，钩子执行成本约 27x speedup - 优化框架启动和模块运行性能，降低日志记录开销 - 优化安全模式判定，更准确地识别系统界面反复崩溃，减少误触发 - 优化页面切换动画与悬浮底栏交互，支持记忆侧边导航栏的展开状态 - 改善恢复备份时的文件选择兼容性 - 优化安装包压缩，更新多语言文案 修复 - 修复一系列 UI 问题 - 修复部分荣耀设备上的框架启动问题 - 修复部分模拟器及 32 位应用兼容环境中的运行和模块加载问题 - 修复部分场景下模块重复加载、模块信息更新不及时的问题 - 修复部分模块共存时的冲突，以及模块运行过程中可能出现的失效或崩溃 - 修复长日志处理异常和部分安装包解压兼容性问题 - 修复 XposedHelpers 字段写入时部分基本类型拓宽转换失败的问题，包括 char 转 int、long 转 float 等

Added - Restored riscv64 ABI support - Added support for Android 17 QPR 3 - Raised the minimum manager version requirement of KernelSU to 1.0.1 - Added developer mode and CLI tool lspctl, with support for managing modules, scopes, etc - Added a toggle to disable safe mode - Added a toggle for the swipe-back gesture Improved - Significantly optimize call chain performance, with 27x speedup on hook execution cost - Optimized framework startup and module runtime performance, reducing logging overhead - Optimized safe mode detection, more accurately identifying repeated System UI crashes and reducing false triggers - Optimized page transition animations and floating bottom bar interactions, with support for remembering the expanded state of the side navigation bar - Improved file selection compatibility when restoring backups - Optimized package compression, updated multilingual copy Fixed - Fixed a series of UI issues - Fixed framework startup issues on some Honor devices - Fixed runtime and module loading issues in some emulators and 32-bit app compatibility environments - Fixed issues with modules being loaded repeatedly and module information not being updated promptly in some scenarios - Fixed conflicts when some modules coexist, as well as possible failures or crashes during module runtime - Fixed issues with long log processing errors and compatibility when extracting some packages - Fixed failures in widening conversions for some primitive types when writing fields with XposedHelpers, including char to int、long to float etc.

The libxposed organization has been flagged by GitHub, to access the source code or java doc, you can download the relevant files from the Maven Central Repository. libxposed 组织已被 GitHub 封锁，如需查阅源代码或文档，可在 maven 中央仓库下载相关文件。 https://repo.maven.apache.org/maven2/io/github/libxposed

libxposed future proposal: DexSQL DexSQL lets you query Android DEX files with SQL, it replaces the DexParser that was deprecated in libxposed API 100. It is now available for early access—feedback on slow or failing SQL statements is welcome. libxposed 新功能提案：DexSQL DexSQL 允许使用 SQL 语句查询 Android DEX 文件结构，它取代了libxposed API 100 中被废弃的DexParser。 现在可以抢先试用，欢迎反馈缓慢或者失败的SQL语句。 https://dexsql.lsposed.org/

Due to the increasing prevalence of AI and the accelerated submission of new modules, we plan to upgrade our module repository to an automated approval mode. Following the approach of the Maven Central Repository, submitters will need to prove they control the domain name to which the module package name belongs. If there is no domain name, you can use io.github.[user name].[module name], which will automatically approve the submission. Other package names will generally not be approved. This rule only applies to the approval of new modules and does not extend to existing modules, but we will begin checking whether the repository package name matches the released APK file. 由于AI普及，新模块提交加速，我们计划把模块仓库升级为自动审批模式。 仿照 Maven 中央仓库做法，提交者需要证明能控制模块包名所属的域名。如果没有域名，可以使用io.github.[user name].[module name]，它会自动审批通过。其它包名原则上不会被批准。 该规则仅针对新模块审批，不溯及已有模块，但我们将开始检查仓库包名与发布的apk文件不符的情况。

v2.2.0

重要 - New XSharedPreferences 计划于 2.3.0 正式移除，模块页面已为有兼容风险的模块加入废弃警告。判断逻辑为 legacy 模块声明支持 nsp 并存在 others 可读 xml。升级到 libxposed 或将 xposedminversion 设置为 82 并删除 xposedsharedprefs 以移除警告。 新增 - 支持注入 HyperOS Runtime 应用（需要 ZN） - 在 A17 及以上以注入方式处理 dex2oat 包装器，避免挂载泄漏（需要 ZN） 改进 - 提升多进程应用中模块服务连接的稳定性 - 优化管理器中的兼容性状态展示与异常提示 修复 - 修复资源 Hook XML 重写长期失效的问题 - 修复模块热重载失败后可能产生状态异常的问题 - 修复 Hook 链调用及参数类型转换问题 - 修复系统框架在模块作用域中的排序 - 修复安全模式计数未在正常启动后重置的问题 - 修复 Dex 混淆及模块服务相关的内存泄漏

Important - New XSharedPreferences is scheduled for official removal in version 2.3.0. Deprecation warnings have been added to the module page for modules at risk of compatibility issues. The probe logic identifies legacy modules that declare support for nsp and contain an XML file with others readable permission. To eliminate the warning, upgrade to libxposed or set xposedminversion to 82 and remove xposedsharedprefs. Added - Support for injecting into HyperOS Runtime apps (requires ZN) - Handles the dex2oat wrapper via injection on A17 and above to prevent mount leaks (requires ZN) Improved - Improved stability of module service connections in multi-process apps - Optimized the display of compatibility status and error prompts in the Manager Fixed - Fixed an issue where resource hook XML rewriting had been failing for an extended period - Fixed an issue where a status exception might occur after a module hot reload failed - Fixed issues with hook chain calls and parameter type conversions - Fixed the sorting of the system framework within the module scope - Fixed an issue where the safe mode count was not reset after a normal startup - Fixed memory leaks related to DEX obfuscation and module services

我们在 Android 17.0 中发现了一个特权进程任意代码执行漏洞。该漏洞已在 Android 17 QPR1 中修复，但 AOSP 安全公告中并未提及。结合 dirty frag 漏洞（CVE-2026-43284），我们在 Android 17.0 上成功实现了完整的 root 权限提升。 这是一个典型的 1day 漏洞。尽管补丁已发布，但用户无法获得漏洞修复，因此仍面临被攻击的风险：任何人都可以通过对比分析发现该漏洞的细节。而 dirty frag 漏洞虽已于三个月前披露，但至今仍可被利用。这是因为谷歌推迟了漏洞补丁的发布频率，将安全公告从每月一次改为每季度一次。在 AI 时代，这种做法不可理喻。由于 Pixel 系统镜像中泄露的漏洞细节，Android 生态中的大量设备都容易受到攻击，未参与 Beta 测试计划的 Pixel 设备也无法幸免。 因此，我们利用两个“已经”修复过的漏洞，演示了对安装有最新安全补丁的 CP2A.260705.006 稳定版系统 Google Pixel 10 设备获取 root 权限的操作，以此作为警示，敦促 Google 改变其做法并及时发布漏洞补丁。

We discovered a privileged process arbitrary code execution vulnerability in Android 17. This vulnerability was patched in Android 17 QPR1 but was not included in any security bulletin. Combined with the dirty frag vulnerability (CVE-2026-43284), we achieved full root privilege escalation on Android 17.0. The DirtyFrag vulnerability was disclosed 3 months ago but is still exploitabe, because Google has delayed the release frequency of vulnerability patches, changing from monthly to quarterly security bulletins. In the AI ​​era, this behavior is completely incomprehensible. A large number of devices in the Android ecosystem are vulnerable to attacks due to the vulnerability details leaked in the Pixel system; even Pixel devices not participating in the beta program are not immune. Therefore, we used two "already patched" vulnerabilities to demonstrate full rooting on Google Pixel 10 with the latest patches as a warning, urging Google to change its practices and release vulnerability patches promptly.

v2.1.1

新增 - 最低支持版本提升至 Android 9（API 28） - 高级隐藏功能现可支持 A12+ - 允许一键清空已选作用域 改进 - 优化安全模式对 System UI 的检测阈值 - 恢复管理器中的模块数量徽标 - 改进错误报告发送流程 修复 - 修复部分情况下无法启动守护进程的问题 - 修复 XposedHelpers.findField API 行为 - 修复 Android 17 下服务连接接口不兼容的问题 - 修复模块详情页弹出菜单显示层级异常的问题 - 修复 Markdown 样式在部分页面中显示异常的问题 Added - Raised the minimum supported version to Android 9 (API 28) - Advanced hiding is now supported on Android 12 and above - Added an option to clear all selected scope apps Improved - Optimized the System UI detection threshold in safe mode - Restored the module count badge in the manager - Improved the error report submission process Fixed - Fixed an issue that could prevent the daemon from starting - Fixed the behavior of the XposedHelpers.findField API - Fixed service connection incompatibility on Android 17 - Fixed incorrect popup menu layering on the module details page - Fixed Markdown styles being displayed incorrectly on some pages

v2.1.1

新增 - 最低支持版本提升至 Android 9（API 28） - 高级隐藏功能现可支持 A12+ - 允许一键清空已选作用域 改进 - 优化安全模式对 System UI 的检测阈值 - 恢复管理器中的模块数量徽标 - 改进错误报告发送流程 修复 - 修复部分情况下无法启动守护进程的问题 - 修复 XposedHelpers.findField API 行为 - 修复 Android 17 下服务连接接口不兼容的问题 - 修复模块详情页弹出菜单显示层级异常的问题 - 修复 Markdown 样式在部分页面中显示异常的问题 Added - Raised the minimum supported version to Android 9 (API 28) - Advanced hiding is now supported on Android 12 and above - Added an option to clear all selected scope apps Improved - Optimized the System UI detection threshold in safe mode - Restored the module count badge in the manager - Improved the error report submission process Fixed - Fixed an issue that could prevent the daemon from starting - Fixed the behavior of the XposedHelpers.findField API - Fixed service connection incompatibility on Android 17 - Fixed incorrect popup menu layering on the module details page - Fixed Markdown styles being displayed incorrectly on some pages

Successfully root my K90PM using CVE-2026-43499

v2.1.0 新增 实现 libxposed API 102 适配 Android 17 QPR1 Beta 4 维护 原计划 2.1.0 废弃 New XSharedPreferences 推迟到 2.2.0，强烈建议 legacy 模块尽快迁移到 libxposed 今后可向 report@bug.lsposed.org 发送反馈邮件 改进 大幅提升被 hook 方法的性能 优化还原内联钩子逻辑 优化 dex 优化器包装的挂载逻辑 优化一系列的 UI 体验 修复 修复 XposedBridge.unhookMethod 行为异常 修复了一个全局检测点 修复 TalkBack 重复朗读、未朗读勾选状态等无障碍问题 Added Implemented libxposed API 102 Adapted for Android 17 QPR1 Beta 4 Maintaince Postponed the planned deprecation of New XSharedPreferences in version 2.1.0 to 2.2.0. We strongly recommend migrating legacy modules to libxposed as soon as possible Feedback is now available by emailing to report@bug.lsposed.org Improved Significantly improved the performance of hooked methods Optimized invalidate inline hooks logic Optimized the mount logic of dex optimizer wrapper Optimized a range of UI experiences Fixed Fixed abnormal behavior of XposedBridge.unhookMethod Fixed a global detection point Fixed accessibility issues such as TalkBack repeating text and failing to read checked items https://lsposed.zip

libxposed API 102 is now under RFC. Please give us suggestions regarding the API design. https://github.com/libxposed/api/pull/62

libxposed API 102 snapshots are now available. Open an issue on GitHub if you have any suggestion. Usage: add snapshot maven to settings.gradle.kts

maven {
    url = uri("https://central.sonatype.com/repository/maven-snapshots/")
    mavenContent {
        snapshotsOnly()
    }
    content {
        includeGroup("io.github.libxposed")
    }
}

Use snapshot builds:

compileOnly("io.github.libxposed:api:102.0.0-SNAPSHOT")
implementation("io.github.libxposed:service:102.0.0-SNAPSHOT")

kind reminder: you can also use lsposed.zip to download the latest public lsposed.