模块化构建与并行化加速：模块依赖优化、并行编译配置、任务图分析
构建速度从分钟级压缩到秒级的关键在于最大化并行度。多模块项目天然具备并行执行的能力，但若依赖关系设计不当，并行度会被串行等待时间拖垮。本章聚焦依赖结构治理、并行参数调优和任务图瓶颈分析，形成可落地的加速闭环。
1. 模块依赖结构优化
依赖声明的颗粒度直接决定任务编排的灵活性。核心原则是：减少传递依赖的暴露，避免编译时泄漏。
| 配置 | 传递性 | 编译影响 | 构建速度 |
|---|---|---|---|
api | 传递依赖 | 消费者模块需重新编译 | 较慢 |
implementation | 不传递依赖 | 仅当前模块重新编译 | 较快 |
经验法则：除非模块的接口类型（如公开的 API 类）被其他模块直接引用，否则一律使用
implementation。这可以平均减少 20%~30% 的增量编译范围。
循环依赖陷阱：模块 A 依赖模块 B，模块 B 又依赖模块 A，会导致 Gradle 在配置阶段抛出
Circular dependency 错误。解决方法是抽取出双方共享的子模块，或将接口下沉到公共基础库。
// 反例：泄漏了 Retrofit 依赖
// app/build.gradle.kts
dependencies {
api(project(":network")) // 错误：network 的内部实现不应暴露给 app 的消费者
}
// 正例：使用 implementation 封装实现细节
// app/build.gradle.kts
dependencies {
implementation(project(":network"))
api(project(":common-entities")) // 合理：entities 是 app 公开接口的一部分
}2. 并行编译配置
AGP 依托 Gradle 的 Worker API 实现并行任务执行。正确的配置可以充分利用多核 CPU 资源。
# gradle.properties
# 开启项目级别的并行执行
org.gradle.parallel=true
# 控制最大工作线程数，推荐为 CPU 核数 - 1
org.gradle.workers.max=8
# 按需配置，减少非必需模块的加载
org.gradle.configureondemand=true
# 开启构建缓存，支持跨项目的任务跳过
org.gradle.caching=true调试验证：运行 ./gradlew assembleDebug --profile，在生成的 build/reports/profile/ HTML 报告中查看“Parallel”时间轴。如果显示串行缝隙较大，说明存在依赖阻塞或线程数不足。
关键指标：并行效率 = 并行执行时间 / 串行执行时间。理想值 > 0.7。若低于 0.5，优先检查任务图中的长串行链。
3. 任务图分析与加速
任务图是构建计划的蓝图。通过分析任务依赖关系，可以发现阻塞并行度的关键路径。
3.1 使用 --dry-run 模拟任务排序
# 查看任务执行顺序（不实际执行）
./gradlew assembleDebug --dry-run
# 输出片段（注意任务串联情况）
:app:preBuild SKIPPED
:database:compileKotlin SKIPPED
:network:compileKotlin SKIPPED
:app:compileDebugKotlin SKIPPED
...3.2 使用 --scan 识别瓶颈
# 上传构建数据到 Gradle Cloud 进行可视化分析
./gradlew assembleDebug --scan
# 在生成的在线面板中关注：
# 1. 任务持续时间（长耗时任务优先优化）
# 2. 关键路径（Critical Path）：决定了构建的最短完成时间
# 3. 缓存命中率（Cacheable 模块的命中数据）
配置缓存加速：从 Gradle 6.6 开始，
org.gradle.configuration-cache=true 可以跨构建缓存配置阶段的结果，大幅缩短每次构建的配置耗时。适用于模块数量 > 20 的大型项目。
4. 综合案例：从依赖治理到并行加速
以下是一个典型的优化路径，展示了问题诊断和优化的完整闭环。
- 诊断阶段：运行
./gradlew assembleDebug --scan，发现:payment:compileKotlin耗时 45s，且其上游模块:common:compileKotlin是串行阻塞点。 - 依赖治理：检查发现
:payment通过api(project(":common"))暴露了:common的内部实现。将其改为implementation，切断了非必要的传递依赖。 - 并行配置：将
workers.max从默认的 4 调整为 8（CPU 核数 - 1），并在gradle.properties中显式设置org.gradle.parallel=true。 - 缓存固化：开启
org.gradle.caching=true和org.gradle.configuration-cache=true。 - 效果验证：重新执行
--scan，关键路径缩短 50%，总构建时间从 3min 下降到 1.2min。
模块化构建的并行加速不是简单堆砌配置，而是通过依赖治理减少串行等待、通过线程池配置压榨硬件能力、通过任务图分析持续消除瓶颈的三位一体工程实践。