简单的 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.

来自LSPatch 官方仓库

Q1: 要 Root 吗

A1: 不要

Q2: 鸿蒙(华为)能用吗

A2: 应该可以

0. 工具与环境

0.1 清单

  • 脑子和手
  • 运行 Android 9+ 的设备
  • 能正常使用的 DocumentsUI(com.google.android.documentsuicom.android.documentsui) (部分魔改系统可能没有, 如 WSA) (管理器打包需要)
  • Java 11+ (命令行打包需要)
  • LSPatch 管理器lspatch.jar

0.2 获取工具与环境

这篇文章最后更新于2022.6.1 17:58 UTC+08:00, 当前 LSPatch 官方仓库的的最新提交是14bc932

0.2.1 获取 LSPatch

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) 为例, 点击应用以开始打包

选文件

之后会看到这样的界面

准备 patch

可选择本地模式便携模式, 本地模式需要管理器保活

选择便携模式需要选择要嵌入模块, 点击嵌入模块以选择

可选多个, 选完后点击右下角对勾以继续

选模块

最后点击右下角开始修补以打包

等待完成, 点击安装以安装, 安装需要Shizuku服务, 如果没有需要去之前选择的目录手动安装

安装会卸载当前安装的应用, 注意备份

完了

1.3 后续更新

更新应用需要重新打包, 如果是便携模式那么更新模块也需要重新打包

但管理器对已经 patch 过的应用重新打包会出错, 所以建议保留原本应用, 并通过选择文件打包

2. 命令行打包

2.0 准备文件

  • jar-*.jar(在下载的压缩包中或其他来源中)
  • 要打包的应用
  • 要嵌入的模块 (可选)

2.1 打包

本地模式, 需要运行的设备安装管理器

1
java -jar jar-*.jar <要打包的.apk> --manager -l 2

便携模式

1
java -jar jar-*.jar <要打包的.apk> [-m <模块1.apk> [-m <模块2.apk> ...]] -l 2

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开始添加 之前的版本会默认加载所有模块


简单的 LSPatch 使用教程
https://blog.o0kam1.pch.pub/2022/05/06/simple-lspatch-guide.html
作者
狼(o0kam1)
发布于
2022年5月6日
许可协议