APatch 中文文档 下载 App

普通版本升级 — 管理器内更新的完整流程

两种东西要分别升级

APatch 安装后有两个组件需要关注版本:

组件存储位置更新方式
APatch 管理器(App)/data/app/下载新 APK 直接安装
内核补丁(KernelPatch)嵌入在 boot.img 里重新修补 boot.img 并刷入

更新管理器不等于更新内核补丁。管理器可以直接装新版,但内核补丁还是旧的——要让内核补丁也升级,必须重新修补 boot 并刷入。

步骤一:更新管理器 App

通常直接在 App 内就能更新:

  1. 打开设置面板
  2. 点击"检查更新"(或自动会弹出更新提示)
  3. 下载新版本 APK
  4. 安装(Android 可能会弹出"未知来源应用"警告,允许即可)

或者手动去 GitHub Releases 下载最新 APK,侧载安装。

步骤二(可选):更新内核补丁

如果新版管理器携带了更新的 KernelPatch 框架,你还需要:

  1. 用新版管理器重新修补原厂 boot.img(不是修补已经修补过的!)
  2. fastboot flash boot 刷入新的修补产物
  3. 重启设备,在管理器里重新验证 SuperKey

为什么要重新修补而不是直接刷入旧的修补产物?因为新版 KernelPatch 可能包含:

版本兼容的坑

KernelPatch 版本不兼容

重要:在一些重大版本更新中,新版本的 KernelPatch 会与旧版不兼容,导致升级后丢失 root 权限。

官方会在发布信息里特别说明这种情况。遇到了就从原厂 boot 重新修补安装——正常的修补流程不受影响。

SuperKey 机制变更

在 11090 左右的版本,SuperKey 机制从强制 SuperKey 认证改为验证管理器签名。从旧版升级时:

  1. 必须先升级到一个特定的过渡版本(GitHub Actions 上有)
  2. 再从过渡版本升级到最新版
  3. 跳过过渡可能导致卡开机或 root 丢失

OTA 安全提示

普通版本升级(只更新管理器 App)对 OTA 没影响。但如果系统要做 OTA 更新,需要参考专门的 OTA 保 root 章节处理。

什么情况下需要两者都升级

什么情况下只更新管理器 App 就够了: