使用 Xlint：在 Android 中弃用

Question

因此，当我编译 Android 应用程序时，我几乎总是收到这样的消息：

[javac] Note: /home/kurtis/sandbox/udj/androidApp/src/org/klnusbaum/udj/PlaylistFragment.java uses or overrides a deprecated API.
[javac] Note: Recompile with -Xlint:deprecation for details.

如何使用此选项重新编译？我必须在 build.xml 中编辑某些内容吗？

Answer 1

这些属性也可以在 Ant 命令行上定义，避免编辑：

ant "-Djava.compilerargs=-Xlint:unchecked -Xlint:deprecation" debug

要启用所有 Lint 警告：

ant - djava.compilerargs=-Xlint 调试

Answer 2

甚至更简单，无需复制完整的 javac 目标：将以下行放入 ant.properties 文件中：

java.compilerargs=-Xlint:unchecked

这样，它只需覆盖 Android SDK 默认构建配置中的 java.compilerargs 即可。 （顺便说一句，您可以自己检查默认情况下它是空的）。 SDK 更新不会造成混乱，可能会在不通知您的项目的情况下更改默认 javac 目标。

只是一种更细粒度的方法！ :)

Answer 3

是的，根据 build.xml 文件中的以下声明，如果您想要...

         - Customize only one target:
             - copy/paste the target into this file, *before* the
               <setup/> task.
             - customize it to your needs.

这意味着：

1. 转到 $ANDROID_SDK_ROOT/tools/ant/main_rules.xml 文件并复制“编译”目标。

2. 将其粘贴到 build.xml 文件中的 之前。

3. 然后将以下元素添加到任务中：

4. 同样，您可以添加其他编译器选项，例如未检查的操作：

Answer 4

看起来您应该只能在项目文件夹根目录的 build.properties 或 ant.properties 中指定选项。我尝试了这个，但似乎不起作用。
我想避免编辑 build.xml 文件，因为如果您需要更新项目，这会在以后增加复杂性。但是，我无法找到解决方法。但是，我没有复制整个 compile 目标，而是

<property name="java.compilerargs" value="-Xlint:unchecked" />

在文件底部的 import 行之前添加了：。

Answer 5

如果你想拥有一个良好的 CI + CD 管道并且你关心你的代码质量，显示有关 lint 抱怨的更多信息的一个好选择是将其添加到你的 top/root gradle.build 中：

subprojects {
  gradle.projectsEvaluated {
    tasks.withType(JavaCompile) {
      options.compilerArgs += [
        '-Xlint:unchecked', // Shows information about unchecked or unsafe operations.
        '-Xlint:deprecation', // Shows information about deprecated members.
      ]
    }
  }
}

或者

subprojects {
  gradle.projectsEvaluated {
    tasks.withType(JavaCompile) {
      options.compilerArgs << "-Xlint:unchecked" << "-Xlint:deprecation"
    }
  }
}

如果你只想添加一个选项（您通常会添加更多），在任务 JavaCompile 中，您只需添加：

options.compilerArgs << "-Xlint:unchecked"

It's 2018，您可以依靠 Gradle 来设置它。我只添加了两个编译器参数选项，但还有更多。您可以在此处和此处。