From 4db47791cfd68cac02c80c25944195a4fd938303 Mon Sep 17 00:00:00 2001 From: Andrew Berezovskyi Date: Fri, 17 Jul 2026 20:21:00 +0200 Subject: [PATCH 1/2] Update installation instructions for Lyo Designer Added prerequisites and installation instructions for running Lyo Designer from source, including JDK installation and Eclipse setup. --- docs-new/eclipse_lyo/install-lyo-designer.md | 55 ++++++++++++++++++-- 1 file changed, 51 insertions(+), 4 deletions(-) diff --git a/docs-new/eclipse_lyo/install-lyo-designer.md b/docs-new/eclipse_lyo/install-lyo-designer.md index 556d769..b80ae25 100644 --- a/docs-new/eclipse_lyo/install-lyo-designer.md +++ b/docs-new/eclipse_lyo/install-lyo-designer.md @@ -76,7 +76,54 @@ yet-unreleased builds of Lyo Designer. ## Running from source -If you wish to alter the source code of Lyo Designer (e.g., to contribute new -features) or the generator templates (to update the structure of the generated -code), you will need to [run Lyo Designer from -source](https://github.com/eclipse/lyo.designer/wiki/Working-from-Source-Code). \ No newline at end of file +### Prereqisites + +Install JDK 17 and ensure it is the default JDK on your systems. For example, using winget: + +```powershell +winget install -e --id EclipseAdoptium.Temurin.17.JDK +``` + +### Eclipse installation + +Get a fresh install of _Eclipse IDE for Enterprise Java and Web Developers_ (version +[2022-03 R](https://www.eclipse.org/downloads/packages/release/2022-03/r)). Do not use +_Eclipse Installer._ + +Open Eclipse IDE and do a preliminary setup: + +- Uncheck ***Project → Build Automatically*** +- Add your JDK 17 under ***Window → Preferences → Java → Installed JREs.*** Make sure it is selected by default. + +Install required plugins from Eclipse: + +- Open ***Help → Install New Software...*** +- Select **2022-03** under ***Work with*** +- Select the following plugins: + - ***Modeling → Acceleo*** + - ***Modeling → Sirius Specifier Environment*** + - ***Modeling → EMF - Eclipse Modeling Framework SDK*** (not ***EclipseRT Target Platform Components → EMF - Eclipse Modeling Framework SDK***) + +Install required plugins from Eclipse Lyo: + +- Open ***Help → Install New Software...*** +- Paste `https://download.eclipse.org/lyo/bundle/p2/releases/6.0.0.Final/` under ***Work with*** and press Enter. +- Select the entire ***Lyo OSGi Bundles*** group + +Import Lyo Designer sources: + +- Clone this repository +- Open ***File → Import Projects*** +- Use the ***Import Existing Projects*** +- Provide the path to the cloned repository under ***Import Existing Projects*** and import all projects. + +Initial setup: + +- Select ***Project → Clean...*** and build the entire workspace. +- Create a new *Eclipse Application* configuration called **Tool Chain + Design** + - Select **Run → Run Configurations ...** + - Select **Eclipse Application** + - Press **New** button to create a new configuration + - In the new dialog, Set **name** to *Lyo Designer* + - In Arguments tab, change **VM argument** value to `-Xms256m -Xmx2048m` From 66c5a1384b077e1a5416bfc42706e284450d304f Mon Sep 17 00:00:00 2001 From: Andrew Berezovskyi Date: Sat, 18 Jul 2026 01:33:19 +0200 Subject: [PATCH 2/2] Update installation instructions for Lyo Designer Clarified installation instructions and added warnings about plugin installation risks. --- docs-new/eclipse_lyo/install-lyo-designer.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs-new/eclipse_lyo/install-lyo-designer.md b/docs-new/eclipse_lyo/install-lyo-designer.md index b80ae25..184f542 100644 --- a/docs-new/eclipse_lyo/install-lyo-designer.md +++ b/docs-new/eclipse_lyo/install-lyo-designer.md @@ -90,7 +90,7 @@ Get a fresh install of _Eclipse IDE for Enterprise Java and Web Developers_ (ver [2022-03 R](https://www.eclipse.org/downloads/packages/release/2022-03/r)). Do not use _Eclipse Installer._ -Open Eclipse IDE and do a preliminary setup: +Open the Eclipse IDE and do a preliminary setup: - Uncheck ***Project → Build Automatically*** - Add your JDK 17 under ***Window → Preferences → Java → Installed JREs.*** Make sure it is selected by default. @@ -99,17 +99,26 @@ Install required plugins from Eclipse: - Open ***Help → Install New Software...*** - Select **2022-03** under ***Work with*** +- Uncheck the _**Contact all update sites during install to find required software**_ - Select the following plugins: - ***Modeling → Acceleo*** - ***Modeling → Sirius Specifier Environment*** - ***Modeling → EMF - Eclipse Modeling Framework SDK*** (not ***EclipseRT Target Platform Components → EMF - Eclipse Modeling Framework SDK***) +!!! danger "Risk of breaking your installation" + You must ensure that all plugin installations are done with the _**Contact all update sites during install to find required software**_ option **UNCHECKED.** + Leaving it checked could lead to incompatible newer versions of plugin dependencies to be pulled. + Install required plugins from Eclipse Lyo: - Open ***Help → Install New Software...*** - Paste `https://download.eclipse.org/lyo/bundle/p2/releases/6.0.0.Final/` under ***Work with*** and press Enter. - Select the entire ***Lyo OSGi Bundles*** group +!!! warning "Ignore the SLF4J resolution error" + When installing ***Lyo OSGi Bundles*** with the _**Contact all update sites during install to find required software**_ option unchecked, you may encounter resolution warnings for the `slf4j.api` plugin. + Proceed with _**Keep my installation the same and modify the items being installed to be compatible.**_ + Import Lyo Designer sources: - Clone this repository