FAQ

What is APatch?

INFO

Here is a more complete introduction.

APatch is a root solution similar to Magisk or KernelSU which is one of the best of both. It combines Magisk easy and convenient installation method via boot.img with KernelSU powerful kernel patching abilities.

What is the difference of APatch and Magisk?

Magisk modifies the init system with a patch to the ramdisk of your boot image. APatch patches the kernel directly.

What is the difference of APatch and KernelSU?

KernelSU requires your device's kernel source code, which is not always provided by the OEM. APatch only need your stock boot.img.

What is the difference of APatch, Magisk and KernelSU?

APatch allows you to optionally not modify SELinux, this means the app thread can be rooted without libsu and IPC.

KPModule provided.

What is KPModule?

KPM is a module that runs in kernel space and allows code to execute in kernel space, similar to Loadable Kernel Modules (LKM).

Additionally, the KPM provides the ability to execute inline-hook and syscall-table-hook in kernel space.

Please read How to write KPM for more information.

What is the relationship of APatch and KernelPatch?

APatch relies on KernelPatch. It inherits all of its capabilities and has been expanded.

You can install just KernelPatch, but this does not allow you to use APM.

Learn more about KernelPatch.

What is SuperKey？

KernelPatch adds a new system call (syscall) to provide all capabilities to apps and programs in userspace, this syscall is referred to as SuperCall. When an app/program tries to invoke SuperCall, it needs to provide an access credential, known as the SuperKey. SuperCall can only be successfully invoked if the SuperKey is correct and if it's not the caller will remain unaffected.

How to process the SELinux?

KernelPatch not modify the SELinux context but bypasses SELinux via hook. This allows you to root an Android thread within the app context without the need to use libsu to start a new process and then perform IPC.

In addition, APatch uses the magiskpolicy to add addition support of SELinux directly.

WebUI of APM/KPM

The APatch source code has been derived and modified from KernelSU, so APatch introduced WebUI feature in version 10568 after KernelSU introduced WebUI feature.

APatch WebUI implementation and requirements is completely same as KernelSU, WebUI designed for KernelSU modules can run perfectly in APatch.

If you want to design WebUI for APM or KPM, please refer to the WebUI introduction of KernelSU for further information.

Can not install modules (os error 2/5/22)?

Remove the root permission of "Shell" app in SuperUser page.

App granted/lost root permission automatically when rebooting device?

Read this for more details.

Can I use LSPosed?

LSPosed relies on Riru or Zygisk to run, but APatch does not support Riru or Zygisk by default, so you can not use LSPosed directly.

However, APatch can add the Zygisk support or allow LSPosed run without any Zygisk implementation enabled by installing APMs.

Here are two solutions about running LSPosed on APatch:

1. Refer to Zygisk support? part to add the Zygisk support.
2. If you only need to use LSPosed without other Zygisk features, you can try Zloader for LSPosed to load LSPosed simply.

WARNING

Zloader is NOT compatible with any Zygisk implementation, for example, ZygiskNext or Zygisk_mod, and you can not use any APMs depend on Zygisk either. Please disable or uninstall any Zygisk implementation before using Zloader.

INFO

Zloader is still in early development. Feel free to submit Pull requests to the Zloader developers or open an issue for any usage issues.

Can not use Shamiko?

We can not support Shamiko due to its proprietary and no updates.

DANGER

Any issues caused by using Shamiko will not be supported by APatch developers, use as your own risk.

Zygisk support?

Same as KernelSU, APatch does not have built-in Zygisk support.

APatch can use the ZygiskNext to add the Zygisk support.

APatch can also use the Zygisk_mod to add the Zygisk support.

APatch can also use the ReZygisk to add the Zygisk support.

INFO

ReZygisk is still in early development. Feel free to submit Pull requests to the ReZygisk developers or open an issue for any usage issues.

Can not pass the root-detecting app?

If your software is working properly, don't worry too much about the detection software.