Skip to content

Add IntelliJ build troubleshooting tips (JDK version, GUI launch, duplicate roots) to BUILD.md #1095

Closed
@marioguzzzman

Description

@marioguzzzman

Hello,

First, thanks for the clear steps in BUILD.md, they helped a lot!

While I just went through the build process using on my system, I ran into a few issues that might be common for new contributors, especially when using IntelliJ.

I'm using:

  • IntelliJ IDEA 2024.3.4.1 Community Edition
  • Windows 11 (amd64)

And here are some suggestions I'd love to contribute:

What I experienced:

  • The build didn't work until I manually selected Temurin 17.0.15 as the JDK inside IntelliJ. Other JDKs (ms-17, etc.) didn't launch the app or caused errors. I’m still not 100% sure why, so if there’s a technical reason for this preference, it could be good to mention that directly?
  • I also got this warning in IntelliJ:
    "Duplicate content roots detected" things still worked fine, but it might help to say it's safe to ignore.

Would it make sense to add a small visual guide to BUILD.md with these things?

What I’d love to work on:

  • Add a Troubleshooting and Setup Tips section to BUILD.md
  • Optionally include screenshots of IntelliJ (JDK selection, warning popup, manual run config setup)
  • Maybe even a visual guide that can be launched from the Processing GUI itself? This might become a whole new issue.

Let me know if it would be helpful.

Thanks again!

cc @SableRaf , since you recently updated the BUILD.md, I figured you might have thoughts on this. Happy to draft something and open a PR if that sounds good.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions