APatch - GitHub

注意!APatch已有官方文档!该页面已停止维护。 前往APatch文档


前言

APatch是一款由bmax121开发的新的root工具,提供类似于KernelSU的内核级别root与类似于Magisk模块功能。

此外,APatch拥有一个正在开发的功能:KPM-KernelPatchModule,通过模块hook内核,在内核启动时注入任意代码。

讨论群组:

Telegram EN群组: @APatchGroup
Telegram CN群组: @APatch_CN_Group

只有这两个官方群组!任何其他群组都不是官方的群组!

特别点名 APatch中文网

APatch还处于初步开发期,会出现包括但不限于app崩溃、撤回release等操作。

使用前请保证你已备份你的数据!

尽可能将APatch管理器的语言设置为英语!其他语言有可能会导致app崩溃! Update: Fixed.

安装前提

确保你的内核开了以下依赖:

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=y
DEBUG_KERNEL=y

你可以使用下面的命令来检查:

su -c "zcat /proc/config.gz" | grep KALLSYMS
su -c "zcat /proc/config.gz" | grep DEBUG_KERNEL

确保它们的值都为y

安装

修补

  • 点击app主页左上角的按钮,并给你之后将要刷入的内核创建一个密码,即Superkey

Superkey 是什么?

  • 接下来选择要修补的boot文件。

修补后,如果无误,修补过的boot镜像将会保存在/storage/emulated/0/Download/apatch-{VERSIONCODE}-{随机字母}-boot.img

刷入

  • 使用任意的分区刷写软件将修补过的boot镜像刷入boot分区。

这里使用fastboot做例子:
先将修补过的boot复制到用来执行fastboot操作的设备上,随后使用下面的命令刷入boot镜像:

fastboot flash boot {修补过的boot镜像路径}

随后重启你的设备。

请确保设备已正确连接到用来执行fastboot的设备!

你也可以使用其他的分区刷写软件,甚至可以在开机状态下使用分区刷写app刷写noot分区。

激活

还记得之前的superkey吗?重启后点击Superkey/超级密钥并输入你先前在修补内核时输入的superkey。
确认后你就可以正式的开始使用APatch了。

升级

从GitHub下载更新的release,在app内重新修补并刷入。

请确保使用没有使用APatch修补过的boot镜像

常见问题

LSPosed不工作

这通常是因为ZygiskNext未安装或未正常工作导致的。

使用一抹清酒修改的ZygiskNext或者官方ZygiskNext。

ZygiskNext - GitHub@Admirepowered

模块不生效

模块不兼容APatch。APatch不承担相应的修复责任。

APP在输入superkey时崩溃

将APP语言改为英语。

Update: 应该已修复。

root授权界面加载不出app/一直转圈

在系统设置里给予APatch读取已安装应用列表权限。如果找不到相关权限管理,请自行搜索AppOps管理。

Shamiko不工作

请使用Shamiko 0.7.4。更新的版本不支持APatch。


一键脚本安装

由我使用shell编写,目前推荐在Termux中运行。
链接: AtopesSayuri/APatchAutoPatchTool

Update: 该项目已归档,完成了它的使命。