模块依赖检测——安装前自动检查前置条件

什么是模块依赖

某些 root 模块不是独立运行的——它们需要其他模块先安装好才能正常工作。这种关系叫「依赖」。

常见的依赖场景：

• LSPosed 模块：需要 LSPosed 框架先安装好
• KPM 补丁模块：需要 KPatch-Next 先加载
• 功能增强模块：需要某个基础模块提供的 hook 接口

KsuWebUI 的依赖检测

在安装 ZIP 模块包时，KsuWebUI 会自动读取模块的 module.prop 或 install.sh，检查其中声明的依赖关系：

• 模块内部可以通过 requires 字段声明依赖
• 安装脚本中也可能通过 shell 逻辑检查依赖

检测到依赖缺失的表现

如果 KsuWebUI 发现依赖不满足：

1. 弹出提示，列出缺失的依赖模块名称
2. 建议先安装依赖
3. 不会强制中断——你可以选择跳过警告继续安装，但模块大概率无法正常工作

手动查看依赖

已安装模块的依赖信息可以在模块详情页查看：

• 进入模块管理页面
• 点击目标模块进入详情
• 找到「依赖」或「前置条件」区域

依赖顺序问题

多个模块互相依赖时，安装顺序很重要。建议：

1. 先装最底层的框架类模块（如 LSPosed）
2. 再装依赖框架的功能模块
3. 最后装增强和美化模块

KsuWebUI 在批量安装时不会自动帮你排序——需要你自己注意顺序。

依赖缺失导致的问题

如果模块装了但依赖缺失，可能出现：

• 模块在列表中显示但功能不生效
• 模块闪退或崩溃
• 系统日志中出现依赖相关的错误信息

遇到这种情况，回到模块详情页查看依赖说明，补装缺失的模块。