FolkPatch

简体中文

English

简体中文

English

外观

安装/使用

约 2183 字大约 7 分钟

2025-08-16

🎯 本指南将帮助您从零开始安装和使用 FolkPatch，即使您是刷机小白也能轻松上手！

🔍 基础知识

什么是 FolkPatch？

FolkPatch是Apatch的分支，专注于优化界面设计和功能扩展，并不会引入新的核心功能

🛠️ 准备工作

  • 一台已解锁Bootloader的手机
  • 一台拥有Adb工具的电脑
  • 你的手机内核支持KernelPatch

📱 检查设备兼容性

支持的设备类型

✅ 支持设备条件：

  • ARM64 架构（近年的安卓手机基本都支持）
  • Android 内核版本 3.18 - 6.6

❌ 不支持设备：

  • 非 ARM64 架构设备（部分老旧平板）
  • 内核版本低于 3.18 或高于 6.6

如何检查内核版本？

  1. 方法一：手机设置查看

    • 设置 → 关于手机 → 软件信息 → 内核版本

  2. 方法二：使用 ADB 命令

    adb shell uname -r

如何检查内核配置（需已有 Root 权限）

如果您的手机已经 Root，可以使用以下命令检查内核配置：

zcat /proc/config.gz | grep CONFIG_KALLSYMS

应显示：

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=y

或

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=n

提示

如果显示上面任一配置，说明您的设备支持 FolkPatch。

📁 获取必要文件

获取 Boot 镜像

  1. 从官方固件包获取

    • 下载对应您手机型号的官方固件
    • 解压后找到 boot.img 文件
    • 复制到电脑上备用

  2. 从当前设备提取

    # 需要有 ADB 权限
adb pull /dev/block/by-name/boot ./boot.img

备份 Boot 镜像

重要

务必备份原始的 boot.img 镜像！

这份文件是恢复系统的重要保障，如果出现无法启动等问题需要用它来修复手机！

🚀 安装 FolkPatch

方法一：官方工具一键刷入（强烈推荐）

这是目前最便捷的安装方式，FolkTool 官方工具支持一键刷入，无需复杂操作。

详细图文教程请参考：FolkTool 使用指南

  1. 下载工具：访问 FolkTool 发布页 下载最新版本的工具。
  2. 连接设备：确保您的手机已开启 USB 调试并连接到电脑。
  3. 一键刷入：运行工具并按照界面提示操作即可自动完成刷入。

方法二：自动修补（推荐新手使用）

这是最简单、最安全的方法，适合绝大多数用户。

步骤 1：安装 FolkPatch 管理器

  1. 在手机上下载并安装 FolkPatch 管理器 APK
  2. 允许"安装来自未知来源的应用"

步骤 2：修补 Boot 镜像

  1. 打开 FolkPatch 管理器
  2. 点击右上角的修补按钮 🛠️
  3. 选择"选择一个启动镜像并修补"
  4. 找到并选择您准备好的 boot.img 文件

使用本地补丁文件(KPimg)

在安装页的 KernelPatch修补/安装 菜单下，有一个 「使用本地补丁文件(KPimg)」 选项。点击后可选择自定义的 kpimg-android 文件进行修补，后续流程与正常修补一致。

此功能适用于需要使用特定版本 KernelPatch 补丁的场景，kpimg-android 文件需自行从 KernelPatch 发布页 下载，FolkPatch 本身不自带此文件。

步骤 3：设置Superkey

  1. 在"超级密钥"卡片中设置一个密码
  2. 这将是您获取 Root 权限的密码，请务必记住！
  3. ⚠️ 禁止使用弱密码（如 12345678），系统会要求设置复杂密码

注意

请务必牢记您的 Superkey ，这将会确保您对于 Root 权限的控制权

步骤 4：完成修补

  1. 点击"开始修补"并等待完成
  2. 修补成功后会显示修补后的镜像路径，例如： /storage/emulated/0/Download/folkpatch_xxxx.img

继续阅读下方的"刷入镜像"部分完成安装。

方法三：手动修补（适合高级用户）

当 KernelPatch 更新后，管理器还未更新时，可以使用此方法。

步骤 1：下载工具

  1. 访问 KernelPatch 发布页
  2. 下载以下文件：
    • kptools-win.zip（Windows 用户）或 kptools-linux（Linux 用户）
    • kpimg-android
    • magiskboot（对应系统版本）

步骤 2：解包 Boot 镜像

# Windows 用户
magiskboot.exe unpack boot.img

# Linux 用户
./magiskboot unpack boot.img

步骤 3：修补内核

# Windows 用户
kptools-x86_64-win.exe -p --image kernel-b --skey "YourKey" --kpimg kpimg-android --out kernel

# Linux 用户
./kptools-linux -p --image kernel-b --skey "YourKey" --kpimg kpimg-android --out kernel

步骤 4：重新打包

# Windows 用户
magiskboot.exe repack boot.img

# Linux 用户
./magiskboot repack boot.img

完成后，您会得到一个名为 new-boot.img 的文件，这就是修补好的镜像。

替代方案

您也可以使用 在线修补工具，只需上传 Boot 镜像即可自动完成修补。

方法四：直接刷入（通过 Recovery）

最新版本的 FolkPatch 支持从 TWRP 等第三方 Recovery 一键刷入。

注意

此功能于版本 11142 引入，更早的版本不支持这种方式。

步骤 1：重命名安装包

将下载的 FolkPatch 安装包（.apk）后缀改为 .zip，例如：

FolkPatch-11142-release.apk → FolkPatch-11142-release.zip

步骤 2：通过 Recovery 刷入

  1. 将手机进入第三方 Recovery（如 TWRP）
  2. 选择"安装"或"Install"功能
  3. 浏览并选择重命名后的 .zip 文件
  4. 滑动确认刷入，等待完成

提示

第三方类原生 ROM 的 Recovery（例如 LineageOS）所使用的 adb sideload 方法也支持。

重要提醒

自动刷入不会使用固定的超级密钥！

使用此方式刷入后，超级密钥为随机数字 + 字母的组合，会在修补过程中显示。请务必记下这个密钥！

如果您需要自定义自己的超级密钥，请在开机后手动进入 FolkPatch 管理器并重新修补，以此设置您自己的超级密钥。

📲 刷入镜像（适用于方法二和方法三）

准备工作

  1. 确保手机已开启 USB 调试
  2. 将修补后的镜像复制到电脑上
  3. 连接手机和电脑

开始刷入

步骤 1：进入 Fastboot 模式

adb reboot bootloader

步骤 2：刷入修补后的镜像

# 替换 PATH/TO/boot.img 为您修补后的镜像实际路径
fastboot flash boot PATH/TO/boot.img

步骤 3：重启设备

fastboot reboot

小技巧

如果您不确定刷入是否成功，可以先使用以下命令临时启动：

fastboot boot PATH/TO/boot.img

这样如果系统无法正常启动，只需重启手机即可恢复原状。

✅ 安装后操作

验证 Root 权限

  1. 安装 Root 权限检测应用（如 Root Checker）
  2. 打开应用并检查是否显示"Root 权限已获取"

使用 Root 应用

  1. 打开需要 Root 权限的应用
  2. FolkPatch 会弹出权限请求
  3. 选择"允许"并输入您的超级密钥

安装模块支持

  1. 打开 FolkPatch 管理器
  2. 进入"模块"页面
  3. 可以下载并安装各种功能模块

使用模块脚本

许多模块包含自动执行的脚本，可以在系统启动时自动完成特定任务：

  • service.sh - 在系统启动后期执行，适合大多数场景
  • post-fs-data.sh - 在文件系统挂载后执行（阻塞式，谨慎使用）
  • boot-completed.sh - 在系统启动完成后执行

查看和管理脚本的方法：

  1. 查看脚本：进入模块详情页面，点击"浏览模块文件"
  2. 执行 Action：如果模块支持，点击"执行 Action"按钮运行特定脚本
  3. 日志查看：脚本日志通常保存在 /data/local/tmp/ 目录

学习更多：

🗑️ 卸载 FolkPatch

方法一：使用 FolkPatch 管理器卸载

  1. 下载与您当前版本相同的 FolkPatch 安装包
  2. 将文件重命名，添加 -uninstall，例如： FolkPatch-10888-release.apk → FolkPatch-10888-release-uninstall.zip
  3. 将文件传入手机，通过 Recovery 刷入即可

提示

同样的，和安装一样，卸载也支持使用 adb sideload。

方法二：手动刷回原 Boot 镜像

  1. 让手机进入 Fastboot 模式：

    adb reboot bootloader

  2. 刷回您之前备份的原厂 Boot 镜像：

    fastboot flash boot PATH/TO/original_boot.img

  3. 重启手机：

    fastboot reboot

重要提醒

绝对不要刷入 init_boot 文件，只会导致系统无法启动！

🎉 完成

恭喜！您已经成功安装了 FolkPatch。现在您可以自由探索 Android 系统的更多可能性了！

记得遵守"安全刷机"的原则：

  • 只安装来源可靠的应用和模块
  • 定期备份重要数据
  • 不要随意修改系统关键文件

享受您的 Root 之旅！🚀

部分资料引用APatch文档

版权归属：FolkPatch Team

许可证：署名 4.0 国际 (CC-BY-4.0)