Upgrade instructions
To upgrade to a new Eclipse Platform/IDE/SDK version:
-
New development environment
-
Set up a new development environment for the new Eclipse IDE version.
-
-
Version updates
-
Look up Orbit version for the new Eclipse Platform/IDE/SDK release, see https://download.eclipse.org/tools/orbit/downloads/.
-
Update Oomph setup (
org.eclipse.escet.setup), configuring new Eclipse IDE and Orbit versions. -
Update
dev-env-setup.asciidocto match new Eclipse version. -
Update
org.eclipse.platformversion for the product feature (org.eclipse.escet.product.feature/feature.xml). -
Update Eclipse and Orbit update site URLs in product (
org.eclipse.escet.product/escet.product). -
Update Eclipse and Orbit update site URLs in update site (
org.eclipse.escet.product/category.xml).
-
-
Update target platform and address any issues
-
Let Oomph regenerate the target platform, and commit any changes.
-
Force a rebuild in Eclipse ().
-
Check workspace for any errors/warnings and address them if any.
-
Check New and Noteworthy (release notes) of the new Eclipse version for changes and adapt as necessary.
-
-
Java formatter profile
-
Navigate to .
-
Ensure the Oomph preference recorder is enabled, using the corresponding button at the bottom left of the dialog.
-
In the dialog, navigate to .
-
Make a dummy change to the Eclipse ESCET Java formatter profile and close the profile editing dialog by clicking OK.
-
Close the preferences dialog by clicking Apply and Close.
-
An Oomph preference recorder dialog will appear that can be dismissed by clicking Cancel.
-
Repeat the previous steps to revert the dummy change until the Oomph preference recorder dialog appears again.
-
Select the relevant preferences, note their names, and copy the values from the bottom text box to an external text editor.
-
Close the Oomph preference recorder dialog by clicking Cancel.
-
Open the Oomph setup (
org.eclipse.escet.setup) and look for the relevant preferences. -
Right click such a preference and choose Show Properties View.
-
In the properties view, get the current values of the preferences, and compare them to the new values using your favorite diff tool.
-
Replace the current values of the preferences by the new values.
-
Don’t forget to save the updated Oomph setup.
-
In case of formatting profile changes, reformat all Java code using the new formatter profile.
-
-
Java errors/warnings settings
-
Right click the
org.eclipse.escet.common.javaproject in the Package Explorer view and choose Properties. -
In the properties dialog, select .
-
Make a dummy change and apply it by clicking Apply and Close.
-
Click Yes when asked to Rebuild the project now to apply the changes of the Error/Warning settings?.
-
Revert the dummy change, using again the same steps.
-
In case of changes to
*.prefsfiles in the.settingsdirectory of that project, configure the new settings as desired. -
Run
misc/java-code-style/copy_here.bash ../../common/org.eclipse.escet.common.javafrommisc/java-code-styleto copy the new settings to the central place. -
Run
misc/java-code-style/copy_there.bashfrommisc/java-code-styleto copy the new settings to all relevant projects. -
Force a rebuild in Eclipse () and check for any warnings/errors, addressing them if any.
-
-
Update Maven version
-
Check the embedded Maven version, by navigating to , selecting the build launch configuration under Maven Build, and observing the Maven Runtime version.
-
Ensure the Maven version in
Jenkinsfilematches the embedded Maven version. -
Ensure the Maven version in
misc/license-check-dependencies/Jenkinsfilematches the embedded Maven version.
-
-
Validation
-
Run a Maven build.
-
Ensure no errors or warnings during Maven build.
-
-
Dependency information
-
Run
misc/license-check-dependencies/license-check-dependencies.shand updateDEPENDENCIES.txtaccording to the output. -
Run
misc/license-check-dependencies/license-check-dependencies.shagain, to ensureDEPENDENCIES.txtis up-to-date.
-
To upgrade to a new Tycho version:
-
Update version in
org.eclipse.escet.root/.mvn/extensions.xml. -
Update version in
org.eclipse.escet.configuration/pom.xml. -
Check Tycho release notes for changes and adapt as necessary.
-
Run a Maven build.
-
Ensure no errors or warnings during Maven build.
To upgrade to a new Java version:
-
For major Java versions (e.g. 11 to 12):
-
Update
Bundle-RequiredExecutionEnvironmentfor all plug-in manifests. -
Update
JRE_CONTAINERin all.classpathfiles. -
Update
JRE_CONTAINERin all launch configurations (.launchfiles). -
Update Java versions in
org.eclipse.jdt.core.prefsfiles. -
Update
osgi.requiredJavaVersionin the product (org.eclipse.escet.product/escet.product). -
Update Java version for
executionEnvironmentinorg.eclipse.escet.configuration/pom.xml. -
Update Java version in
Jenkinsfile. -
Update Java version in
misc/license-check-dependencies/Jenkinsfile. -
Update Java keywords for
org.eclipse.escet.common.java.JavaCodeUtils.JAVA_IDS. Update the keywords themselves and the field’s JavaDoc, including the link to the Java Language Specification (JLS).
-
-
For any Java versions (e.g. 11 to 12, or 11.0.1 to 11.0.2):
-
Update the JustJ version (
eclipse.justj.version.*variables) in the Oomph setup (org.eclipse.escet.setup). -
Regenerate the target platform file using Oomph.
-
Update JustJ version for the product feature (
org.eclipse.escet.product.feature/feature.xml). -
Update
dev-env-setup.asciidocto match new Java version. -
Force a rebuild in Eclipse () and check for any warnings/errors, addressing them if any.
-
Run a Maven build.
-
Ensure no errors or warnings during Maven build.
-
Run
misc/license-check-dependencies/license-check-dependencies.shand updateDEPENDENCIES.txtaccording to the output. -
Run
misc/license-check-dependencies/license-check-dependencies.shto ensureDEPENDENCIES.txtis up-to-date.
-