nx/packages/gradle/project-graph
Emily Xiong 624f0359e3
feat(gradle): add batch runner (#30457)
<!-- Please make sure you have read the submission guidelines before
posting an PR -->
<!--
https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr
-->

<!-- Please make sure that your commit message follows our format -->
<!-- Example: `fix(nx): must begin with lowercase` -->

<!-- If this is a particularly complex change or feature addition, you
can request a dedicated Nx release for this pull request branch. Mention
someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they
will confirm if the PR warrants its own release for testing purposes,
and generate it for you if appropriate. -->

## Current Behavior
<!-- This is the behavior we have today -->

Gradle tasks are run by invoking the Gradle CLI

## Expected Behavior
<!-- This is the behavior we should expect with the changes in this PR
-->

Gradle tasks are run through the Gradle Tooling API and is more
performant.

## Related Issue(s)
<!-- Please link the issue being fixed so it gets closed when this is
merged. -->

Fixes #

---------

Co-authored-by: Jason Jean <jasonjean1993@gmail.com>
2025-04-29 16:57:16 -04:00
..

dev.nx.gradle.project-graph

This gradle plugin contains

Installation

Kotlin build.gradle.kts

plugins {
    id("dev.nx.gradle.project-graph") version("+")
}

Groovy build.gradle

plugins {
    id "dev.nx.gradle.project-graph" version "+"
}

Usage

./gradlew nxProjectGraph

In terminal, it should output something like:

> Task :nxProjectGraph
< your workspace >/build/nx/add-nx-to-gradle.json

To pass in a hash parameter:

./gradlew nxProjectGraph -Phash=12345

It generates a json file to be consumed by nx:

{
  "nodes": {
    "app": {
      "targets": {}
    }
  },
  "dependencies": [],
  "externalNodes": {}
}