Emily Xiong b377c96d99
feat(java): add gradle kotlin plugin (#29464)
- [x] change init to create `createNodes` instead
- [x] unit tests
- [x] test-ci
- [x] test on windows
- [x] help metadata
- [x] external nodes

TODO:
- add publish executor?
- publish to maven central?

<!-- 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 -->
currently, it uses [project report
plugin](https://docs.gradle.org/current/userguide/project_report_plugin.html).
- pro: no need to maintain this plugin
- con: this plugin gives limited information

## Expected Behavior
<!-- This is the behavior we should expect with the changes in this PR
-->
change the project report plugin to @nxn/gradle/plugin-v1
now the @nx/gradle plugin will use project graph plugin
(dev.nx.gradle.project-graph) created in this pr.
this plugin will create json file that is exactly what nx project grpah
expected.

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

Fixes #
2025-04-23 13:13:25 -04:00

57 lines
688 B
Markdown

# 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
```bash
./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:
```bash
./gradlew nxProjectGraph -Phash=12345
```
It generates a json file to be consumed by nx:
```json
{
"nodes": {
"app": {
"targets": {}
}
},
"dependencies": [],
"externalNodes": {}
}
```