模块卸载——彻底移除不再需要的 Root 模块
卸载前想清楚
卸载是不可逆操作——模块的配置数据和安装文件会被删除。在卸载之前,建议先尝试禁用模块(见启停开关页面),确认禁用后手机没有问题再卸载。
卸载步骤
KsuWebUI 中卸载模块有两种方式:
方式一:长按模块
- 在模块列表中长按目标模块
- 在弹出菜单中选择「卸载」
- 确认卸载提示
- 等待完成
方式二:模块详情页
- 点击模块进入详情页
- 找到「卸载」按钮
- 确认并等待完成
卸载过程
KsuWebUI 执行卸载时:
- 读取模块目录中的
uninstall.sh脚本 - 运行框架提供的卸载流程
- 清理模块安装目录下的所有文件
- 从框架的模块注册表中移除记录
卸载后要不要重启
要重启。原因和禁用类似——root 模块在系统启动阶段进行了文件替换、sepolicy 注入、服务启动等操作,运行中的系统无法完全撤销这些改动。
如果卸载后不重启,可能出现:
- 模块功能看似消失但后台进程还在
- 系统文件处于不一致状态
- 下一次启动后才真正完全清除
卸载残留
大多数情况下,卸载脚本会清理干净。但某些老旧模块可能清理不彻底,残留配置文件。可以:
- 重启后检查模块列表是否还显示该模块
- 在 root 文件管理器中检查模块目录是否还有残留
- 手动删除残留目录(路径由 root 框架决定)
特殊情况
| 情况 | 处理方式 |
|---|---|
| 模块已损坏无法正常卸载 | 手动删除模块目录,再重启 |
| 卸载后手机出问题 | 进 Recovery 或 Fastboot 恢复 |
| 想保留配置以备将来恢复 | 先备份模块配置(见备份迁移),再卸载 |