Android Kotlin在GitLab CI中实现Lint报错失败且生成报告

要实现Lint报错时终止构建，同时生成报告的需求，需要从Gradle配置和GitLab CI配置两方面入手：

1. 配置Gradle的Lint规则 #

在Android项目的模块（通常是app）的build.gradle.kts（或build.gradle）中调整lint配置，核心是开启失败时强制生成报告的选项：

Kotlin DSL（build.gradle.kts）示例： #

android {
    lint {
        // 发现Lint错误时终止构建
        abortOnError = true
        // 开启所有警告检查（按需开启，也可单独指定规则）
        checkAllWarnings = true
        // 关键：即使构建失败，也要生成Lint报告
        generateReportOnError = true
        // 启用HTML格式报告（可读性强）
        htmlReport = true
        // 可选：启用XML格式报告（方便CI工具解析）
        xmlReport = true
        // 指定报告输出目录（默认路径也可，这里是自定义示例）
        htmlOutput = file("$buildDir/reports/lint/lint-results.html")
        xmlOutput = file("$buildDir/reports/lint/lint-results.xml")
    }
}

Groovy DSL（build.gradle）示例： #

android {
    lintOptions {
        abortOnError true
        checkAllWarnings true
        generateReportOnError true
        htmlReport true
        xmlReport true
        htmlOutput file("$buildDir/reports/lint/lint-results.html")
        xmlOutput file("$buildDir/reports/lint/lint-results.xml")
    }
}

2. 配置GitLab CI Job #

在项目根目录的.gitlab-ci.yml中定义Lint检查Job，并配置无论构建成功/失败都保留报告：

lint:
  stage: test
  # 使用合适的Android构建镜像，比如官方Android SDK镜像或带Gradle的镜像
  image: gradle:7.5-jdk11
  before_script:
    - chmod +x ./gradlew
  script:
    # 执行对应变体的Lint检查，比如lintDebug或lintRelease
    - ./gradlew lintDebug
  artifacts:
    # 指定报告文件的路径
    paths:
      - app/build/reports/lint/
    # 报告保留时间，按需调整
    expire_in: 1 week
    # 关键：无论Job成功还是失败，都上传报告
    when: always

关键说明 #

• generateReportOnError = true是Gradle配置的核心，默认情况下Lint失败时不会生成报告，开启这个选项后会强制生成。
• GitLab CI的when: always确保即使构建因Lint错误失败，报告也会被作为Artifacts保存，你可以在GitLab的Job页面下载查看具体错误详情。

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