From adc714360579f4a58726be7f8eb5bf01a709cbb9 Mon Sep 17 00:00:00 2001 From: liferoad Date: Mon, 4 Nov 2024 09:55:06 -0500 Subject: [PATCH 1/2] Update code-change-guide.md --- contributor-docs/code-change-guide.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/contributor-docs/code-change-guide.md b/contributor-docs/code-change-guide.md index f0785d3509d0..efb57973592e 100644 --- a/contributor-docs/code-change-guide.md +++ b/contributor-docs/code-change-guide.md @@ -115,6 +115,8 @@ To run a Gradle task, use the command `./gradlew -p ` or th ./gradlew :sdks:java:harness:test ``` +**It is recommended to run `./gradlew clean` if you run into some strange errors such as `java.lang.NoClassDefFoundError`.** + #### Beam-specific Gradle project configuration For Apache Beam, one plugin manages everything: `buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin`. @@ -145,7 +147,7 @@ in the Google Cloud documentation. Depending on the languages involved, your `PATH` file needs to have the following elements configured. -* A Java environment that uses a supported Java version, preferably Java 8. +* A Java environment that uses a supported Java version, preferably Java 11. * This environment is needed for all development, because Beam is a Gradle project that uses JVM. * Recommended: To manage Java versions, use [sdkman](https://sdkman.io/install). From beba671ad98543015144dbbdeadd19c22200f135 Mon Sep 17 00:00:00 2001 From: liferoad Date: Mon, 4 Nov 2024 10:51:30 -0500 Subject: [PATCH 2/2] Update code-change-guide.md --- contributor-docs/code-change-guide.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/contributor-docs/code-change-guide.md b/contributor-docs/code-change-guide.md index efb57973592e..b4300103454c 100644 --- a/contributor-docs/code-change-guide.md +++ b/contributor-docs/code-change-guide.md @@ -115,8 +115,6 @@ To run a Gradle task, use the command `./gradlew -p ` or th ./gradlew :sdks:java:harness:test ``` -**It is recommended to run `./gradlew clean` if you run into some strange errors such as `java.lang.NoClassDefFoundError`.** - #### Beam-specific Gradle project configuration For Apache Beam, one plugin manages everything: `buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin`. @@ -626,6 +624,11 @@ Tips for using the Dataflow runner: ## Appendix +### Common Issues + +* If you run into some strange errors such as `java.lang.NoClassDefFoundError`, run `./gradlew clean` first +* To run one single Java test with gradle, use `--tests` to filter, for example, `./gradlew :it:google-cloud-platform:WordCountIntegrationTest --tests "org.apache.beam.it.gcp.WordCountIT.testWordCountDataflow"` + ### Directories of snapshot builds * https://repository.apache.org/content/groups/snapshots/org/apache/beam/ Java SDK build (nightly)