Android项目中如何标记未使用导入并终止构建？

一、修复Android Lint的未使用导入检测 #

你之前的问题是用错了Lint规则ID——Java和Kotlin的未使用导入对应不同的规则ID，且默认规则中这些检测可能未被设为错误级别。

正确的lint.xml配置 #

在项目根目录或模块目录下创建lint.xml，配置对应规则为错误级别：

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Java文件未使用导入检测 -->
    <issue id="UnusedImport" severity="error" />
    <!-- Kotlin文件未使用导入检测 -->
    <issue id="KotlinUnusedImport" severity="error" />
</lint>

补充Gradle配置检查 #

确保你的subprojects配置中没有禁用上述规则，现有配置无需修改，但需注意：

• 如果使用了lint-baseline.xml基线文件，需删除旧文件后重新运行./gradlew lintDebug生成新基线，避免基线忽略未使用导入的检测。
• 你的lintOptions中已经设置了abortOnError true和warningsAsErrors true，只要规则触发错误，构建会自动终止。

验证效果 #

执行./gradlew lintDebug，若代码中存在未使用导入，Lint会抛出错误并终止构建。

二、使用ktlint替代方案 #

如果你需要更严格的代码风格检查或更简洁的配置，ktlint是合适的选择：

配置ktlint插件 #

在项目根目录的build.gradle中添加：

plugins {
    id "org.jlleitschuh.gradle.ktlint" version "11.0.0" // 适配Gradle 7.3.3
}

subprojects {
    apply plugin: "org.jlleitschuh.gradle.ktlint"

    ktlint {
        version.set("0.47.1")
        ignoreFailures.set(false) // 检测到错误直接终止构建
        reporters {
            reporter "plain"
            reporter "html" // 生成HTML格式报告
        }
    }

    // 绑定编译任务，编译前自动执行ktlint检查
    tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
        dependsOn tasks.named("ktlintCheck")
    }
}

检测未使用导入 #

ktlint默认会检测Kotlin的未使用导入，若需支持Java文件检测，可额外配置ktlint的Java规则（需依赖google-java-format）。执行./gradlew ktlintCheck或直接编译项目，未使用导入会触发错误并终止构建。

三、关键注意事项 #

• 若保留Lint基线，需重新生成基线文件，避免历史遗留的未使用导入被忽略。
• ktlint插件版本需与Gradle 7.3.3兼容，上述配置的版本已适配。

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