KsuWebUI 中文文档 下载 App

模块卸载——彻底移除不再需要的 Root 模块

卸载前想清楚

卸载是不可逆操作——模块的配置数据和安装文件会被删除。在卸载之前,建议先尝试禁用模块(见启停开关页面),确认禁用后手机没有问题再卸载。

卸载步骤

KsuWebUI 中卸载模块有两种方式:

方式一:长按模块

  1. 在模块列表中长按目标模块
  2. 在弹出菜单中选择「卸载」
  3. 确认卸载提示
  4. 等待完成

方式二:模块详情页

  1. 点击模块进入详情页
  2. 找到「卸载」按钮
  3. 确认并等待完成

卸载过程

KsuWebUI 执行卸载时:

  1. 读取模块目录中的 uninstall.sh 脚本
  2. 运行框架提供的卸载流程
  3. 清理模块安装目录下的所有文件
  4. 从框架的模块注册表中移除记录

卸载后要不要重启

要重启。原因和禁用类似——root 模块在系统启动阶段进行了文件替换、sepolicy 注入、服务启动等操作,运行中的系统无法完全撤销这些改动。

如果卸载后不重启,可能出现:

卸载残留

大多数情况下,卸载脚本会清理干净。但某些老旧模块可能清理不彻底,残留配置文件。可以:

  1. 重启后检查模块列表是否还显示该模块
  2. 在 root 文件管理器中检查模块目录是否还有残留
  3. 手动删除残留目录(路径由 root 框架决定)

特殊情况

情况处理方式
模块已损坏无法正常卸载手动删除模块目录,再重启
卸载后手机出问题进 Recovery 或 Fastboot 恢复
想保留配置以备将来恢复先备份模块配置(见备份迁移),再卸载