用途:为 Android 项目提供架构规范,指导项目结构搭建与代码放置,覆盖 Clean Architecture 分层、模块化和单向数据流(UDF),并校验 Jetpack Compose 集成。
主要能力:
- 分层:Domain 层为纯 Kotlin(无 Android 依赖),含 UseCase 与 Model;Data 层含 Repository 实现与 DataSource(API/DB),负责 DTO 到 Domain 的映射;UI 层为 ViewModel + Composable,负责 Domain 到 UiState 的映射。
- 模块化:按功能划分 :feature:home、:feature:profile 等;核心模块如 :core:ui(设计系统)、:core:network、:core:database;App 模块作为 DI 根与导航守卫。
- 单向数据流:事件由 UI 流向 ViewModel(用户操作向上),状态由 ViewModel 流向 UI(StateFlow<UiState> 向下)。
- Compose 集成:Activity 中使用 setContent(不使用 XML 布局);用 collectAsStateWithLifecycle 将状态提升到 ViewModel;确保 Composable 参数为 @Stable 或 @Immutable;使用类型安全目标的 Compose Navigation。
反模式:Activity 中不放逻辑,仅承载导航;UI 不直接访问 Repository,数据只经 ViewModel;Domain 中不使用 Context,保持逻辑纯粹。
验证方式:Domain 层零 Android 框架导入;每个功能模块可独立编译;状态单向流动(事件向上、状态向下);./gradlew build 成功。
适用场景:Android 项目初始化、代码分层与模块划分、Compose 状态管理规范检查。
限制:资料未提供具体版本要求、依赖配置细节、完整代码示例与工具集成方式,相关事实暂未提供。