# Lint


```
interface Lint
```

<br />

*** ** * ** ***

DSL object for configuring lint options. Example:

```
android {
   lint {
         // set to true to turn off analysis progress reporting by lint
         quiet = true
         // if true, stop the gradle build if errors are found
         abortOnError = false
         // set to true to have all release builds run lint on issues with severity=fatal
         // and abort the build (controlled by abortOnError above) if fatal issues are found
         checkReleaseBuilds = true
         // if true, only report errors
         ignoreWarnings = true
         // if true, emit full/absolute paths to files with errors (true by default)
         absolutePaths = true
         // if true, check all issues, including those that are off by default
         checkAllWarnings = true
         // if true, treat all warnings as errors
         warningsAsErrors = true
         // turn off checking the given issue id's
         disable += ['TypographyFractions', 'TypographyQuotes']
         // turn on the given issue id's
         enable += ['RtlHardcoded','RtlCompat', 'RtlEnabled']
         // check *only* the given issue id's
         checkOnly += ['NewApi', 'InlinedApi']
         // if true, don't include source code lines in the error output
         noLines = true
         // if true, show all locations for an error, do not truncate lists, etc.
         showAll = true
         // whether lint should include full issue explanations in the text error output
         explainIssues = false
         // Fallback lint configuration (default severities, etc.)
         lintConfig = file("default-lint.xml")
         // if true, generate a text report of issues (false by default)
         textReport = true
         // location to write the output; can be a file or 'stdout' or 'stderr'
         //textOutput 'stdout'
         textOutput file("$reportsDir/lint-results.txt")
         // if true, generate an XML report for use by for example Jenkins
         xmlReport true
         // file to write report to (if not specified, defaults to lint-results.xml)
         xmlOutput file("$reportsDir/lint-report.xml")
         // if true, generate an HTML report (with issue explanations, sourcecode, etc)
         htmlReport true
         // optional path to HTML report (default will be lint-results.html in the builddir)
         htmlOutput file("$reportsDir/lint-report.html")
         // if true, generate a SARIF report (OASIS Static Analysis Results Interchange Format)
         sarifReport true
         // optional path to SARIF report (default will be lint-results.sarif in the builddir)
         sarifOutput file("$reportsDir/lint-report.html")
         // Set the severity of the given issues to fatal (which means they will be
         // checked during release builds (even if the lint target is not included)
         fatal 'NewApi', 'InlineApi'
         // Set the severity of the given issues to error
         error 'Wakelock', 'TextViewEdits'
         // Set the severity of the given issues to warning
         warning 'ResourceAsColor'
         // Set the severity of the given issues to ignore (same as disabling the check)
         ignore 'TypographyQuotes'
         // Set the severity of the given issues to informational
         informational 'StopShip'
         // Use (or create) a baseline file for issues that should not be reported
         baseline file("lint-baseline.xml")
         // Normally most lint checks are not run on test sources (except the checks
         // dedicated to looking for mistakes in unit or instrumentation tests, unless
         // ignoreTestSources is true). You can turn on normal lint checking in all
         // sources with the following flag, false by default:
         checkTestSources true
         // Like checkTestSources, but always skips analyzing tests -- meaning that it
         // also ignores checks that have explicitly asked to look at test sources, such
         // as the unused resource check.
         ignoreTestSources true
         // Normally lint will skip generated sources, but you can turn it on with this flag
         checkGeneratedSources true
         // Whether lint should check all dependencies too as part of its analysis.
         // Default is false.
         checkDependencies true
    }
}
```

## Summary

| ### Public properties ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#abortOnError()` Whether lint should set the exit code of the process if errors are found |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#absolutePaths()` Whether lint should display full paths in the error output. |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#baseline()` The baseline file to use, if any. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkAllWarnings()` Whether lint should check all warnings, including those off by default |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkDependencies()` Whether lint should check all dependencies too as part of its analysis. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkGeneratedSources()` Returns whether lint should run checks on generated sources. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkOnly()` The exact set of issues to check set by `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkOnly()`. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkReleaseBuilds()` Whether lint should check for fatal errors during release builds. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkTestSources()` Whether lint should run all checks on test sources, instead of just the lint checks that have been specifically written to include tests (e.g. checks looking for specific test errors, or checks that need to consider testing code such as the unused resource detector) |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#disable()` The set of issue IDs to suppress. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#enable()` The set of issue IDs to enable. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#error()` Issues that have severity overridden to 'error' |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#explainIssues()` Whether lint should include explanations for issue errors. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#fatal()` Issues that have severity overridden to 'fatal' |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#htmlOutput()` The optional path to where an HTML report should be written. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#htmlReport()` Whether we should write an HTML report. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#ignore()` **This property is deprecated.** Ignore and disable are synonyms |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#ignoreTestFixturesSources()` Whether lint should ignore all testFixtures sources. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#ignoreTestSources()` Whether lint should ignore all test sources. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#ignoreWarnings()` Returns whether lint will only check for errors (ignoring warnings) |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#informational()` Issues that have severity overridden to 'informational' |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#lintConfig()` The default config file to use as a fallback. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#noLines()` Whether lint should include the source lines in the output where errors occurred (true by default) |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#quiet()` Whether lint should be quiet (for example, not write informational messages such as paths to report files written) |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#sarifOutput()` The optional path to where a SARIF report (OASIS Static Analysis Results Interchange Format) should be written. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#sarifReport()` Whether we should write a SARIF (OASIS Static Analysis Results Interchange Format) report. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#showAll()` Whether lint should include all output (e.g. include all alternate locations, not truncating long messages, etc.) |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textOutput()` The optional path to where a text report should be written. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textReport()` Whether lint should write a text report. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-set/index.html<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html>` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#warning()` Issues that have severity overridden to 'warning' |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#warningsAsErrors()` Whether lint should treat all warnings as errors |
| `https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html?` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#xmlOutput()` The optional path to where an XML report should be written. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#xmlReport()` Whether we should write an XML report. |

## Public properties

### abortOnError

```
var abortOnError: Boolean
```

Whether lint should set the exit code of the process if errors are found

### absolutePaths

```
var absolutePaths: Boolean
```

Whether lint should display full paths in the error output. By default the paths are relative to the path lint was invoked from.

### baseline

```
var baseline: File?
```

The baseline file to use, if any. The baseline file is an XML report previously created by lint, and any warnings and errors listed in that report will be ignored from analysis.

If you have a project with a large number of existing warnings, this lets you set a baseline and only see newly introduced warnings until you get a chance to go back and address the "technical debt" of the earlier warnings.

### checkAllWarnings

```
var checkAllWarnings: Boolean
```

Whether lint should check all warnings, including those off by default

### checkDependencies

```
var checkDependencies: Boolean
```

Whether lint should check all dependencies too as part of its analysis. Default is false.

### checkGeneratedSources

```
var checkGeneratedSources: Boolean
```

Returns whether lint should run checks on generated sources.

### checkOnly

```
val checkOnly: MutableSet<String>
```

The exact set of issues to check set by `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkOnly()`.

If empty, lint will detect the issues that are enabled by default plus any issues enabled via `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#enable()` and without issues disabled via `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#disable()`.

### checkReleaseBuilds

```
var checkReleaseBuilds: Boolean
```

Whether lint should check for fatal errors during release builds. Default is true. If issues with severity "fatal" are found, the release build is aborted.

### checkTestSources

```
var checkTestSources: Boolean
```

Whether lint should run all checks on test sources, instead of just the lint checks that have been specifically written to include tests (e.g. checks looking for specific test errors, or checks that need to consider testing code such as the unused resource detector)

### disable

```
val disable: MutableSet<String>
```

The set of issue IDs to suppress. Callers are allowed to modify this collection.

### enable

```
val enable: MutableSet<String>
```

The set of issue IDs to enable. Callers are allowed to modify this collection.

### error

```
val error: MutableSet<String>
```

Issues that have severity overridden to 'error'

### explainIssues

```
var explainIssues: Boolean
```

Whether lint should include explanations for issue errors. (Note that HTML and XML reports intentionally do this unconditionally, ignoring this setting.)

### fatal

```
val fatal: MutableSet<String>
```

Issues that have severity overridden to 'fatal'

### htmlOutput

```
var htmlOutput: File?
```

The optional path to where an HTML report should be written. Setting this property will also turn on `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#htmlReport()`.

### htmlReport

```
var htmlReport: Boolean
```

Whether we should write an HTML report. Default is true. The location can be controlled by `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#htmlOutput()`.

### ignore

```
val ignore: MutableSet<String>
```

> [!CAUTION]
> **This property is deprecated.**   
> Ignore and disable are synonyms

Issues that have severity overridden to 'ignore'

### ignoreTestFixturesSources

```
var ignoreTestFixturesSources: Boolean
```

Whether lint should ignore all testFixtures sources.

### ignoreTestSources

```
var ignoreTestSources: Boolean
```

Whether lint should ignore all test sources. This is like `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#checkTestSources()`, but always skips analyzing tests -- meaning that it also ignores checks that have explicitly asked to look at test sources, such as the unused resource check.

### ignoreWarnings

```
var ignoreWarnings: Boolean
```

Returns whether lint will only check for errors (ignoring warnings)

### informational

```
val informational: MutableSet<String>
```

Issues that have severity overridden to 'informational'

### lintConfig

```
var lintConfig: File?
```

The default config file to use as a fallback. This corresponds to a `lint.xml` file with severities etc to use when a project does not have more specific information.

### noLines

```
var noLines: Boolean
```

Whether lint should include the source lines in the output where errors occurred (true by default)

### quiet

```
var quiet: Boolean
```

Whether lint should be quiet (for example, not write informational messages such as paths to report files written)

### sarifOutput

```
var sarifOutput: File?
```

The optional path to where a SARIF report (OASIS Static Analysis Results Interchange Format) should be written. Setting this property will also turn on `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#sarifReport()`.

### sarifReport

```
var sarifReport: Boolean
```

Whether we should write a SARIF (OASIS Static Analysis Results Interchange Format) report. Default is false. The location can be controlled by `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#sarifOutput()`.

### showAll

```
var showAll: Boolean
```

Whether lint should include all output (e.g. include all alternate locations, not truncating long messages, etc.)

### textOutput

```
var textOutput: File?
```

The optional path to where a text report should be written.

To output the lint report to `stdout` set `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textReport()``=true`, and leave `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textOutput()` unset.

### textReport

```
var textReport: Boolean
```

Whether lint should write a text report.

With the default setting (`https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textReport()``=false`), the lint task will print a summary to `stdout` if there are any lint warnings or errors including a link to the full text report.

When `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textReport()``=true` and `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textOutput()` is unset, the full report will be printed by the lint task, rather than just a summary. When `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#textOutput()` is set, the full text report will be copied to the specified location.

### warning

```
val warning: MutableSet<String>
```

Issues that have severity overridden to 'warning'

### warningsAsErrors

```
var warningsAsErrors: Boolean
```

Whether lint should treat all warnings as errors

### xmlOutput

```
var xmlOutput: File?
```

The optional path to where an XML report should be written. Setting this property will also turn on `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#xmlReport()`.

### xmlReport

```
var xmlReport: Boolean
```

Whether we should write an XML report. Default is true. The location can be controlled by `https://developer.android.com/reference/tools/gradle-api/8.1/com/android/build/api/dsl/Lint#xmlOutput()`.