解剖Animetail代码架构:Kotlin多模块设计与Clean Architecture完全指南

原创2026-11-15 12:38:221,864 阅读

解剖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 提供,下面是它的实际渲染效果:

Animetail 桌面小组件展示,网格中呈现漫画与动漫封面,体现 Animetail 代码架构中 presentation-widget 模块的效果

📖 新手源码阅读路线(附步骤)

  1. 先读地图:从 settings.gradle.kts 认识 17 个模块,再对照上表理解分层;
  2. 跟一次启动:打开 App.kt,看 onCreate 如何装配 DI 图、注册通知、初始化迁移;
  3. 跟一个功能:以"标记章节已读"为例,从 UI 一路追到 SetReadStatus interactor,再到 data 层的 .sq 查询,完整体验三层调用链;
  4. 看扩展接入:浏览 source-api 中的抽象源,理解 Animetail 如何支持数百个第三方内容源。

如需本地研读,可克隆仓库:git clone https://gitcode.com/gh_mirrors/an/Animetail

✅ 小结

Animetail 代码架构给新手的三条启发:用模块边界表达架构分层(domain / data / presentation 单向依赖)、用编译期工具(Metro、SQLDelight、版本目录)替代手写样板、用资源模块隔离易变内容(语言、图标、小组件)。掌握这套 Kotlin 多模块 + 整洁架构的组合拳,你就能读懂绝大多数现代 Android 大型项目。

登录后查看全文
Animetail