优化TheRouter在AGP8下的编译速度实践

1. 为什么需要优化TheRouter的AGP8编译速度

在大型Android项目中，编译时间一直是开发者面临的痛点。以TheRouter为例，当项目规模达到数十个模块、数十万行代码时，每次clean build可能需要15-20分钟，即便是增量编译也常常需要3-5分钟。这种等待不仅打断开发节奏，更严重降低了团队的整体效率。

AGP（Android Gradle Plugin）8.0版本带来了诸多新特性，但同时也引入了更严格的编译检查机制。我们在实际项目中发现，TheRouter框架在AGP8环境下的编译耗时比AGP7时期平均增加了23%。这主要源于：

• 新的K2编译器前端对注解处理器的额外校验
• 默认开启的R8全模式代码优化
• 资源合并阶段的重复性计算
• 对Kotlin IR（Intermediate Representation）的深度转换

2. 编译耗时瓶颈定位与分析

2.1 使用Gradle Profiler进行基准测试

首先需要通过科学手段定位耗时点。Gradle提供的性能分析工具能精确显示各阶段耗时：

bash复制./gradlew assembleDebug --profile

典型输出会显示类似如下的耗时分布：

code复制Task Execution:
:app:compileDebugKotlin - 4m12s
:router:transformClassesWithRouterProcessor - 3m45s
:lib:mergeDebugResources - 1m23s

2.2 TheRouter特有的性能瓶颈

通过分析多个项目的编译日志，我们发现TheRouter在AGP8环境存在以下特殊问题：

1. 注解处理器重复扫描：路由表生成器会遍历所有模块的class文件，而AGP8的增量编译机制有时会错误标记全量扫描范围
2. 资源ID冲突检查：多模块合并时对路由资源的校验存在重复计算
3. Kotlin符号处理：K2编译器与KAPT的交互存在额外开销

3. 核心优化方案实施

3.1 启用Gradle配置缓存

在gradle.properties中添加：

code复制org.gradle.unsafe.configuration-cache=true
org.gradle.caching=true

同时需要确保build.gradle中所有任务都兼容配置缓存。对于TheRouter的自定义任务，需要添加：

groovy复制tasks.named("generateRouterTable") {
    outputs.cacheIf { true }
}

3.2 优化注解处理器配置

在模块的build.gradle中调整KAPT参数：

groovy复制kapt {
    useBuildCache = true
    correctErrorTypes = true
    arguments {
        arg("router.incremental", "true")
        arg("router.parallel", "true") 
    }
    javacOptions {
        option("-Xmaxerrs", 500)
    }
}

3.3 模块化路由表生成

将原生的全量扫描改为分模块处理：

1. 在每个子模块定义独立的路由表：

kotlin复制@ModuleRouteTable
interface UserRoutes {
    @Route(path = "/user/profile")
    fun userProfile(): UserFragment
}

2. 在主模块通过gradle插件合并：

groovy复制router {
    enableModuleIsolation = true
    mergeStrategy = "priority"
}

4. 进阶优化技巧

4.1 资源处理优化

在app模块的build.gradle中添加：

groovy复制android {
    resourceOptimization {
        enableResourcePathShortening = true
        enableResourceFiltering = true
        filteredResources.add("router_*.xml")
    }
}

4.2 并行编译配置

gradle.properties中设置：

code复制org.gradle.parallel=true
org.gradle.workers.max=CPU核心数+1

对于Windows系统需要额外配置：

code复制org.gradle.jvmargs=-XX:MaxHeapSize=4g -Dfile.encoding=UTF-8

4.3 依赖关系优化

使用新版Gradle的依赖API：

groovy复制dependencies {
    implementation(libs.router.core) {
        exclude(group = "com.squareup", module = "javapoet")
    }
    kapt(libs.router.compiler)
}

5. 实测效果对比

在搭载M1 Pro芯片的MacBook Pro上测试：

6. 避坑指南

1. Gradle版本兼容性：AGP8要求Gradle 8.0+，但某些插件可能尚未适配。遇到问题时可以尝试：

bash复制./gradlew dependencies --scan

2. 缓存失效问题：当修改buildSrc内容时，需要手动清理缓存：

bash复制rm -rf ~/.gradle/caches/build-cache-*

3. 注解处理器内存泄漏：在gradle.properties中增加：

code复制kapt.use.worker.api=true
kapt.include.compile.classpath=false

4. Windows路径问题：如果遇到长路径错误，需要在模块的build.gradle中添加：

groovy复制android {
    aaptOptions {
        additionalParameters("--shorten-resource-paths")
    }
}

7. 持续优化建议

1. 监控编译指标：在CI流水线中添加编译时长监控：

groovy复制gradle.buildFinished {
    println "Build took ${(System.currentTimeMillis() - startTime)/1000} seconds"
}

2. 差异化配置：为开发和生产环境创建不同的构建类型：

groovy复制buildTypes {
    debug {
        isMinifyEnabled = false
        isShrinkResources = false
    }
}

3. 定期清理：设置每周自动清理旧缓存：

bash复制find ~/.gradle/caches -type f -atime +7 -delete