FolkPatch

English

简体中文

English

简体中文

Appearance

FAQ

About 552 wordsAbout 2 min

2025-12-23

Common Questions from New Users

Newbie

My phone is bricked after flashing! I'm panicking 😱

Don't panic! This is common. Just enter Fastboot mode and flash back the original Boot image. If that doesn't work, flash the complete firmware.

Newbie

Why does my device say unsupported? 😤

Most likely your kernel doesn't support KernelPatch. Check if your kernel version is within 3.18 - 6.15+ and has CONFIG_KALLSYMS=y.

Newbie

My superuser path changed to kp, what should I do? 💀

It's caused by other ROOT solution remnants in the environment. Clean up conflicting files in /data/adb, restart, then reset the su path.

What if the phone fails to boot after flashing?

Don't panic! This is common and usually solvable:

  1. Enter Fastboot Mode:

    • After turning off, press and hold Power + Volume Down (may vary by phone)
    • Or use command: adb reboot bootloader

  2. Flash back original Boot image:

    fastboot flash boot PATH/TO/original_boot.img
fastboot reboot

  3. If it still doesn't work:

    • Flash the complete official firmware package
    • Seek community help, providing your phone model and error information

For detailed rescue methods, please refer to Rescue Guide.

Why is my device unsupported?

Possible reasons:

  • Kernel version is not in supported range (3.18 - 6.15+)
  • Architecture is not ARM64
  • Kernel configuration does not meet requirements (requires CONFIG_KALLSYMS=y)
  • Specially customized device system

重要

Most cases of unavailability can be attributed to your kernel not supporting KernelPatch.

KernelPatch requires CONFIG_KALLSYMS=y to work properly. You can compile the kernel yourself or find a kernel compiled by others to get support.

What if errors occur during patching?

  1. Confirm Boot image is intact: Re-acquire the original Boot image
  2. Check tool version: Use the latest version of FolkPatch Manager
  3. Try manual patching: Use KernelPatch tools to patch manually
  4. Check community resources: Search for special tutorials for your device model

KPM module causes FolkPatch to lose Root permissions after embedding

Some KPM modules may be incompatible with the current kernel or KernelPatch version after embedding, causing the Root authorization mechanism to malfunction, manifesting as FolkPatch being unable to properly grant superuser permissions.

注

For all KPM modules, it is recommended to prioritize loading to ensure it works properly, and then use embedding after confirming it is correct.

More Help

If you encounter problems not solved in the documentation, you can:

  • Visit FolkPatch official GitHub page
  • Search relevant forums and communities
  • Join relevant QQ groups or Telegram groups for real-time help

Log Export

Export detailed application running logs for problem diagnosis and error reporting.

Function Description:

  • Collect app running logs, kernel logs, system information
  • Package as .tar.gz compressed file
  • Can be sent to developers via share button

Usage:

  1. Go to Settings → General
  2. Click Send Log
  3. Select save location (using system file picker)
  4. Wait for log collection and compression to complete
  5. Share or save log file

Log Content:

  • Application log (logcat)
  • FolkPatch kernel log
  • System property information
  • Device information
  • Installed module list
  1. Reproduce the problem first
  2. Export log immediately
  3. Upload log file in GitHub Issue
  4. Describe problem reproduction steps in detail

Copyright Ownership:FolkPatch Team

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