SuperAPI AI 工具集

modularization

通用与其它

查看项目

更新于 10-16 01:08

技能介绍

用途:在 settings.gradle(.kts) 包含多个模块的 Android/Kotlin 项目中,编写或修改类、对象、函数、属性、常量时,指导可见性声明方式,使模块边界清晰。

主要能力:核心原则是“在仍能编译的前提下,使用最低可见性”。从 private 起步;仅当同一模块内其他文件需要时才放宽到 internal;仅当确实有其他模块消费时才放宽到 public。要点指出 Kotlin 默认可见性为 public,在多模块项目中这一默认通常不合适:public 符号会进入模块的 API 表面,导致实现跨边界泄漏,并被要求保持稳定。

具体建议:仅作模块 API 的公共接口声明为 public,其实现类保持 internal,通过依赖注入绑定,不在其他模块中直接引用;仅模块内部使用的 mapper、helper、extension、常量、UI 状态持有者设为 internal,若单个文件使用则可设为 private;“由本模块内的 composable 渲染”并不要求 public,internal 对整个模块可见;仅在类内部使用的成员设为 private。

使用方式:作为编写与修改代码时的可见性判断准则,逐个符号评估是否真正存在跨模块消费者;把放宽到 public 视为一次决策,而非默认行为。

适用场景:多模块 Android/Kotlin 工程的模块化重构、接口与实现分离、API 表面治理、减少模块间不必要耦合。

限制:资料未提供具体安装命令、配置参数、示例项目或自动化检查方式,也未提供收费、价格或平台支持信息;实际落地需结合工程自身模块结构判断。