Merge branch 'main' into the-wgpu-moment

Author: catilac

.github/workflows/release.yml

@@ -1,7 +1,8 @@
 name: Releases
 on:
-  release:
-    types: [published]
+  push:
+    tags:
+      - 'processing-*'
 
 jobs:
   version:
@@ -21,12 +22,36 @@ jobs:
           # Set outputs for use in later jobs or steps
           echo "revision=$REVISION" >> $GITHUB_OUTPUT
           echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+  create-draft:
+    name: Create draft release
+    runs-on: ubuntu-latest
+    needs: version
+    permissions:
+      contents: write
+    env:
+      GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      GH_REPO: ${{ github.repository }}
+      TAG: ${{ github.ref_name }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - name: Create draft release
+        run: |
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "Release for $TAG already exists; leaving it as-is."
+          else
+            gh release create "$TAG" \
+              --draft \
+              --title "Processing $VERSION" \
+              --generate-notes
+          fi
+
   reference:
     name: Publish Processing Reference to release
     runs-on: ubuntu-latest
     permissions:
       contents: write
-    needs: version
+    needs: [version, create-draft]
     steps:
     - name: Checkout Website Repository
       uses: actions/checkout@v4
@@ -42,17 +67,23 @@ jobs:
       run: npm run build
     - name: Make reference.zip
       run: npm run zip
+    - name: Stage reference asset
+      env:
+        VERSION: ${{ needs.version.outputs.version }}
+      run: |
+        mkdir -p release-assets
+        cp reference.zip "release-assets/processing-${VERSION}-reference.zip"
     - name: Upload reference to release
-      uses: svenstaro/upload-release-action@v2
+      uses: softprops/action-gh-release@v2
       with:
-        repo_token: ${{ secrets.GITHUB_TOKEN }}
-        asset_name: processing-${{ needs.version.outputs.version }}-reference.zip
-        file: reference.zip
+        draft: true
+        tag_name: ${{ github.ref_name }}
+        files: release-assets/processing-${{ needs.version.outputs.version }}-reference.zip
 
   publish-maven:
     name: Publish Processing Libraries to Maven Central
     runs-on: ubuntu-latest
-    needs: version
+    needs: [version, release-windows, release-macos, release-linux]
     steps:
     - name: Checkout Repository
       uses: actions/checkout@v4
@@ -78,7 +109,7 @@ jobs:
   publish-gradle:
     name: Publish Processing Plugins to Gradle Plugin Portal
     runs-on: ubuntu-latest
-    needs: version
+    needs: [version, release-windows, release-macos, release-linux]
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
@@ -97,7 +128,7 @@ jobs:
 
           ORG_GRADLE_PROJECT_version: ${{ needs.version.outputs.version }}
           ORG_GRADLE_PROJECT_group: ${{ vars.GRADLE_GROUP }}
-                
+
       - name: Publish internal plugins to Gradle Plugin Portal
         run: ./gradlew -c gradle/plugins/settings.gradle.kts publishPlugins
         env:
@@ -114,7 +145,7 @@ jobs:
   release-windows:
     name: (windows/${{ matrix.arch }}) Create Processing Release
     runs-on: ${{ matrix.os }}
-    needs: version
+    needs: [version, create-draft]
     permissions:
       contents: write
     strategy:
@@ -154,24 +185,27 @@ jobs:
           timestamp-rfc3161: http://timestamp.acs.microsoft.com
           timestamp-digest: SHA256
 
-      - name: Upload portable version
-        uses: svenstaro/upload-release-action@v2
-        with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-windows-${{ matrix.arch }}-portable.zip
-          file: app/build/compose/binaries/main/Processing-${{ needs.version.outputs.version }}.zip
+      - name: Stage release assets
+        shell: bash
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          ARCH: ${{ matrix.arch }}
+        run: |
+          mkdir -p release-assets
+          cp "app/build/compose/binaries/main/Processing-${VERSION}.zip" "release-assets/processing-${VERSION}-windows-${ARCH}-portable.zip"
+          cp "app/build/compose/binaries/main/msi/Processing-${VERSION}.msi" "release-assets/processing-${VERSION}-windows-${ARCH}.msi"
 
-      - name: Upload installer
-        uses: svenstaro/upload-release-action@v2
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
         with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-windows-${{ matrix.arch }}.msi
-          file: app/build/compose/binaries/main/msi/Processing-${{ needs.version.outputs.version }}.msi
+          draft: true
+          tag_name: ${{ github.ref_name }}
+          files: release-assets/*
 
   release-macos:
     name: (macOS/${{ matrix.arch }}) Create Processing Release
     runs-on: macos-latest
-    needs: version
+    needs: [version, create-draft]
     permissions:
       contents: write
     strategy:
@@ -209,24 +243,26 @@ jobs:
           ORG_GRADLE_PROJECT_compose.desktop.mac.notarization.password: ${{ secrets.PROCESSING_APP_PASSWORD }}
           ORG_GRADLE_PROJECT_compose.desktop.mac.notarization.teamID: ${{ secrets.PROCESSING_TEAM_ID }}
 
-      - name: Upload portables to release
-        uses: svenstaro/upload-release-action@v2
-        with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-macos-${{ matrix.arch }}-portable.zip
-          file: app/build/compose/binaries/main/Processing-${{ needs.version.outputs.version }}.zip
+      - name: Stage release assets
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          ARCH: ${{ matrix.arch }}
+        run: |
+          mkdir -p release-assets
+          cp "app/build/compose/binaries/main/Processing-${VERSION}.zip" "release-assets/processing-${VERSION}-macos-${ARCH}-portable.zip"
+          cp "app/build/compose/binaries/main/dmg/Processing-${VERSION}.dmg" "release-assets/processing-${VERSION}-macos-${ARCH}.dmg"
 
-      - name: Upload installers to release
-        uses: svenstaro/upload-release-action@v2
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
         with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-macos-${{ matrix.arch }}.dmg
-          file: app/build/compose/binaries/main/dmg/Processing-${{ needs.version.outputs.version }}.dmg
+          draft: true
+          tag_name: ${{ github.ref_name }}
+          files: release-assets/*
 
   release-linux:
     name: (linux/${{ matrix.arch }}) Create Processing Release
     runs-on: ${{ matrix.os }}
-    needs: version
+    needs: [version, create-draft]
     permissions:
       contents: write
     strategy:
@@ -254,19 +290,22 @@ jobs:
           ORG_GRADLE_PROJECT_revision: ${{ needs.version.outputs.revision }}
           ORG_GRADLE_PROJECT_compose.desktop.verbose: true
 
-      - name: Upload portable to release
-        uses: svenstaro/upload-release-action@v2
-        with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}-portable.zip
-          file: app/build/compose/binaries/main/Processing-${{ needs.version.outputs.version }}.zip
+      - name: Stage release assets
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          ARCH: ${{ matrix.arch }}
+          DEB: ${{ matrix.deb }}
+        run: |
+          mkdir -p release-assets
+          cp "app/build/compose/binaries/main/Processing-${VERSION}.zip" "release-assets/processing-${VERSION}-linux-${ARCH}-portable.zip"
+          cp "app/build/compose/binaries/main/deb/processing_${VERSION}-1_${DEB}.deb" "release-assets/processing-${VERSION}-linux-${ARCH}.deb"
 
-      - name: Upload installer to release
-        uses: svenstaro/upload-release-action@v2
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
         with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}.deb
-          file: app/build/compose/binaries/main/deb/processing_${{ needs.version.outputs.version }}-1_${{ matrix.deb }}.deb
+          draft: true
+          tag_name: ${{ github.ref_name }}
+          files: release-assets/*
 
       - name: Add artifact
         uses: actions/upload-artifact@v4
@@ -278,7 +317,7 @@ jobs:
   release-linux-snap:
     name: (linux/${{ matrix.arch }}) Create Processing Snap Release
     runs-on: ${{ matrix.os }}
-    needs: [version, release-linux]
+    needs: [version, create-draft, release-linux]
     permissions:
       contents: write
     strategy:
@@ -316,12 +355,22 @@ jobs:
           ORG_GRADLE_PROJECT_snapname: ${{ vars.SNAP_NAME }}
           ORG_GRADLE_PROJECT_snapconfinement: ${{ vars.SNAP_CONFINEMENT }}
 
+      - name: Stage release assets
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          ARCH: ${{ matrix.arch }}
+          DEB: ${{ matrix.deb }}
+          SNAP_NAME: ${{ vars.SNAP_NAME }}
+        run: |
+          mkdir -p release-assets
+          cp "app/build/compose/binaries/main/${SNAP_NAME}_${VERSION}_${DEB}.snap" "release-assets/processing-${VERSION}-linux-${ARCH}.snap"
+
       - name: Upload snap to release
-        uses: svenstaro/upload-release-action@v2
+        uses: softprops/action-gh-release@v2
         with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}.snap
-          file: app/build/compose/binaries/main/${{ vars.SNAP_NAME }}_${{ needs.version.outputs.version }}_${{ matrix.deb }}.snap
+          draft: true
+          tag_name: ${{ github.ref_name }}
+          files: release-assets/processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}.snap
 
       - name: Upload snap to Snap Store
         run: snapcraft upload --release=beta app/build/compose/binaries/main/${{ vars.SNAP_NAME }}_${{ needs.version.outputs.version }}_${{ matrix.deb }}.snap
@@ -330,7 +379,7 @@ jobs:
   release-linux-flatpak:
     name: (linux/${{ matrix.arch }}) Create Processing Flatpak Release
     runs-on: ${{ matrix.os }}
-    needs: [ version, release-linux ]
+    needs: [version, create-draft, release-linux]
     container:
       image: ghcr.io/flathub-infra/flatpak-github-actions:gnome-48
       options: --privileged
@@ -375,9 +424,42 @@ jobs:
           cache-key: flatpak-builder-${{ github.sha }}
           arch: ${{ matrix.farch }}
 
+      - name: Stage release assets
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          ARCH: ${{ matrix.arch }}
+        run: |
+          mkdir -p release-assets
+          cp processing.flatpak "release-assets/processing-${VERSION}-linux-${ARCH}.flatpak"
+
       - name: Upload Flatpak to release
-        uses: svenstaro/upload-release-action@v2
+        uses: softprops/action-gh-release@v2
         with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          asset_name: processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}.flatpak
-          file: processing.flatpak
+          draft: true
+          tag_name: ${{ github.ref_name }}
+          files: release-assets/processing-${{ needs.version.outputs.version }}-linux-${{ matrix.arch }}.flatpak
+
+  publish-release:
+    name: Publish release
+    runs-on: ubuntu-latest
+    environment: release
+    needs:
+      - version
+      - create-draft
+      - reference
+      - publish-maven
+      - publish-gradle
+      - release-windows
+      - release-macos
+      - release-linux
+      - release-linux-snap
+      - release-linux-flatpak
+    permissions:
+      contents: write
+    env:
+      GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      GH_REPO: ${{ github.repository }}
+      TAG: ${{ github.ref_name }}
+    steps:
+      - name: Mark release as published
+        run: gh release edit "$TAG" --draft=false --latest

BUILD.md

@@ -4,7 +4,21 @@ Great to see you are interested in contributing to Processing. To get started yo
 
 ## IntelliJ IDEA (recommended)
 
-First, [download the IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/). Make sure to select the "Community Edition", not "Ultimate". The Community Edition is free and built on open-source software. You may need to scroll down to find the download link. 
+_**Note:** A paid subscription is **not** required. Everything needed to build and work on Processing is available for free in IntelliJ IDEA._
+
+1. [Download IntelliJ IDEA](https://www.jetbrains.com/idea/download/) and install it.
+1. Clone the `Processing4` repository locally.
+1. Open the cloned repository in **IntelliJ IDEA**.
+1. When prompted, select **Trust Project**. (You can preview the project in Safe Mode, but you will not be able to build Processing.)
+1. If IntelliJ asks whether to import the Gradle project, select **Load Gradle Project**.
+1. Make sure IntelliJ and Gradle are both using **JDK 17**:
+   * Go to **`File > Project Structure > Project`**
+   * Set **Project SDK** to **JDK 17** (we recommend **Eclipse Temurin**)
+   * If needed, choose **Download JDK…** and install **Version 17**
+   * Then go to **`Settings > Build, Execution, Deployment > Build Tools > Gradle`**
+   * Set **Gradle JVM** to the same **JDK 17**
+1. Wait for Gradle sync to finish.
+1. Click the green **Run** button in the top right to build and launch Processing. You can also use this menu to start a debug session.
 
 > [!TIP]
 > If you encounter any issues with this process, Read the [Troubleshooting and Setup Tips for IntelliJ IDEA](#troubleshooting-and-setup-tips-intellij-idea)
@@ -47,11 +61,12 @@ If you don't have them installed, you will need to install [Git](https://git-scm
     ```
 
 2. **Install Temurin JDK 17:**
-   
-Processing requires the Temurin distribution of OpenJDK. 
+    
+    Download and install the appropriate version for your platform:
 
-You can download it from [Adoptium](https://adoptium.net/), from [GitHub releases](https://github.com/adoptium/temurin17-binaries/releases),
-or find it in the package manager for your platform.
+    - [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)
+    - [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)
+    - [Other platforms](https://adoptium.net/temurin/releases/?package=jdk&version=17&os=any&arch=any)
 
 ### macOS:
 ```bash
@@ -97,7 +112,7 @@ sdk install jextract
 It may be necessary to set the `JAVA_HOME` environment variable to point to your Temurin JDK installation.
 
     ```bash
-    export JAVA_HOME=/path/to/temurin/jdk-17/
+    export JAVA_HOME=/path/to/temurin/jdk-17.0.15+6/
     ```
 
 ### Build, Run, and Package Processing
@@ -181,20 +196,22 @@ If you’re building Processing using IntelliJ IDEA and something’s not workin
 Make sure IntelliJ is using **temurin-17**, not another version. If building with WebGPU (`-PenableWebGPU=true`), use **temurin-25** instead.
 
 1. Go to **File > Project Structure > Project**
-2. Set the **Project SDK** to:    `temurin-17`
+2. Set the **Project SDK** to:    `temurin-17 java version "17.0.15"`
 
 ![JDK Selection](.github/media/troubleshooting-Intellij-setting-djk-version-manually.png)
 
 If it is not already installed, you can download it by:
 1. Clicking the SDK input field and then selecting the `Download JDK...` option from the menu
 2. Select Version: `17`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
 
+<img width="400" alt="JDK Download" src="https://github.com/user-attachments/assets/503a03a4-3e53-4406-9641-2c93e4b45d51" />
 
 ![JDK Download](.github/media/troubleshooting-Intellij-download-jdk.png)
 
 Now go back to your main window and
 1. Click the green Run Icon in the top right of the window.
 
+
 ### “Duplicate content roots detected”
 
 You may see this warning in IntelliJ: