Update
Normal APatch update
INFO
You can update directly in the app.
- Download the new version of APatch Manager
Please re-confirm the SuperKey if necessary.
Click the button in the upper right hand corner
Select
Patch and install
OTA update with APatch retention
TIP
Keep the OTA root update of APatch consistent with Magisk.
Download and start installing the OTA update through your ROM's software
After the OTA update installation is complete (when prompted to reboot), open APatch Manager and click the button in the upper right hand corner
Select
Install to inactive slot (After OTA)
WARNING
The OTA update functionality is currently unstable and may cause issues. If an issue occurs, go to the APatch repository on GitHub to submit an issue.
PAY ATTENTION
For MIUI/Xiaomi HyperOS users, pay attention to the following points:
Different from Magisk/KernelSU, APatch currently won't automatically back up the stock boot.img when patching it. If you haven't manually restored the stock boot.img before a system update, the check will fail, and you will be forced to use a full ROM to complete the update process.
If you're using MIUI/Xiaomi HyperOS (especially Dev Edition), we recommend that restoring stock boot.img manually before system update.
Miscellaneous
INFO
This document was last updated on 2024-05-18 at 22:30. Caution should be exercised when accessing the contents of this page if the time difference from the present is too great.
The content described in this document is based on the latest version of APatch Manager. If you cannot find the buttons mentioned in this document, it means that the version of your APatch Manager is too old.
WARNING
Older versions are no longer supported and may pose a risk of compromising the SuperKey.
In some major updates, newer versions of KernelPatch may not be compatible with older versions, causing loss of root after the update. If such an incompatibility occurs, it will be specifically mentioned in the release notes. If this happens, we recommend that you redo the installation steps using the stock boot.img.
There are a very small number of cases where OTA slot switching doesn't work. The sample is too small to determine the exact cause of the issue. If this happens, reinstall the app manually. Additionally, if you want, you can report the issue and attach logs on the Issues page on GitHub.
We need your help.