Build.gradle: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
=External=
* https://docs.gradle.org/current/userguide/writing_build_scripts.html


=Internal=
* [[Gradle_Concepts#Configuration_Scripts_and_Core_Types|Gradle Concepts]]
* [[Gradle Project#Overview|Project]]


=Overview=
build.gradle is referred to as an Gradle build script. It is the script interface to a [[Gradle_Project#Project_API_and_build.gradle_DSL|Project instance]].


==configurations==
=Example=
 
<syntaxhighlight lang='groovy'>
<syntaxhighlight lang='groovy'>
configurations {
    testCompile.exclude group: 'io.example'
}
</syntaxhighlight>


==buildscript==
apply plugin: 'java'


Used when [[Gradle Gradle_Concepts_ToDeplete#External_Plugins|external plugins]] need to be downloaded.
// name comes from the directory name or it can be changed in settings.gradle
group = "playground.example"
version = "0.1.0"
description = "A Gradle example project"


<syntaxhighlight lang='groovy'>
repositories {
buildscript {
     mavenLocal()
    repositories {
     mavenCentral()
        maven { url 'https://plugins.gradle.org/m2/' }
     }
  dependencies {
     classpath 'com.netflix.nebula:gradle-ospackage-plugin:4.3.0'
  }
}
}
</syntaxhighlight>


==<span id='Repositories'></span>repositories==
dependencies {
    implementation 'org.slf4j:slf4j-api:1.7.12'
    testImplementation 'junit:junit:4.+'
}


{{External|https://docs.gradle.org/current/userguide/declaring_repositories.html}}
configurations {
    testImplementation.exclude group: 'com.example'
}


[[Gradle_Concepts_ToDeplete#Repository|Repositories]] are declared in a 'repositories' block:
configurations.all {
    resolutionStrategy.cacheChangingModulesFor 3600, 'seconds'
}


<syntaxhighlight lang='groovy'>
compileJava {
repositories {
     options.compilerArgs += ['-Xlint']
     ...
}
}
</syntaxhighlight>
Multiple repositories can be declared in the same block. Syntax examples are available for [[Gradle_Concepts_ToDeplete#Custom_Maven_Repository|custom Maven repositories]], [[Gradle_Concepts_ToDeplete#flatDir|directory-based repositories]], [[Gradle_Concepts_ToDeplete#Maven_Central|Maven Central]], etc. The most common setting is declaring that our dependencies are available in Maven Central:


<syntaxhighlight lang='groovy'>
javadoc {
repositories {
    options.charSet = 'UTF-8'
    mavenCentral()
}
}
</syntaxhighlight>


=Multi-Project Configuration=
task runMain(type: JavaExec) {
 
    classpath = sourceSets.main.runtimeClasspath
==allprojects==
    main = "io.novaordis.playground.gradle.java.Main"
 
The <tt>allprojects</tt> block is used to add configuration items that will apply to all [[Gradle_Concepts_ToDeplete#Multi-Project_Build|sub-projects]], as well as the root project.
 
<syntaxhighlight lang='groovy'>
allprojects {
  repositories {
    ...
  }
}
}
</syntaxhighlight>
</syntaxhighlight>


"allprojects" is a property that contains a list with the current project and all its subprojects underneath it. It can be called with a closure, and the statements of the closure are delegated to the projects.
=Comments=
 
==subprojects==
 
The <tt>subprojects</tt> block is used to add configuration times for sub-projects only.


<syntaxhighlight lang='groovy'>
<syntaxhighlight lang='groovy'>
subprojects {
// This is a comment
    ...
}
</syntaxhighlight>
</syntaxhighlight>


=Respond to Build Lifecycle Events=
=Code=
 
Example of how to respond to [[Gradle_Concepts_ToDeplete#Build_Phases|project build lifecycle events]].


The build script may include general-purpose Java and Groovy code:
<syntaxhighlight lang='groovy'>
<syntaxhighlight lang='groovy'>
allprojects {
      afterEvaluate { project ->
          if (project.hasTests) {
              println "Adding test task to $project"
              project.task('test') {
                  doLast {
                        println "running tests for $project"
                  }
              }
          }
    }
}
</syntaxhighlight>


<syntaxhighlight lang='groovy'>
class Experimental {
gradle.afterProject {project, projectState ->
      if (projectState.failure) {
          println "Evaluation of $project FAILED"
      } else {
          println "Evaluation of $project succeeded"
      }
}
</syntaxhighlight>


=Respond to Task Lifecycle Events=
    private String name;


Examples of how to respond to [[Gradle_Concepts_ToDeplete#Task|task]] lifecycle events.
    Experimental(String name) {


==Task Creation==
        this.name = name;
    }


<syntaxhighlight lang='groovy'>
    @Override
tasks.whenTaskAdded { task ->
    public String toString() {
      task.ext.srcDir = 'src/main/java'
        return name;
    }
}
}
</syntaxhighlight>


==Task Execution==
def experimental = new Experimental("blue");


<syntaxhighlight lang='groovy'>
task test {
gradle.taskGraph.beforeTask { Task task ->
    doLast {
      println "executing $task ..."
        println experimental
    }
}
}
gradle.taskGraph.afterTask { Task task, TaskState state ->
</syntaxhighlight>
      if (state.failure) {
          println "FAILED"
      }
      else {
          println "done"
      }
}</syntaxhighlight>

Latest revision as of 22:10, 11 October 2020

External

Internal

Overview

build.gradle is referred to as an Gradle build script. It is the script interface to a Project instance.

Example

apply plugin: 'java'

// name comes from the directory name or it can be changed in settings.gradle
group = "playground.example"
version = "0.1.0"
description = "A Gradle example project"

repositories {
    mavenLocal()
    mavenCentral()
}

dependencies {
    implementation 'org.slf4j:slf4j-api:1.7.12'
    testImplementation 'junit:junit:4.+'
}

configurations {
    testImplementation.exclude group: 'com.example'
}

configurations.all {
    resolutionStrategy.cacheChangingModulesFor 3600, 'seconds'
}

compileJava {
    options.compilerArgs += ['-Xlint']
}

javadoc {
    options.charSet = 'UTF-8'
}

task runMain(type: JavaExec) {
    classpath = sourceSets.main.runtimeClasspath
    main = "io.novaordis.playground.gradle.java.Main"
}

Comments

// This is a comment

Code

The build script may include general-purpose Java and Groovy code:

class Experimental {

    private String name;

    Experimental(String name) {

        this.name = name;
    }

    @Override
    public String toString() {
        return name;
    }
}

def experimental = new Experimental("blue");

task test {
    doLast {
        println experimental
    }
}