Skip to content

Commit 079b879

Browse files
committed
Fixup docs.
1 parent 67ac864 commit 079b879

1 file changed

Lines changed: 31 additions & 16 deletions

File tree

‎BUILD.md‎

Lines changed: 31 additions & 16 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 25.
15+
1. IntelliJ may ask if you want to load Gradle project. If you allow this, make sure you are using JDK version 17.
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 25 or Download the jdk
17+
1. In the SDK Dropdown option, select a JDK version 17 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,43 +46,58 @@ 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 25:**
49+
2. **Install Temurin JDK 17:**
5050

5151
Processing requires the Temurin distribution of OpenJDK.
5252

53-
You can download it from [Adoptium](https://adoptium.net/), from [GitHub releases](https://github.com/adoptium/temurin25-binaries/releases),
53+
You can download it from [Adoptium](https://adoptium.net/), from [GitHub releases](https://github.com/adoptium/temurin17-binaries/releases),
5454
or find it in the package manager for your platform.
5555

5656
### macOS:
5757
```bash
58-
brew install --cask temurin@25
58+
brew install --cask temurin@17
5959
````
6060
6161
### Windows (using winget):
6262
```bash
63-
winget install --id=EclipseAdoptium.Temurin.25.JDK -e
63+
winget install --id=EclipseAdoptium.Temurin.17.JDK -e
6464
```
6565

6666
### SDKMAN!
6767

6868
[SDKMAN!](https://sdkman.io/) is a useful tool for developers working on multiple versions of the JVM.
6969

70-
## Install `jextract`
70+
## WebGPU Support (Optional)
7171

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!:
72+
To build Processing with the experimental WebGPU renderer, you need JDK 24+, Rust, and jextract.
73+
74+
### Install Temurin JDK 24
75+
76+
```bash
77+
brew install --cask temurin@24 # macOS
78+
```
79+
80+
### Install `jextract`
81+
82+
`jextract` generates Java bindings from C header files.
83+
You can download it [here](https://jdk.java.net/jextract/) or install it using SDKMAN!:
7584

7685
```bash
7786
sdk install jextract
7887
````
7988

89+
### Build with WebGPU
90+
91+
```bash
92+
./gradlew build -PenableWebGPU=true
93+
```
94+
8095
3. **Set the `JAVA_HOME` environment variable:**
8196

82-
It may be necessary to set the `JAVA_HOME` environment variable to point to your Temurin JDK 25 installation.
97+
It may be necessary to set the `JAVA_HOME` environment variable to point to your Temurin JDK installation.
8398

8499
```bash
85-
export JAVA_HOME=/path/to/temurin/jdk-25/
100+
export JAVA_HOME=/path/to/temurin/jdk-17/
86101
```
87102

88103
### Build, Run, and Package Processing
@@ -161,18 +176,18 @@ If you are specifically trying to run the `Processing CLI`, you can test command
161176
162177
If you’re building Processing using IntelliJ IDEA and something’s not working, here are a few things that might help:
163178
164-
### Use the Correct JDK (temurin-25)
179+
### Use the Correct JDK (temurin-17)
165180
166-
Make sure IntelliJ is using **temurin-25**, not another version.
181+
Make sure IntelliJ is using **temurin-17**, not another version. If building with WebGPU (`-PenableWebGPU=true`), use **temurin-24** instead.
167182
168183
1. Go to **File > Project Structure > Project**
169-
2. Set the **Project SDK** to: `temurin-25"`
184+
2. Set the **Project SDK** to: `temurin-17`
170185
171186
![JDK Selection](.github/media/troubleshooting-Intellij-setting-djk-version-manually.png)
172187
173188
If it is not already installed, you can download it by:
174189
1. Clicking the SDK input field and then selecting the `Download JDK...` option from the menu
175-
2. Select Version: `25`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
190+
2. Select Version: `17`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
176191
177192
178193
![JDK Download](.github/media/troubleshooting-Intellij-download-jdk.png)

0 commit comments

Comments
 (0)