支持多ABI时Android Studio每次全量编译，如何仅编译变更文件？

我之前也碰到过这个头疼的问题——多ABI配置下CMake每次都全量重建，明明代码没改却要等半天。结合我踩过的坑和实际调试经验，给你几个排查和解决的方向：

1. 确保每个ABI拥有独立的构建目录 #

Gradle默认会为每个ABI生成单独的CMake构建目录，但如果你的配置有自定义路径，可能导致多个ABI共用同一目录，触发全量重建。

检查你的app/build.gradle配置，确保abiFilters正确设置，且没有自定义冲突的构建路径：

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                // 明确指定需要支持的ABI
                abiFilters "armeabi-v7a", "arm64-v8a"
                // 其他CMake参数，比如cppFlags等
            }
        }
    }
    externalNativeBuild {
        cmake {
            path file("CMakeLists.txt")
            // 不要设置buildDir为固定路径，让Gradle自动分配
        }
    }
}

正常情况下，构建目录应该是app/.cxx/cmake/[buildType]/[abi]，每个ABI的目录相互独立。

2. 修复CMakeLists.txt中的"不稳定"配置 #

CMake的配置阶段如果每次都有变化，会触发全量编译。常见的问题点：

• 避免动态生成的文件列表：如果用了file(GLOB)来收集源文件，默认不会自动检测文件变化，建议换成明确列出源文件；如果必须用GLOB，添加CONFIGURE_DEPENDS参数：

  file(GLOB_RECURSE SRC_FILES CONFIGURE_DEPENDS src/*.cpp src/*.h)
  

• 移除每次构建都会变化的操作：比如用execute_process获取系统时间、随机数，或者读取会动态变化的外部文件，这些都会让CMake认为配置发生了改变。
• 检查自定义目标的依赖：如果有自定义CMake目标依赖了全局变量或动态生成的内容，也可能导致全量重建。

3. 启用Gradle构建缓存 #

Gradle的构建缓存可以缓存CMake的编译输出，避免重复工作。确保gradle.properties中开启了缓存：

org.gradle.caching=true
org.gradle.parallel=true # 可选，并行构建提升速度

同时，检查是否有自定义Gradle任务禁用了缓存（比如设置了outputs.upToDateWhen { false }），这种配置会强制任务每次执行。

4. 清理损坏的缓存，重新初始化 #

有时候旧的缓存文件损坏，会导致Gradle/CMake无法正确识别增量变化。执行以下步骤：

• 点击Android Studio菜单栏的File -> Invalidate Caches...，选择"Invalidate and Restart"
• 手动删除app/build和app/.cxx目录
• 重新构建项目，让Gradle和CMake生成全新的缓存文件

5. 升级AGP和CMake版本 #

旧版本的Android Gradle Plugin（AGP）或CMake存在多ABI增量编译的bug，建议升级到稳定的最新版本：

• AGP建议使用7.4.x或更高版本（对应Android Studio Hedgehog或更高）
• CMake建议使用3.22.x或更高版本（可在SDK Manager中安装）

按照这些步骤排查后，应该就能恢复正常的增量编译了——只有修改过的文件才会被重新编译，不同ABI的构建过程也会独立缓存。

内容的提问来源于stack exchange，提问作者Bram