更新说明
约 1214 字大约 4 分钟
2025-08-17
FolkPatch 有三种更新类型：内核补丁、系统补丁（APD）和管理器。当检测到新版本时，主页的工作卡片会弹出对应的更新提示。
提示
三种更新都可以在 设置 → 常规 → 更新 中单独屏蔽提示，详见更新设置。
内核补丁更新
内核补丁（KernelPatch）更新通常涉及底层驱动或安全修复。
触发方式：管理器检测到新版本 KernelPatch 后，主页工作卡片弹出更新提示。
警告
- 禁用格机拦截模块：更新前请确保没有安装或启用任何"格机拦截"类 KPM 模块，否则更新会被静默拦截导致失败。
- 确认设备兼容：确保手机内核版本适配新版内核补丁。
- 谨慎操作：如果您没有相关的自救/救砖能力（如刷入原厂 Boot 镜像），请不要轻易更新！
- 修补镜像：在管理器中选择对应的 Boot 镜像进行修补。
- 安装补丁：将修补后的镜像安装（刷入）到设备。
- 重启手机：重启设备以使新的内核补丁生效。
注意
如遇更新后版本号未变化，可能是格机拦截模块阻止了写入。请参考内核补丁升级不了？。
OTA 更新后重新修补（A/B 设备）
如果你的设备支持 A/B 分区（无缝更新），系统 OTA 更新会将新系统写入未激活槽位。OTA 完成重启后，设备会切换到新槽位启动，但新槽位的 Boot 镜像是未修补的，KernelPatch 将失效。
FolkPatch 提供了 安装到未激活槽位 功能来解决此问题。
什么时候使用：OTA 更新下载并安装完成后、重启之前。
关键时机
必须在 OTA 更新完成后、重启之前使用此功能。一旦重启到未修补的新槽位，KernelPatch 将不再生效，你需要通过 Fastboot 等方式手动刷回修补后的 Boot 镜像。
- OTA 完成安装：等待系统 OTA 下载并安装完成（不要重启）
- 打开 FolkPatch：进入主页，点击安装，选择 安装到未激活槽位 (OTA 后)
- 确认警告对话框：系统会弹出确认提示，告知设备将强制切换到未激活槽位启动
- 等待修补完成：FolkPatch 自动提取未激活槽位的 Boot 镜像并修补
- 重启设备：修补完成后重启，设备将从已修补的新槽位启动
工作流程：
- 自动检测当前槽位（如
_a），计算对向槽位（如_b） - 从未激活槽位提取 Boot 镜像
- 使用 KernelPatch 修补该镜像并写回
- 通过
bootctl切换激活槽位到已修补的槽位 - 创建
post_ota.sh开机脚本标记启动成功并自动清理
提示
- 此选项仅在 Root 可用且设备为 A/B 分区时显示
- 重启后首次启动成功时，系统会自动标记启动成功并清理临时文件
- 如果
bootctl连接 Boot HAL 失败，日志中会提示需要手动切换槽位
系统补丁（APD）更新
系统补丁（APD）是管理器运行的辅助组件，更新通常包含功能修复或适配改进。
触发方式：管理器检测到新版本 APD 后，主页工作卡片弹出更新提示。
操作方式：点击主页或设置中的 "更新系统补丁" 按钮即可完成更新，无需重启。
管理器更新
管理器（Manager）更新主要是获取新功能、修复界面问题或优化用户体验。
触发方式：管理器检测到新版本 APK 后，主页工作卡片弹出更新提示。
- 安装新版本：直接下载并安装新版本的 FolkPatch 管理器 APK。
- 更新系统补丁：打开新版管理器，点击主页或设置中的 "更新系统补丁" 按钮以完成配置同步。
屏蔽更新提示
如果你不希望收到某种更新提示，可以在 设置 → 常规 → 更新 中单独屏蔽：
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 屏蔽 KernelPatch 更新 | 不再显示内核补丁更新提示 | 关闭 |
| 屏蔽系统补丁(APD)更新 | 不再显示系统补丁更新提示 | 关闭 |
注意
屏蔽更新提示可能导致错过重要的安全修复，请仅在确认当前版本稳定时开启。详细说明请参阅更新与备份。
注意
在进行任何更新操作之前，建议先备份重要数据，并确保原始的 Boot 镜像已备份，以防万一。
版权所有
版权归属：FolkPatch Team