How to debug a Gradle build.gradle file (in a debugger, with breakpoints)?

Question

Is there a tool that will allow me to set breakpoints in a build.gradle file and step through tasks in a debugger?

Note: I believe that I\'m asking a different ques

Answer 1

IntelliJ 2018.2 added the ability to debug Gradle scripts in a similar fashion to how you might run/debug other projects. You can see the announcement in the release notes here.

Here is a screenshot of some of the documentation from 2018.2:

It does not yet support the kotlin-dsl (see gradle/kotlin-dsl/issues/39).

Answer 2

Personnaly I do this when I need to debug build scripts:

Inside you terminal do

export GRADLE_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"

Then run your build

gradle clean install

Finally put some breakpoints and launch the remote debug configuration inside your IDE on the port 5005 and you’re good to go!

Answer 3

There is the easier way:

just add in your command line -Dorg.gradle.debug=true --no-daemon

For example: gradle nameOfTask -Dorg.gradle.debug=true --no-daemon

Then you should start your IDE and run remote debugging with localhost port 5005, that all.

Gradle is waiting to you, because standard option server=y

org.gradle.debug

When set to true, Gradle will run the build with remote debugging enabled, listening on port 5005. Note that this is the equivalent of adding -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005 to the JVM command line and will suspend the virtual machine until a debugger is attached.

Link to docs

Answer 4

export GRADLE_OPTS does not work for me.

Try this:

1 Add remote debug config

2 add breakpoint in gradle

3 ./gradlew your task --stacktrace -Dorg.gradle.daemon=false -Dorg.gradle.debug=true

4 Attach debug in studio

Then the breakpoint stops !!

Answer 5

After reading various answers here the following steps will help you debug build.gradle to being able to break and investigate variables inside any custom task. I am using Eclipse remote debugging facilities

1. Place this simple code where you want to break: try {throw new RuntimeException('Break');} catch (RuntimeException e) {}
2. As recommended start your task with gradle mytask -Dorg.gradle.debug=true --no-daemon in the command prompt (don't have to do it in Eclipse)
3. In Eclipse do Run -> Add Java Exception Breakpoint, choose RuntimeException and click "OK"
4. Again in Eclipse go to Run -> Debug Configurations -> Remote Java Application and create new configuration that listens on localhost:5005. Name it whatever you want. Select a project that contains build.gradle you are debugging. Click Apply and Debug
5. At this point the execution will start but will pause at the Exception-throwing line. And you can then start looking at your variables in the `Debug -> Variables" view, inspect the stacktrace, step through the code etc.
6. No magic, alas, you will not see anything highlighted in build.gradle but you can pretty much guess where you are at
7. Obviously on subsequent runs you don't need step 3 and in 4 you can reuse previously created configuration
8. If you want to use this in the multiple places simply create a method, use different type of exception and feel free to enhance this idea in any way possible

For example:

void halt() {
    try {
        throw new RuntimeException('Break');
    } catch (RuntimeException e) {
        print('Paused')
    }
}

task iterateDeclaredDependencies {
    doLast {        
        Object configs = configurations.all
        halt();
        print(configs)
    }
}