如何让Android项目自动使用最新的buildToolsVersion？

方法1：依赖Android Gradle Plugin（AGP）的自动匹配机制 #

从AGP 3.0版本开始，插件会自动根据你设置的compileSdkVersion匹配对应的最新兼容buildToolsVersion，无需手动显式指定。只要你保持compileSdkVersion为最新安装的SDK版本，AGP就会自动选用适配的最新buildTools版本。如果你的项目还在使用旧版AGP，建议升级到稳定的新版本，就能启用这个特性。

方法2：通过全局Gradle配置统一管理 #

可以利用Gradle的全局初始化脚本或全局属性文件，让所有本地项目自动应用最新的buildTools版本：

1. 使用全局初始化脚本
   在~/.gradle/init.gradle（Windows系统路径为C:\Users\<你的用户名>\.gradle\init.gradle）中添加以下配置：

   allprojects {
       afterEvaluate { project ->
           if (project.hasProperty('android')) {
               def androidExt = project.extensions.getByName('android')
               // 获取本地已安装的最新buildTools版本
               def latestBuildTools = com.android.sdklib.BuildToolInfo.getLatestKnownBuildTools(androidExt.compileSdkVersion.toInteger())
               androidExt.buildToolsVersion = latestBuildTools
           }
       }
   }
   

   这样所有Android项目在构建时都会自动使用本地已安装的最新buildTools版本。

2. 使用全局属性文件
   在~/.gradle/gradle.properties中添加版本定义：

   globalBuildToolsVersion=34.0.0
   

   然后在每个项目的模块build.gradle中引用这个全局变量：

   android {
       buildToolsVersion globalBuildToolsVersion
       // 其他编译配置
   }
   

   后续只需要更新全局gradle.properties里的版本号，所有项目都会同步使用新版本。

方法3：使用Gradle版本目录（Version Catalogs）（AGP 7.0+适用） #

如果你的项目使用Gradle 7.0及以上版本，可以通过版本目录集中管理所有依赖和工具版本：
在项目根目录的settings.gradle中定义版本：

dependencyResolutionManagement {
    versionCatalogs {
        libs {
            version("buildTools", "34.0.0")
        }
    }
}

然后在模块的build.gradle中引用该版本：

android {
    buildToolsVersion libs.versions.buildTools.get()
    // 其他配置
}

之后只需修改settings.gradle里的版本号，所有模块都会自动更新到指定的最新版本。

注意事项 #

• 确保Android SDK Manager中已经安装了最新的buildTools版本，否则上述方法会因为找不到对应版本而报错。
• 升级AGP时，注意同步调整compileSdkVersion和targetSdkVersion，保持版本兼容性，避免编译异常。

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