普通版本升级 — 管理器内更新的完整流程
两种东西要分别升级
APatch 安装后有两个组件需要关注版本:
| 组件 | 存储位置 | 更新方式 |
|---|---|---|
| APatch 管理器(App) | /data/app/ | 下载新 APK 直接安装 |
| 内核补丁(KernelPatch) | 嵌入在 boot.img 里 | 重新修补 boot.img 并刷入 |
更新管理器不等于更新内核补丁。管理器可以直接装新版,但内核补丁还是旧的——要让内核补丁也升级,必须重新修补 boot 并刷入。
步骤一:更新管理器 App
通常直接在 App 内就能更新:
- 打开设置面板
- 点击"检查更新"(或自动会弹出更新提示)
- 下载新版本 APK
- 安装(Android 可能会弹出"未知来源应用"警告,允许即可)
或者手动去 GitHub Releases 下载最新 APK,侧载安装。
步骤二(可选):更新内核补丁
如果新版管理器携带了更新的 KernelPatch 框架,你还需要:
- 用新版管理器重新修补原厂 boot.img(不是修补已经修补过的!)
- fastboot flash boot 刷入新的修补产物
- 重启设备,在管理器里重新验证 SuperKey
为什么要重新修补而不是直接刷入旧的修补产物?因为新版 KernelPatch 可能包含:
- 新内核版本的兼容性支持
- 安全漏洞修复
- inline-hook / syscall-hook 的性能改善
- KPM 加载机制的变更
版本兼容的坑
KernelPatch 版本不兼容
重要:在一些重大版本更新中,新版本的 KernelPatch 会与旧版不兼容,导致升级后丢失 root 权限。
官方会在发布信息里特别说明这种情况。遇到了就从原厂 boot 重新修补安装——正常的修补流程不受影响。
SuperKey 机制变更
在 11090 左右的版本,SuperKey 机制从强制 SuperKey 认证改为验证管理器签名。从旧版升级时:
- 必须先升级到一个特定的过渡版本(GitHub Actions 上有)
- 再从过渡版本升级到最新版
- 跳过过渡可能导致卡开机或 root 丢失
OTA 安全提示
普通版本升级(只更新管理器 App)对 OTA 没影响。但如果系统要做 OTA 更新,需要参考专门的 OTA 保 root 章节处理。
什么情况下需要两者都升级
- 官方发布信息里明确说 KernelPatch 更新了(比如支持了新内核版本、修了安全漏洞)
- 遇到某个内核级的问题需要 KernelPatch 修复
- 想确保最完整的兼容性
什么情况下只更新管理器 App 就够了:
- 管理器本身有 bug 修复(比如 UI 改进、设置项优化)
- 新增了 APM/KPM 管理功能
- 官方只提了管理器层面的改动