APatch 中文文档 下载 App

安装和管理 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 的挂载发生在开机早期)。禁用模块不删除模块文件,随时可以再打开。

卸载模块

在模块列表里长按模块条目,弹出菜单里选"卸载"。卸载管理器会:

  1. 把模块标记为待删除
  2. 重启时在 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 授权是官方推荐的解决方法。