解剖Animetail代码架构:Kotlin多模块设计与Clean Architecture完全指南
解剖Animetail代码架构:Kotlin多模块设计与Clean Architecture完全指南
Animetail 是一款基于 Mihon/Aniyomi 的 Android 动漫与漫画阅读播放应用,它的源码是学习 Kotlin 多模块设计 与 Clean Architecture(整洁架构) 的绝佳范本:17 个 Gradle 模块按 domain、data、presentation 严格分层,配合 Metro 依赖注入、SQLDelight 数据库和版本目录统一管理,让上万行代码依然保持清晰可读。
🧭 一图看懂:17 个模块如何分工
打开项目根目录的 settings.gradle.kts,就能找到整个 Animetail 代码架构的"地图"——每一行 include 对应一个独立模块:
| 模块 | 职责 | 关键词 |
|---|---|---|
:app |
应用壳层,DI 装配、启动流程 | Application、Graph |
:domain |
业务逻辑层(interactor) | 整洁架构核心 |
:data |
数据层,SQLDelight 仓库实现 | Repository、.sq |
:presentation-core |
Compose 主题、组件、屏幕 | UI |
:presentation-widget |
桌面小组件 | Glance |
:source-api / :source-local |
扩展源抽象 / 本地源 | 插件化 |
:core:common、:core:metro、:core:archive |
通用工具、DI 基础、归档解析 | 基础设施 |
:core-metadata、:i18n*、:icons* |
多语言资源与图标 | 资源模块 |
:macrobenchmark |
性能基准测试 | Macrobenchmark |
这种"小模块、单向依赖"的设计,是 Kotlin 多模块工程的标准答案:上层可以依赖下层,下层绝不回头依赖上层,编译更快、边界更清晰。
🏗️ Clean Architecture 在 Animetail 中的落地
Animetail 是典型的三层整洁架构,数据流向自下而上:
1️⃣ domain 层:纯业务规则,不碰 Android API
domain/src/main/java/tachiyomi/domain/ 下按领域划分目录(manga、chapter、history、track…),每个目录里的 interactor 是一类业务操作的具象化命名,比如:
GetLibraryManga—— 获取书架SetReadStatus—— 标记章节已读UpsertAnimeHistory—— 写入观看历史
interactor 只定义"做什么",不关心数据来自数据库还是网络——这正是 Clean Architecture 可测试性的关键。
2️⃣ data 层:用 SQLDelight 声明式管理数据库
data/ 模块里放着所有 Repository 实现与数据库定义。 Animetail 的代码架构中一个亮眼设计是双数据库:漫画用 manga.sq、动漫用 animes.sq,各自维护迁移脚本(migrations/ 已有 46 个版本,动画库迁移从 113 延续到 143)。.sq 文件直接写 SQL 并生成类型安全的 Kotlin API,改表结构时编译器会帮你把关。
UI (presentation-core)
│ 调用
▼
domain(interactor,纯逻辑)
│ 调用
▼
data(Repository + SQLDelight)
3️⃣ presentation 层:Compose 负责"怎么显示"
presentation-core/src/main/java/tachiyomi/presentation/core/ 只包含 screens、components、theme 等 UI 概念,业务全部委托给 domain 层的 interactor,UI 代码因此非常薄。
🔌 依赖注入:Metro + Injekt 的混合方案
启动入口 App.kt 实现 GraphProvider<AppGraph> 接口,通过 Metro 编译期生成依赖图:
override val graph: AppGraph by lazy { createGraphFactory<AppGraph.Factory>().create(...) }
核心依赖声明在 AppGraph.kt 的 @DependencyGraph 中。更妙的是 MetroInjektRegistrar.kt:它把 Metro 生成的图"桥接"到 Injekt 框架,让需要运行时反射注入的场景(如扩展插件)也能拿到单例。编译期生成 + 运行时兜底,兼顾了性能与灵活性——这是 Animetail 代码架构中最值得借鉴的设计之一。
🧩 source-api:让第三方扩展"即插即用"
Anime 的内容来自可安装扩展。source-api 模块定义了扩展必须实现的抽象类,例如 ParsedHttpSource.kt:作者只需给出 Jsoup 选择器,框架自动完成解析。动漫侧的 animesource 包则用 SAnime、SEpisode、Hoster 等模型描述播放源。模块间通过接口契约通信,而非互相引用——这是多模块设计防止"依赖雪崩"的常用手法。
🌍 工程化细节:版本目录与多语言资源
- 统一版本管理:所有依赖版本集中在 gradle/libs.versions.toml(Kotlin 2.4.21、Compose BOM、SQLDelight 2.4.1 等),另有
mihonx、aniyomilibs两个版本目录按来源拆分,升级依赖只需改一处 TOML。 - 资源与代码分离:三个独立 i18n 模块(i18n/、i18n-aniyomi/、i18n-tail/)各自维护上百种语言的翻译资源,互不污染;icons/ 同理集中管理 SVG 图标。
- 小组件独立成模块:桌面"更新格子"小组件由独立的
:presentation-widget提供,下面是它的实际渲染效果:
📖 新手源码阅读路线(附步骤)
- 先读地图:从 settings.gradle.kts 认识 17 个模块,再对照上表理解分层;
- 跟一次启动:打开 App.kt,看
onCreate如何装配 DI 图、注册通知、初始化迁移; - 跟一个功能:以"标记章节已读"为例,从 UI 一路追到
SetReadStatusinteractor,再到data层的.sq查询,完整体验三层调用链; - 看扩展接入:浏览 source-api 中的抽象源,理解 Animetail 如何支持数百个第三方内容源。
如需本地研读,可克隆仓库:git clone https://gitcode.com/gh_mirrors/an/Animetail
✅ 小结
Animetail 代码架构给新手的三条启发:用模块边界表达架构分层(domain / data / presentation 单向依赖)、用编译期工具(Metro、SQLDelight、版本目录)替代手写样板、用资源模块隔离易变内容(语言、图标、小组件)。掌握这套 Kotlin 多模块 + 整洁架构的组合拳,你就能读懂绝大多数现代 Android 大型项目。
