Trying to use ktlint in my Android app. Just found out about it recently and I read through the github.io page. It says "ktlint is a single binary with both linter & formatter included", but what I'm finding hard to understand is how to add it to my android project? I see that in getting started it has command line or gradle. I'm assuming since I have a default android project, I can just use gradle, but I'm still confused on why there are 3 plugins shown, and then a no plugin option. I'm not really sure what I'm looking for here, but maybe because I'm new it's going over my head. In my head, all I want is to run a linter during CI that gives me a report of all the broken rules + I want the IDE to tell me when I broke one of these (like android lint) or at least auto reformat code to these rules (cmd + shift + L in IntelliJ)

Hi Colton! There's no single right way to use ktlint, although most people do use one of the Gradle plugins listed in the readme. Those will generate the gradle tasks you can invoke locally or on CI to lint (and optionally format) your code.

Thanks for clarifying. I'm trying to use https://github.com/jlleitschuh/ktlint-gradle but the docs don't mention whether to put the plugin in my root build.gradle or my app build.gradle. Any help on that end?

I'm not actually sure (I develop in ktlint but don't have experience with the plugins.) @tapchicoma is one of the main contributors for that plugin, though, and tends to be quite responsive in this Slack.

Thanks. I'll wait for them to respond. Appreciate the help @Sha Sha Chu

👍

I have this in my root project and it works

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

  ktlint {
    version = "0.36.0"
    ignoreFailures = true

    reporters {
      reporter "checkstyle"
    }
  }
}

usually you want to apply

ktlint-gradle

to root project to have additional helper tasks like git hook integration or IDEA codestyle integration. Other then that what @Brais Gabin wrote is correct (maybe except

ignoreFailures

🙂 )

That’s true! I’m using ignoreFailures because I use QualityGate to check the reports later. But usually you don’t want

ignoreFailures

.

I would say git format hook is very convenient - saves some time on fixing codestyle after it failed on your CI. IDEA integration is not working so good though, would advice to generate

.editorconfig

with kotlin styling

Following the readme I ended up with this in the root of my android project:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    ext.kotlin_version = "1.3.70"
    repositories {
        google()
        jcenter()
        maven {
            url "<https://plugins.gradle.org/m2/>"
        }
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.0.0-beta02"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath "org.jlleitschuh.gradle:ktlint-gradle:9.2.1"

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

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

But when I run

./gradlew ktlintCheck

I don't get any report.

you've applied plugin only to the root project. You need to add:

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

Awesome. That worked! Thank you @tapchicoma!

1 It create custom codestyle scheme for kotlin. You could see it via Settings -> Editor -> CodeStyle -> Kotlin in Scheme dropdown. Though it has quite limited kotlin support. 2 -> ktlint rule issue 3 -> ktlint rule issue

For 2 and 3 (sorry, noob here with linters and stuff) does this mean I can just change the rule in the config?

2 -> rule implementation could not figure out how to autoformat properly. Could not recall rule name right now. 3 -> rule is missing for this. You could write your custom rule

Thank you Yahor!

@Colton Idle re #2: confusingly, there are actually 2 different versions of the indentation rule. there is one that’s in the standard ruleset that simply checks indentation but does not autoformat, and there is one in the experimental ruleset that can reformat, but it’s actually a pretty difficult thing to do correctly, which is why it’s still in experimental. on command line you enable the experimental rules via the

--experimental

flag, but i’m not 100% how to enable them via the plugin. #3 is likely a bug - feel free to file on github

I filed two bugs. Hopefully they are valid and simple enough to highlight whether it's just user error. Again, I'm very new to adding linters and when they can be used, so I'm really trying hard to make sense of all of this. In the end... all I want is my team to all reformat their kotlin code all the same way via IntelliJ and I want to be able to see a result of all of the "issues" in my CI. Hope that ktlint is the solution (although the intelliJ capabilities are maybe missing?)