3. 并行编译与守护进程优化

Android 构建耗时是研发效率的关键瓶颈。本章聚焦 Gradle 守护进程（Daemon）与并行编译参数，讲解如何通过调整 JVM 堆大小、并行任务数和守护进程生命周期来显著提升构建速度。

3.1 核心概念与原理

Gradle 构建过程分为三个阶段：初始化、配置和执行。并行编译与守护进程优化主要作用于执行阶段，减少任务调度开销和 JVM 冷启动时间。

3.2 守护进程生命周期

守护进程的启动、复用和停止流程如下：

1. 首次执行 ./gradlew assembleDebug 时，Gradle 启动 Daemon 进程（默认端口 1099）。
2. 第二次构建时，客户端通过 socket 连接已有 Daemon，发送构建请求。
3. Daemon 解析 build.gradle，复用缓存的类信息和编译输出。
4. 构建完成后，Daemon 保持 JVM 运行，等待下次请求。
5. 闲置 3 小时后自动停止，或通过 --stop 命令手动终止。

# 手动停止所有守护进程
./gradlew --stop

# 查看守护进程状态（输出当前存活 Daemon 列表）
./gradlew --status

# 指定守护进程超时时间（单位：分钟）
gradle.properties:
org.gradle.daemon.idletimeoutminutes=120

3.3 并行编译参数配置

在项目根目录下的 gradle.properties 中配置以下参数：

# 开启并行编译
org.gradle.parallel=true

# 开启守护进程
org.gradle.daemon=true

# 设置 JVM 堆大小（建议 4-8 GB，根据机器内存调整）
org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m

# 限制最大并行工作者数（通常为 CPU 核心数减 1 或等于核心数）
org.gradle.workers.max=4

# 按模块启用并行任务数
org.gradle.parallel.pool-size=4

3.4 JVM 堆大小调整策略

JVM 堆大小直接影响编译任务的吞吐量。推荐分步测试确定最优值：

1. 基线测量：在 gradle.properties 中去掉 org.gradle.jvmargs，记录构建时间。
2. 逐步增加：从 -Xmx2048m 开始，每次增加 1024m 直至构建稳定。
3. 监控 GC：使用 -XX:+PrintGCDetails -Xloggc:gc.log 分析 GC 频率和暂停时间。
4. 锁定值：选择 GC 暂停 < 200ms、堆使用率 < 70% 的配置。

# 推荐配置模板（16 GB 内存机器）
org.gradle.jvmargs=-Xmx6144m \
  -XX:MaxMetaspaceSize=512m \
  -XX:+HeapDumpOnOutOfMemoryError \
  -XX:HeapDumpPath=build/heapdump.hprof \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=200

3.5 进程数调整与 CPU 亲和性

org.gradle.workers.max 控制并行任务数。设置过低导致 CPU 利用率不足；设置过高引起线程竞争。

gradle.taskGraph.whenReady { graph ->
    println "Parallel execution: ${gradle.startParameter.parallelProjectExecutionEnabled}"
    println "Max workers: ${gradle.startParameter.maxWorkerCount}"
}

3.6 实战流程图：并行编译与守护进程优化流程

下图展示从开发者提交代码到获得增量构建结果的完整优化链路：

3.7 调试与验证方法

配置生效后，使用以下方式验证：

1. 查看构建扫描：添加 --scan 参数，在浏览器中查看 Task 执行时间线和并行度。
2. 检查守护进程：./gradlew --status 确认 Daemon 处于 BUSY 或 IDLE 状态。
3. 监控进程数：ps aux | grep gradle 查看存活 Gradle 进程数量。
4. 分析 GC 日志：使用 GCeasy 或 JVisualVM 分析堆使用模式。

# 构建扫描示例（每次构建后生成在线报告）
./gradlew assembleDebug --scan

# 输出示例：
Publishing build scan...
https://gradle.com/s/abc123def456

3.8 常见错误与解决方案

3.9 性能优化与调优建议

• 固化守护进程：在 CI/CD 流水线中，使用 --daemon 保持 Daemon 持续运行，避免每次构建都启动新进程。
• 结合缓存：开启 org.gradle.caching=true 与并行编译配合，增量编译速度可提升 5-10 倍。
• 按需配置：在 gradle.properties 中为 assembleRelease 分配更大堆（如 -Xmx8G），assembleDebug 则使用 -Xmx4G。
• 监控告警：集成 build-metrics 插件，实时上报构建时间、GC 暂停和 Daemon 健康状态。