简单的 LSPatch 使用教程
这只是一个简单的教程
最后更新2022.6.1 17:58 UTC+08:00
-1. FFAQ (Fxxking Frequently Asked Question)
Q0: LSPatch 是什么
A0:
LSPosed框架的免 Root 实现, 通过在目标APK中插入dex等整合Xposed API
Rootless implementation of LSPosed framework, integrating Xposed API by inserting dex and so into the target APK.
Q1: 要 Root 吗
A1: 不要
Q2: 鸿蒙(华为)能用吗
A2: 应该可以
0. 工具与环境
0.1 清单
- 脑子和手
- 运行 Android 9+ 的设备
- 能正常使用的 DocumentsUI(
com.google.android.documentsui或com.android.documentsui) (部分魔改系统可能没有, 如 WSA) (管理器打包需要) - Java 11+ (
命令行打包需要) LSPatch 管理器和lspatch.jar
0.2 获取工具与环境
这篇文章最后更新于2022.6.1 17:58 UTC+08:00, 当前 LSPatch 官方仓库的的最新提交是14bc932
0.2.1 获取 LSPatch
- 前往LSPatch 官方仓库的
Actions页面下载最新构建的Artifacts中的lspatch-debug或lspatch-release(需要登陆 GitHub) - 前往LSPatch 官方仓库的
Release界面下载 - 前往@LSPatchArchives下载
0.2.2 获取 Java 11+ 环境 (命令行打包需要)
(自己解决, 这里不是教怎么配 Java 环境的)
1. 管理器打包
1.0 准备管理器
安装下载的压缩包中的manager-*.apk
目前管理器还有很多功能没有实现, 但这不耽误我们打包
1.1 激活Shizuku(可选)
Shizuku服务用于管理器保活(目前还没实现)和自动安装, 没有问题不大
前往Shizuku 用户指南了解如何使用Shizuku
1.2 选择应用并打包安装
在管理器的管理页面点击右下角+

首次打包需要选择一个目录输出打包好的文件

这里随便选一个 空目录
选择需要 patch 的应用, 可以选择已安装的或文件, 这里以已安装的Bilibili HD 2 (com.duzhaokun123.bilibilihd2) 为例, 点击应用以开始打包

之后会看到这样的界面

可选择本地模式或便携模式, 本地模式需要管理器保活
选择便携模式需要选择要嵌入模块, 点击嵌入模块以选择
可选多个, 选完后点击右下角对勾以继续

最后点击右下角开始修补以打包
等待完成, 点击安装以安装, 安装需要Shizuku服务, 如果没有需要去之前选择的目录手动安装
安装会卸载当前安装的应用, 注意备份

1.3 后续更新
更新应用需要重新打包, 如果是便携模式那么更新模块也需要重新打包
但管理器对已经 patch 过的应用重新打包会出错, 所以建议保留原本应用, 并通过选择文件打包
2. 命令行打包
2.0 准备文件
jar-*.jar(在下载的压缩包中或其他来源中)- 要打包的应用
- 要嵌入的模块 (可选)
2.1 打包
本地模式, 需要运行的设备安装管理器
1 | |
便携模式
1 | |
2.2 安装
输出文件是xx-lv2-lspatched, 自行寻找方法安装
3. FAQ
Q1 更新需要卸载吗
A1: 签名一样就不需要, 为避免签名不同可以自己签名
Q2 管理器修补失败, 提示如图

A2: 管理器目前不能正常处理修补过的应用
重新安装回原版或选择文件再试
Q3 便携模式模块没有正常加载
A4: 启用 可调试 再试
Q3.1: 还是不行
A3.1: 强行停止再试
Q3.2: 还是不行
A3.2: 重启再试
Q4 本地模式模块没有正常加载
A4: 确定你选择了要加载的模块 (管理 -> 被修补应用 -> Modeule scope)
Q4.1: 还是不行
A4.1: 重启再试
Q5 打包的应用无法分享给微信什么的, 提示签名不正确
A5: 因为签名就是和他们预期的不同, 这个无解(除非你能搞到官方签名)
Q6 打开应用闪退, Android 8-
A6: 这个无解, 最低需要 Android 9
Q7 打开应用闪退, Android 9+
A7: 不知道
Q8 本地模式能不能选加载模块
A8: 这个功能从290989b开始添加 之前的版本会默认加载所有模块