kapt 替换为 KSP

构建速度优化

老项目常见慢构建原因

老项目构建慢通常卡在这几个地方,按效果从大到小排列:

优化项 效果 操作
Gradle 版本升级 显著 升级到 Gradle 8.x + AGP 8.x
开启并行构建 中等 gradle.properties 加 org.gradle.parallel=true
开启构建缓存 显著 org.gradle.caching=true
增大 Gradle 内存 中等 org.gradle.jvmargs=-Xmx4096m
开启增量编译 显著 Kotlin 和 kapt 默认开启但需确认没被关闭
kapt → KSP 显著 Kotlin Symbol Processing 替代 kapt
模块化拆分 显著 大 module 拆小,只编译改动的 module

快速检查清单

gradle.properties:

ini 复制代码
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.jvmargs=-Xmx4096m -XX:+HeapDumpOnOutOfMemoryError
org.gradle.configuration-cache=true
android.useAndroidX=true
android.nonTransitiveRClass=true

kapt 替换为 KSP:

bash 复制代码
// build.gradle.kts
plugins {
    // id("kotlin-kapt")  ← 删掉
    id("com.google.devtools.ksp") version "1.9.21-1.0.16"
}

dependencies {
    // kapt("androidx.room:room-compiler:2.6.1")  ← 删掉
    ksp("androidx.room:room-compiler:2.6.1")
}

一句话注意

配置缓存(configuration-cache=true)在 Gradle 8.x 中稳定可用,首次构建后后续构建跳过配置阶段,能省 1-3 秒。但要求所有脚本使用 Kotlin DSL 且没有不兼容的插件。

KSP 比 kapt 快 2-3 倍------kapt 是完整的 Java 注解处理器,KSP 是 Kotlin 原生的符号处理器,跳过 Java 编译环节。但要注意所有原来用 kapt 的注解处理器都要看是否支持 KSP 版本。

android.nonTransitiveRClass=true 能让每个 module 生成自己的 R 类而不是全局共享,减少增量编译时的重新编译范围。AGP 8.0 后已默认开启。


Java Android 老项目迁移系列,持续更新中。

相关推荐
二流小码农28 分钟前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
Flynt1 小时前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
Resean02232 小时前
Spring 源码分析(一)IOC 容器总览与 refresh() 全景
java·后端·spring
保利威视频SaaS小张2 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
阿杰m3 小时前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen1233 小时前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_967980113 小时前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试
顧棟4 小时前
【ES实战】 索引模板「可追溯、可校验」:一种模板治理的工程化思路
java·数据库·elasticsearch
booboosui4 小时前
不写安装器:点一下就往对话里塞 152 个字符
android
一条破秋裤5 小时前
【1117】【内存资源管控】【笔记】
android·笔记