使用Gradle Version Catalog时如何查询有可用更新的依赖?
依赖更新查询最优方案
方案1:使用com.github.ben-manes.versions插件(最推荐)
这是目前Gradle生态中最成熟的依赖更新检查工具,原生支持Version Catalog声明的依赖,无需额外适配,输出结果清晰可自定义。
配置步骤
- 在项目根目录的
settings.gradle(Groovy语法)或settings.gradle.kts(Kotlin语法)中添加插件声明:
// Groovy 示例 plugins { id "com.github.ben-manes.versions" version "0.51.0" }
// Kotlin 示例 plugins { id("com.github.ben-manes.versions") version "0.51.0" }
- 执行检查命令:
在项目根目录终端执行:./gradlew dependencyUpdates
可选配置
可以在根目录build.gradle中添加规则过滤不需要的版本、自定义报告格式:
dependencyUpdates { // 过滤非正式版更新,只保留稳定版提示 rejectVersionIf { def unstableKeywords = ["alpha", "beta", "rc", "SNAPSHOT", "preview"] return unstableKeywords.any { keyword -> candidate.version.toLowerCase().contains(keyword) } } // 同时输出HTML、JSON、纯文本三种格式的报告 reportFormats = ["html", "json", "text"] }
执行命令后生成的报告默认存放在build/reports/dependencyUpdates/目录下。
方案2:修复IDE更新提示
IntelliJ IDEA/Android Studio本身支持Version Catalog的依赖更新提示,无提示可按以下步骤排查:
- 打开
Settings > Build, Execution, Deployment > Build Tools > Gradle,确认Enable version catalog support和相关依赖提示开关处于开启状态 - 执行IDE缓存清理重启:点击
File > Invalidate Caches...,勾选Clear file system cache and local history后重启IDE,等待项目重新索引完成 - 确认IDE版本与项目使用的Gradle版本兼容,过低的IDE版本不支持高版本Gradle的Version Catalog特性
方案3:Gradle原生命令(无需额外插件)
Gradle 7.4及以上版本自带依赖信息查询能力,直接执行命令即可查看所有依赖的版本信息:
./gradlew outgoingVariants --all
该命令输出内容较为原始,无过滤和格式化,适合临时快速查询使用。
内容的提问来源于stack exchange,提问作者xatok
相关产品推荐
相关产品推荐

