如何在Gradle命令行lint任务中添加-Xlint:deprecation参数？

我明白你的困扰——直接给./gradlew lint加-Xlint:deprecation参数没用，因为这个参数是给**Java编译器（javac）**用的，不是Gradle任务的命令行参数，Gradle自然会报错“配置任务失败”。下面给你两种可行的解决办法：

方法一：临时通过命令行传递编译参数 #

如果你不想修改配置文件，只想单次查看详细的deprecated信息，可以用Gradle的项目属性来传递编译参数：

./gradlew lint -Pandroid.compilerArgs="-Xlint:deprecation"

这个命令会让Android编译任务在执行时带上指定的javac参数，这样就能在lint输出中看到Deprecated API的具体位置和详情了。

方法二：永久配置到app模块的build.gradle（推荐） #

如果希望每次跑lint都自动显示详细的deprecated信息，直接修改app模块的build.gradle文件，在compileOptions块里添加编译器参数：

android {
    // 保留你原有的其他配置（比如compileSdk、defaultConfig等）
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8 // 根据你的项目Java版本调整
        targetCompatibility JavaVersion.VERSION_1_8
        // 添加这行启用deprecation的详细lint提示
        compilerArgs.add("-Xlint:deprecation")
    }
}

保存配置后，再执行./gradlew lint，就能看到完整的Deprecated API调用位置和说明信息了。

补充说明 #

lint任务执行时会自动触发Java编译过程，我们需要做的是告诉javac在编译阶段启用-Xlint:deprecation参数——这个参数会让javac输出所有使用或重写废弃API的具体代码位置，而不是只给一句模糊的提示。之前直接加参数失败，是因为把javac的参数当成了Gradle任务的配置参数，两者的作用对象完全不同。

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