[[third_party_integration]]
= Gradle & Third-party Tools

Gradle can be integrated with many different third-party tools such as IDEs and continuous integration platforms. Here we look at some of the more common ones as well as how to integrate your own tool with Gradle.

[[ides]]
== IDEs

Android Studio::

plugins {
    id("gradlebuild.distribution.api-java")
}

description = "Plugins and model builders for integration with Eclipse and IntelliJ IDEs"

errorprone {
    disabledChecks.addAll(
        "EmptyBlockTag", // 1 occurrences
        "LoopOverCharArray", // 1 occurrences
        "ObjectEqualsForPrimitives", // 3 occurrences
        "StringCaseLocaleUsage", // 2 occurrences
    )
}

dependencies {
    api(project(":base-services"))

._*

# OSX trash
.DS_Store

# Developers can store local stuff in dirs named __something
__*

# Eclipse files
.classpath
.project
.settings/**

# Files generated by JetBrains IDEs, e.g. IntelliJ IDEA
.idea/
*.iml

# Vscode files
.vscode

# This is where the result of the go build goes
/output*/
/_output*/
/_output

# Emacs save files
*~
\#*\#
.\#*

            module(aid) {
                version(v, spec)
            }
        }
    }

    /**
     * Use {@link #id} when possible since it doesn't rely on {@code methodMissing} and integrates better with IDEs.
     */
    void methodMissing(String name, args) {
        def (gid, aid, v) = name.split(':') as List
        Closure spec = {}
        if (args && args.length == 1 && args[0] instanceof Closure) {

import java.nio.file.Files
import java.nio.file.Path
import java.nio.file.Paths

/**
 * Tests that runs a project import to IDEA, with an provisioning of the desired version.
 *
 * Provisioned IDEs are cached in the {@link AbstractIdeaSyncTest#getIdeHome} directory.
 */
@Timeout(600)
@CleanupTestDirectory
abstract class AbstractIdeaSyncTest extends Specification {

    @Rule

<6> Source code and/or additional files for the projects

== Invoking Gradle

=== IDE

Gradle is <<gradle_ides.adoc#gradle_ides,built-in to many IDEs>> including Android Studio, IntelliJ IDEA, Visual Studio Code, Eclipse, and NetBeans.

Gradle can be automatically invoked when you build, clean, or run your app in the IDE.

[plugins]
androidApplication = { id = "com.android.application", version.ref = "androidGradlePlugin" }
----

The file is located in the `gradle` directory so that it can be used by Gradle and IDEs automatically.
The version catalog should be checked into source control: `gradle/libs.versions.toml`.

== Declaring Your Dependencies

#### Enterprise integration

Provides cross-cutting integration with Gradle's commercial product.

#### IDE integration

Provides cross-cutting integration with IDEs and other tooling.

#### Build infrastructure

Provides build logic, libraries, test suites and infrastructure to support developing and releasing Gradle.

#### Documentation

// TODO unfortunately the plugins need to be downloaded in order to get the plugin.xml file. need to externalize this
//      from the plugin archive.
// TODO this will be the class that people get in IDEs to modify

/**
 * MavenExecutionPlan
 */
public class MavenExecutionPlan implements Iterable<ExecutionPlanItem> {

    /*

### Enterprise integration

Provides cross-cutting integration with Gradle's commercial product.

### IDE integration

Provides cross-cutting integration with IDEs and other tooling.

### Build infrastructure

Provides build logic, libraries, test suites and infrastructure to support developing and releasing Gradle.

### Documentation