检查并更新管理器 — 普通升级和 CI 构建版
自动检查 vs 手动检查
设置面板里"检查更新"开关打开后,每次启动管理器都会自动去 GitHub Releases 拉取最新版本号。如果发现有更新版本,主页会弹出提示。
也可以手动检查:点击主页右上角的刷新按钮旁边的菜单里应该有"检查更新"选项(不同版本可能位置有变化)。
下载和安装
发现新版本后:
- 管理器会弹出更新提示
- 点击下载,APK 会下载到手机存储
- 下载完成后点击安装,手机会弹出安装确认界面
- 安装完新版本管理器后,不需要重新修补 boot.img
注意:更新管理器 不 等于更新内核级补丁。新版管理器可能携带新的 KernelPatch 框架,但旧的修补好的 boot.img 里的 KernelPatch 版本是固定的——要让内核补丁也升级,需要重新修补 boot.img。
正式版 vs CI Nightly
APatch GitHub 仓库有两条发布通道:
正式版(Stable Release)
- 版本号格式通常是五位数字,如
11142 - 经过基本测试,适合日常使用
- 在 GitHub Releases 页面标记为 Latest
CI 构建版(Nightly)
- GitHub Actions 每次提交后自动构建
- 版本号可能带有
dev或类似标记 - 未经过充分测试,可能有 bug
- 但修复问题和新功能会先出现在这里
什么时候用 CI 构建版:你在正式版遇到了某个 bug,确认该问题在 Issue 里已经被修复但修复还没打包进正式版。此时可以下载最新 CI 构建版试试。
管理器版本 vs 内核补丁版本
有一个重要区别要搞清楚:
| 组件 | 版本号来源 | 更新方式 |
|---|---|---|
| APatch 管理器 | 管理器 APK 自己的版本号 | 下载新 APK 安装 |
| KernelPatch 内核补丁 | boot.img 里嵌入的补丁版本 | 重新修补 boot.img 并刷入 |
新版管理器可能同时携带新版 KernelPatch,但已经刷入设备的旧 boot.img 里的 KernelPatch 不会自动升级。如果官方更新了 KernelPatch 框架(比如支持了新内核版本或修复了某个安全漏洞),你需要:
- 下载新版管理器
- 用新版管理器重新修补原厂 boot.img
- 刷入新的修补产物
- 重新验证 SuperKey
关于超级密钥迁移
在 APatch 11090 左右的版本,SuperKey 机制发生了重大变化——从强制 SuperKey 认证改为验证管理器签名。从旧版升级时必须先升级到一个过渡版本(GitHub Actions 上有专门的构建版本),再升到最新版,跳过这步可能导致卡开机或丢失 root 权限。