APatch 中文文档 下载 App

检查并更新管理器 — 普通升级和 CI 构建版

自动检查 vs 手动检查

设置面板里"检查更新"开关打开后,每次启动管理器都会自动去 GitHub Releases 拉取最新版本号。如果发现有更新版本,主页会弹出提示。

也可以手动检查:点击主页右上角的刷新按钮旁边的菜单里应该有"检查更新"选项(不同版本可能位置有变化)。

下载和安装

发现新版本后:

  1. 管理器会弹出更新提示
  2. 点击下载,APK 会下载到手机存储
  3. 下载完成后点击安装,手机会弹出安装确认界面
  4. 安装完新版本管理器后,不需要重新修补 boot.img

注意:更新管理器 不 等于更新内核级补丁。新版管理器可能携带新的 KernelPatch 框架,但旧的修补好的 boot.img 里的 KernelPatch 版本是固定的——要让内核补丁也升级,需要重新修补 boot.img。

正式版 vs CI Nightly

APatch GitHub 仓库有两条发布通道:

正式版(Stable Release)

CI 构建版(Nightly)

什么时候用 CI 构建版:你在正式版遇到了某个 bug,确认该问题在 Issue 里已经被修复但修复还没打包进正式版。此时可以下载最新 CI 构建版试试。

管理器版本 vs 内核补丁版本

有一个重要区别要搞清楚:

组件版本号来源更新方式
APatch 管理器管理器 APK 自己的版本号下载新 APK 安装
KernelPatch 内核补丁boot.img 里嵌入的补丁版本重新修补 boot.img 并刷入

新版管理器可能同时携带新版 KernelPatch,但已经刷入设备的旧 boot.img 里的 KernelPatch 不会自动升级。如果官方更新了 KernelPatch 框架(比如支持了新内核版本或修复了某个安全漏洞),你需要:

  1. 下载新版管理器
  2. 用新版管理器重新修补原厂 boot.img
  3. 刷入新的修补产物
  4. 重新验证 SuperKey

关于超级密钥迁移

在 APatch 11090 左右的版本,SuperKey 机制发生了重大变化——从强制 SuperKey 认证改为验证管理器签名。从旧版升级时必须先升级到一个过渡版本(GitHub Actions 上有专门的构建版本),再升到最新版,跳过这步可能导致卡开机或丢失 root 权限。