FolkPatch

English

简体中文

English

简体中文

Appearance

Update FolkPatch

About 813 wordsAbout 3 min

2025-08-17

FolkPatch has three types of updates: Kernel Patch, System Patch (APD), and Manager. When a new version is detected, the WorkingCard on the home page will display the corresponding update prompt.

提示

All three update prompts can be individually suppressed in Settings → General → Update. See Update Settings for details.

Kernel Patch Update

Kernel Patch updates typically involve low-level driver or security fixes.

Trigger: When the Manager detects a new KernelPatch version, the WorkingCard on the home page shows an update prompt.

警告

  • Disable Brick Intercept Modules: Before updating, ensure no "Brick Intercept" KPM modules are installed or enabled, as they may silently block the update.
  • Device Compatibility: Ensure your phone's kernel version is compatible with the new kernel patch.
  • Proceed with Caution: If you do not have the ability to rescue your device (e.g., flashing the original Boot image), please do not update!
  1. Patch Image: Select the corresponding Boot image in the Manager to patch.
  2. Install Patch: Install (flash) the patched image to your device.
  3. Restart Phone: Restart your device for the new kernel patch to take effect.

注意

If the version number remains unchanged after updating, a brick intercept module may be blocking the write. See Can't Upgrade Kernel Patch? for troubleshooting.

Re-patching After OTA Update (A/B Devices)

If your device supports A/B partitions (seamless updates), the system OTA update writes the new system to the inactive slot. After rebooting, the device switches to the new slot, but its Boot image is unpatched — KernelPatch will no longer be active.

FolkPatch provides the Install to Inactive Slot feature to handle this.

When to use: After the OTA update has finished installing, but BEFORE rebooting.

Critical Timing

You MUST use this feature after the OTA update completes but BEFORE rebooting. Once the device reboots into the unpatched new slot, KernelPatch will be inactive and you will need to manually flash the patched Boot image via Fastboot or similar methods.

  1. OTA finishes installing: Wait for the system OTA to finish downloading and installing (do NOT reboot)
  2. Open FolkPatch: Go to the home page, tap Install, select Install to inactive slot (After OTA)
  3. Confirm warning dialog: A confirmation prompt warns that the device will be forced to boot from the inactive slot
  4. Wait for patching to complete: FolkPatch automatically extracts the Boot image from the inactive slot and patches it
  5. Reboot device: After patching completes, reboot — the device will boot from the patched new slot

How it works:

  1. Detects the current active slot (e.g., _a) and calculates the opposite slot (e.g., _b)
  2. Extracts the Boot image from the inactive slot
  3. Patches it with KernelPatch and writes it back
  4. Switches the active boot slot to the patched slot via bootctl
  5. Creates a post_ota.sh boot script to mark boot successful and auto-cleanup

提示

  • This option only appears when Root is available and the device uses A/B partitions
  • After the first successful boot, the system automatically marks the boot as successful and cleans up temporary files
  • If bootctl fails to connect to the Boot HAL, the log will indicate that manual slot switching is needed

System Patch (APD) Update

The System Patch (APD) is an auxiliary component for the Manager. Updates typically include bug fixes or compatibility improvements.

Trigger: When the Manager detects a new APD version, the WorkingCard on the home page shows an update prompt.

How to Update: Click the "Update System Patch" button on the home page or in Settings. No reboot required.

Manager Update

Manager updates primarily bring new features, UI fixes, or user experience optimizations.

Trigger: When the Manager detects a new APK version, the WorkingCard on the home page shows an update prompt.

  1. Install New Version: Directly download and install the new version of FolkPatch Manager APK.
  2. Update System Patch: Open the new Manager and click the "Update System Patch" button on the home page or in Settings to complete the configuration sync.

Suppressing Update Prompts

If you don't want to receive a specific type of update prompt, you can suppress it individually in Settings → General → Update:

SettingDescriptionDefault
Block KernelPatch UpdateSuppress Kernel Patch update promptsOff
Block System Patch (APD) UpdateSuppress System Patch (APD) update promptsOff

Note

Suppressing update prompts may cause you to miss important security fixes. Only enable this when you are sure the current version is stable. See Update & Backup for details.

注意

Before performing any update operations, it is recommended to back up important data and ensure that the original Boot image is backed up just in case.

Copyright Ownership:FolkPatch Team

License under:Attribution 4.0 International (CC-BY-4.0)