Skip to content

Commit 3de8661

Browse files
authored
Merge pull request #1096 from marioguzzzman/update-build-docs-intellij-troubleshooting
Add IntelliJ troubleshooting tips to BUILD.md
2 parents 861e28f + 50bf7e5 commit 3de8661

3 files changed

+34
-0
lines changed
Loading
Loading

BUILD.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,3 +61,37 @@ The main task to run or debug the PDE is `run`. That means you just need to run
6161
If your main concern is with the `Core` you don't need to build and start the whole PDE to test your changes. In IntelliJ IDEA you can select any of the sketches in `core/examples/src/.../` to run by click on the green arrow next to their main functions. This will just compile core and the example sketch. Feel free to create additional examples for your new functionality.
6262

6363
## Other editors
64+
65+
## Troubleshooting and Setup Tips (IntelliJ IDEA)
66+
67+
If you’re building Processing using IntelliJ IDEA and something’s not working, here are a few things that might help:
68+
69+
### Use the Correct JDK (temurin-17)
70+
71+
Make sure IntelliJ is using **temurin-17**, not another version. Some users have reported issues with ms-17.
72+
73+
1. Go to **File > Project Structure > Project**
74+
2. Set the **Project SDK** to: `temurin-17 java version "17.0.15"`
75+
76+
![JDK Selection](.github/media/troubleshooting-Intellij-setting-djk-version-manually.png)
77+
78+
If it is not already installed, you can download it by:
79+
1. Clicking the SDK input field and then selecting the `Download JDK...` option from the menu
80+
2. Select Version: `17`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
81+
82+
83+
![JDK Download](.github/media/troubleshooting-Intellij-download-jdk.png)
84+
85+
Now go back to your main window and
86+
1. Click the green Run Icon in the top right of the window.
87+
88+
89+
### “Duplicate content roots detected”
90+
91+
You may see this warning in IntelliJ:
92+
93+
> `Duplicate content roots detected: '.../processing4/java/src'`
94+
95+
This happens because multiple modules reference the same source folder. It’s safe to ignore.
96+
97+

0 commit comments

Comments
 (0)