安装和管理 APM 模块 — 禁用、启用、卸载
进入模块管理页面
打开 APatch 管理器,切换到"系统模块"页面(底部导航的 Tab 数量取决于管理器版本,有的在主页的卡片区里)。里面会列出所有已安装的模块。
安装新模块
步骤 1:下载模块文件
从 Magisk 模块仓库(GitHub、酷安论坛等)下载 APM 兼容的模块 zip 文件。确保模块支持 Magisk Module 格式——绝大多数都是支持的。
步骤 2:管理器安装
在模块管理页面点击右下角的浮动按钮,选择"安装模块",然后在文件选择器里找到模块 zip 文件。
管理器会自动解包 zip、检查 module.prop、把模块文件放到 /data/adb/ap/modules/ 下。安装完成后需要重启设备才能生效。
步骤 3:重启生效
模块安装完后,管理器会提示重启。重启后 overlayfs 会在 post-fs-data 阶段把模块文件叠加到系统分区上。
禁用和启用模块
在模块列表里,每个模块右侧有一个开关:
- 打开:模块生效,overlayfs 叠加
- 关闭:模块禁用,overlayfs 不叠加
禁用后需要重启才能生效(因为 overlayfs 的挂载发生在开机早期)。禁用模块不删除模块文件,随时可以再打开。
卸载模块
在模块列表里长按模块条目,弹出菜单里选"卸载"。卸载管理器会:
- 把模块标记为待删除
- 重启时在 post-fs-data 阶段删除模块文件和相关 mount
和禁用不同,卸载是真正删除模块文件。如果模块自己的 uninstall.sh 脚本有额外清理逻辑,也会执行。
模块 WebUI 管理
有些模块提供了 WebUI(在管理器里点模块名称会打开一个内嵌浏览器页面)——在 WebUI 里可以做更复杂的配置操作,不需要 root shell。
APatch 的 WebUI 实现和 KernelSU 完全一致——为 KernelSU 设计的 WebUI 在 APatch 上直接能用。
模块状态说明
管理器里模块的状态标识:
| 状态 | 含义 |
|---|---|
| 绿色开关 | 已启用,下次重启生效 |
| 灰色开关 | 已禁用,下次重启生效 |
| 重启图标 | 刚刚安装/禁用/卸载,等待重启生效 |
| 异常图标 | 模块有问题(文件损坏、格式不兼容等) |
关于 os error 2/5/22
如果安装模块时报 os error 2、5 或 22 这类错误:
在 root 授权页面取消 shell 的 root 权限。
具体做法:打开 APatch 管理器 → 权限管理 → 找到 shell 这个条目 → 取消授权 → 重启 → 再试试安装模块。
这是已知的老问题——shell 被 root 授权后,它的 SELinux 上下文会影响其他进程的文件操作。取消 shell 的 root 授权是官方推荐的解决方法。