🐘 Gradle build job

## Objective

This job allows you to build your 🐘 Gradle project using a script (`build` by default)

from your `build.gradle.kts` or `build.gradle` file.

## How to use it

1. Ensure that your project have

   [`build.gradle.kts`](https://docs.gradle.org/current/samples/sample_building_java_applications.html){:target="_blank"} 

   file

1. Add this job URL inside the `include` list of your `.gitlab-ci.yml` file (see the [quick setup](/use-the-hub/#quick-setup)). You can specify [a fixed version](#changelog) instead of `latest`.

    ```yaml

      - remote: 'https://jobs.r2devops.io/latest/gradle_build.yml'

    ```

1. Well done, your job is ready to work ! 😀

🔗 Here is an example of a complete pipeline using this step : [fun_with_gitlab-ci](https://gitlab.com/fun_with/fun-with-gitlab-ci/-/blob/master/.gitlab-ci.yml)

## Job details

* Job name: `gradle_build`

* Default stage: `build`

* Docker image: [`gradle:jdk11`](https://hub.docker.com/_/gradle){:target="_blank"}

* When: `always`

### Variables

| Name | Description | Default |

| ---- | ----------- | ------- |

### Example of build.gradle.kts file

Following example of `build.gradle.kts` file describes a very simple example of project configuration.

This can easily be generated with the `gradle init` command.

***For a Java project***

```kotlin

import org.gradle.api.JavaVersion.VERSION_11

plugins {

    java

}

group = "io.r2devops"

version = "1.0.0-SNAPSHOT"

java.sourceCompatibility = VERSION_11

java.targetCompatibility = VERSION_11

repositories {

    jcenter()

    mavenCentral()

}

```

***For a Kotlin project***

```kotlin

import org.gradle.api.JavaVersion.VERSION_11

plugins {

    id("org.jetbrains.kotlin.jvm") version "1.4.21"

}

group = "io.r2devops"

version = "1.0.0-SNAPSHOT"

java.sourceCompatibility = VERSION_11

java.targetCompatibility = VERSION_11

kotlin.target { VERSION_11 }

repositories {

    jcenter()

    mavenCentral()

}

dependencies {

    // Align versions of all Kotlin components

    implementation(platform("org.jetbrains.kotlin:kotlin-bom"))

    // Use the Kotlin JDK 8 standard library.

    implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8")

    // Use the Kotlin test library.

    testImplementation("org.jetbrains.kotlin:kotlin-test")

    // Use the Kotlin JUnit integration.

    testImplementation("org.jetbrains.kotlin:kotlin-test-junit")

}

```

 No newline at end of file

# Job from R2Devops hub --> r2devops.io

stages:

  - build

# Compilation step

gradle_build:

  stage: build

  image: gradle:jdk11

  script: gradle --build-cache assemble

  cache:

    key: "$CI_COMMIT_REF_NAME"

    policy: pull-push

    paths:

      - build

      - .gradle

  artifacts:

    paths:

      - build/libs/*.jar

    expire_in: 1 week

 No newline at end of file

name: gradle_build

description: Build your application with Gradle 🐘

default_stage: build

icon: 🐘

maintainer: yodamad

license: MIT

images:

  "gradle": "jdk11"

tools:

  "Gradle": "$GRADLE_VERSION"

labels:

    - GitLab

    - Gradle

    - Build

* 🐘 Initial version 🎉 

 No newline at end of file