Skip to content

Commit 9ae1d01

Browse files
committed
Update docs.
1 parent a596ad2 commit 9ae1d01

File tree

1 file changed

+38
-14
lines changed

1 file changed

+38
-14
lines changed

BUILD.md

Lines changed: 38 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ First, [download the IntelliJ IDEA Community Edition](https://www.jetbrains.com/
1212
1. Clone the Processing4 repository to your machine locally
1313
1. Open the cloned repository in IntelliJ IDEA CE
1414
1. When prompted, select **Trust Project**. You can preview the project in Safe Mode but you won't be able to build Processing.
15-
1. IntelliJ may ask if you want to load Gradle project. If you allow this, make sure you are using JDK version 17.
15+
1. IntelliJ may ask if you want to load Gradle project. If you allow this, make sure you are using JDK version 25.
1616
1. In the main menu, go to File > Project Structure > Project Settings > Project.
17-
1. In the SDK Dropdown option, select a JDK version 17 or Download the jdk
17+
1. In the SDK Dropdown option, select a JDK version 25 or Download the jdk
1818
1. Click the green Run Icon in the top right of the window. This is also where you can find the option to debug Processing.
1919
1. Logs can be found in the `Build` or `Debug` pane on the bottom left of the window
2020

@@ -46,18 +46,43 @@ If you don't have them installed, you will need to install [Git](https://git-scm
4646
cd processing4
4747
```
4848

49-
2. **Install Temurin JDK 17:**
50-
51-
Download and install the appropriate version for your platform:
49+
2. **Install Temurin JDK 25:**
50+
51+
Processing requires the Temurin distribution of OpenJDK.
5252

53-
- [Linux (x86)](https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.15%2B6/OpenJDK17U-jdk_x64_linux_hotspot_17.0.15_6.tar.gz)
54-
- [macOS (Apple Silicon)](https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.15%2B6/OpenJDK17U-jdk_aarch64_mac_hotspot_17.0.15_6.pkg)
55-
- [Other platforms](https://adoptium.net/temurin/releases/?package=jdk&version=17&os=any&arch=any)
53+
You can download it from [Adoptium](https://adoptium.net/), from [GitHub releases](https://github.com/adoptium/temurin25-binaries/releases),
54+
or find it in the package manager for your platform.
55+
56+
### macOS:
57+
```bash
58+
brew install --cask temurin@25
59+
````
60+
61+
### Windows (using winget):
62+
```bash
63+
winget install --id=EclipseAdoptium.Temurin.25.JDK -e
64+
```
65+
66+
### SDKMAN!
67+
68+
[SDKMAN!](https://sdkman.io/) is a useful tool for developers working on multiple versions of the JVM.
69+
70+
## Install `jextract`
71+
72+
`jextract` is a tool included in the JDK that generates Java bindings from C header files.
73+
It is required to build Processing when using WebGPU. You can download it [here](https://jdk.java.net/jextract/)
74+
or install it using SDKMAN!:
75+
76+
```bash
77+
sdk install jextract
78+
````
5679

5780
3. **Set the `JAVA_HOME` environment variable:**
5881

82+
It may be necessary to set the `JAVA_HOME` environment variable to point to your Temurin JDK 25 installation.
83+
5984
```bash
60-
export JAVA_HOME=/path/to/temurin/jdk-17.0.15+6/
85+
export JAVA_HOME=/path/to/temurin/jdk-25/
6186
```
6287

6388
### Build, Run, and Package Processing
@@ -136,26 +161,25 @@ If you are specifically trying to run the `Processing CLI`, you can test command
136161
137162
If you’re building Processing using IntelliJ IDEA and something’s not working, here are a few things that might help:
138163
139-
### Use the Correct JDK (temurin-17)
164+
### Use the Correct JDK (temurin-25)
140165
141-
Make sure IntelliJ is using **temurin-17**, not another version. Some users have reported issues with ms-17.
166+
Make sure IntelliJ is using **temurin-25**, not another version.
142167
143168
1. Go to **File > Project Structure > Project**
144-
2. Set the **Project SDK** to: `temurin-17 java version "17.0.15"`
169+
2. Set the **Project SDK** to: `temurin-25"`
145170
146171
![JDK Selection](.github/media/troubleshooting-Intellij-setting-djk-version-manually.png)
147172
148173
If it is not already installed, you can download it by:
149174
1. Clicking the SDK input field and then selecting the `Download JDK...` option from the menu
150-
2. Select Version: `17`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
175+
2. Select Version: `25`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
151176
152177
153178
![JDK Download](.github/media/troubleshooting-Intellij-download-jdk.png)
154179
155180
Now go back to your main window and
156181
1. Click the green Run Icon in the top right of the window.
157182
158-
159183
### “Duplicate content roots detected”
160184
161185
You may see this warning in IntelliJ:

0 commit comments

Comments
 (0)