aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorLibravatar Kristóf Marussy <kristof@marussy.com>2022-11-22 19:16:47 +0100
committerLibravatar Kristóf Marussy <kristof@marussy.com>2022-11-22 19:21:42 +0100
commita8ffe38e6e5401011352cda5bc92a0a7a88ef40e (patch)
tree97f14cfb809f365aebfdbfaed43c8733aec930e6 /README.md
parentfix(frontend): mobx 6.7.0 typing (diff)
downloadrefinery-a8ffe38e6e5401011352cda5bc92a0a7a88ef40e.tar.gz
refinery-a8ffe38e6e5401011352cda5bc92a0a7a88ef40e.tar.zst
refinery-a8ffe38e6e5401011352cda5bc92a0a7a88ef40e.zip
chore: upgrade to Java 19
Use Java 19 and Jetty 12 to take advantage of Project Loom preview features to reduce CPU usage due to XtextWebDocumentAccess thread pools.
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 10 insertions, 9 deletions
diff --git a/README.md b/README.md
index dfb4685e..33d89786 100644
--- a/README.md
+++ b/README.md
@@ -6,27 +6,28 @@
6 6
7### With Eclipse IDE 7### With Eclipse IDE
8 8
91. Download and install a _Java 17_ compatible JDK. For Windows, prefer OpenJDK builds from [Adoptium](https://adoptium.net/). 91. Download and install a _Java 19_ compatible JDK. For Windows, prefer OpenJDK builds from [Adoptium](https://adoptium.net/).
10 10
112. Download and extract the [Eclipse IDE for Java and DSL Developers 2021-12](https://www.eclipse.org/downloads/packages/release/2021-12/r/eclipse-ide-java-and-dsl-developers) package. 112. Download and extract the [Eclipse IDE for Java and DSL Developers 2022-09](https://www.eclipse.org/downloads/packages/release/2022-09/r/eclipse-ide-java-and-dsl-developers) package.
12 12
133. Launch Eclipse and create a new workspace. 133. Launch Eclipse and create a new workspace.
14 14
154. Open _Help > Install New Software..._ and install the following software from the _2021-12_ update site: 154. Open _Help > Install New Software..._ and install the following software from the _2022-09_ update site:
16 * _Modeling > Ecore Diagram Editor (SDK)_ 16 * _Modeling > Ecore Diagram Editor (SDK)_
17 17
185. Open _Help > Eclipse Marketplace_ and install the following software: 185. Open _Help > Eclipse Marketplace_ and install the following software:
19 * _EclEmma Java Code Coverage_ 19 * _EclEmma Java Code Coverage_
20 * _Java 19 Support for Eclipse 2022-09 (4.25)_
20 * _SonarLint_ 21 * _SonarLint_
21 22
226. Open _Window > Preferences_ and set the following preferences: 236. Open _Window > Preferences_ and set the following preferences:
23 * _General > Workspace > Text file encoding_ should be _UTF-8_. 24 * _General > Workspace > Text file encoding_ should be _UTF-8_.
24 * _General > Workspace > New text file line delimiter_ should be _Unix_. 25 * _General > Workspace > New text file line delimiter_ should be _Unix_.
25 * Add the JDK 17 to _Java > Installed JREs_. 26 * Add the JDK 19 to _Java > Installed JREs_.
26 * Make sure JDK 17 is selected for _JavaSE-17_ at _Java > Installed JREs > Execution Environments_. 27 * Make sure JDK 19 is selected for _JavaSE-19_ at _Java > Installed JREs > Execution Environments_.
27 * Set _Gradle > Java home_ to the `JAVA_HOME` directory (the directory which contains the `bin` directory) of JDK 17. Here, Buildship will show a yellow warning sign, which can be safely ignored. 28 * Set _Gradle > Java home_ to the `JAVA_HOME` directory (the directory which contains the `bin` directory) of JDK 17. Here, Buildship will show a yellow warning sign, which can be safely ignored.
28 * Set _Java > Compiler > JDK Compliance > Compiler compliance level_ to _17_. The warning about using Java 16 system libraries during compilation should disappear. 29 * Set _Java > Compiler > JDK Compliance > Compiler compliance level_ to _19_. The warning about using Java 16 system libraries during compilation should disappear.
29 30
307. Clone the project Git repository but do not import it into Eclipse yet. 317. Clone the project Git repository but do not import it into Eclipse yet.
31 32
328. Open a new terminal an run `./gradlew prepareEclipse` (`.\gradlew prepareEclipse` on Windows) in the cloned repository. 338. Open a new terminal an run `./gradlew prepareEclipse` (`.\gradlew prepareEclipse` on Windows) in the cloned repository.
@@ -36,11 +37,11 @@
36 37
379. Select _File > Import... > Gradle > Existing Gradle Project_ and import the cloned repository in Eclipse. 389. Select _File > Import... > Gradle > Existing Gradle Project_ and import the cloned repository in Eclipse.
38 * Make sure to select the root of the repository (containing this file) as the _Project root directory_ and that the _Gradle distribution_ is _Gradle wrapper_. 39 * Make sure to select the root of the repository (containing this file) as the _Project root directory_ and that the _Gradle distribution_ is _Gradle wrapper_.
39 * If you have previously imported the project into Eclipse, this step will likely fail. In that case, you should remove the projects from Eclipse, run `git clean -fxd` in the repository, and start over from step 8. 40 * If you have previously imported the project into Eclipse, this step will likely fail. In that case, you should remove the projects from Eclipse, run `git clean -fxd` in the repository, and start over from step 8.
40 41
41### With IntelliJ IDEA 42### With IntelliJ IDEA
42 43
43It is possible to import the project into IntelliJ IDEA, but it gives no editing help for Xtext (`*.xtext`), MWE2 (`*.mwe2`), and Xtend (`*.xtend`) and Ecore class diagrams (`*.aird`, `*.ecore`, `*.genmodel`). 44It is possible to import the project into IntelliJ IDEA, but it gives no editing help for Xtext (`*.xtext`), MWE2 (`*.mwe2`), and Xtend (`*.xtend`) and Ecore class diagrams (`*.aird`, `*.ecore`, `*.genmodel`).
44 45
45## License 46## License
46 47