Eclipse is a popular IDE that is used by many committers to develop Java code. Eclipse projects have been created for you to use. You should use the latest Eclipse version, or at least 4.8 due to modular support.a version that supports JDK N-1 (for OpenJFX N) after patching (see below).
It's recommended that location of the local git repository not be inside the Eclipse workspace directory.
You should take advantage of Eclipse's incremental compiler and faster unit tests compared to Gradle gradle tasks, however, you still need Gradle gradle for the initial setup (./
gradlew or /.
gradlew build) that generates resources that are specified in the Eclipse projects dependencies, and to verify that you can build with javac. You can either use Gradle gradle from the command line or use Buildship (recommended).
Import the Eclipse Projects
You can either import the projects as Java projects and then run the gradle build manually, or import them directly as gradle projects with Buildship (recommended). In either case, you might find it convenient to use Working Sets, which you can configure during import or later.
To import as gradle projects:
- Go to
File -> Import -> Gradle -> Existing Gradle Project.
- Set the root directory to the base repository path.
- If your workspace setting is to use the wrapper by default, there is no need to override the settings. Otherwise specify
The import process includes an initial gradle build, at the end of which you should see the root project (
jfx, or previously,
rt) with its subprojects under
Gradle project structure.
To import as Java projects:
- Go to
File -> Import -> General -> Existing Projects into Workspace.
- Set the root directory to the base repository path (/
Search for nested projects.
- Optionally, you might find it convenient to work with Working Sets.
Configure Eclipse to use the latest JDK
- Go to
Window -> Preferences -> Java -> Installed JREsand
Addand select the above version. If you want to find a regression or backport, you can switch to earlier versions here (will require rebuilding). You might see a warning that Eclipse does not support this Java version, this should not cause issues.
- Go to
Window -> Preferences -> Java -> Compilerand set the compiler compliance level to the latest. You might not have an option for an unreleased version of Java. If For example, if compliance level 11 is not available, install the patch from the update site: http://download.eclipse.org/eclipse/updates/4.9-P-builds/. Similarly, for Java 13 use: https://download.eclipse.org/eclipse/updates/4.13-P-builds.
Building the workspace can take some time. However, thanks to Eclipse's incremental compiler, you do not need to rebuild all of it on every change.