Astro is a tool that generates Sirius Web graphical modelling editors from a Sirius Viewpoint Specification Model (Sirius VSM) with the .odesign extension, an Ecore metamodel, an EMF generator model, and a configuration model. Astro uses code generation to port desktop-based graphical model editors defined in Eclipse Sirius, to the web by relying on Sirius Web.
- Java 17+
- Eclipse Modeling Tools 2022-12 or newer
- Eclipse Sirius 7.x
First, install Eclipse through the Eclipse installer, by choosing "Eclipse Modeling Tools" from its main window.
To install Astro, go to the menu bar of Eclipse and click "Help > Install new software...", then replace the contents of "Work with:" with https://epsilonlabs.github.io/astro/updates/ and press Enter. Once the "Astro" category appears in the list, click on "Select All" and then "Next". It should then list that the "Astro Feature" is going to be installed. Accept the terms of the Eclipse Public License, indicate that you trust the update site (as it is currently unsigned), and let Eclipse restart once prompted.
Next, to install Eclipse Sirius, go to "Help > Eclipse Marketplace", search for "Sirius" and click on "Install".
Clone the repository. We will use the example in its examples/uk.ac.york.astro.languages folder.
Import the project in that folder into your Eclipse workspace, by clicking on the "File > Import" menu item and selecting "General > Existing Projects into Workspace". The imported project contains three folders, one for each language. Once the project is imported, select all files in the workloadDsl folder, then right-click and hover over Astro. Next, select one of the two options to either generate a Sirius Web editor or validate the selected models.
For generating a Sirius Web editor, four files must be selected: one with the extension .astro, one with the extension .ecore, one with the extension .genmodel, and one with the extension .odesign. Before generating a Sirius Web editor, one should first validate the selected models. For validating the models, three files must be selected: one with the extension .astro, one with the extension .ecore, and one with the extension .odesign.
The configuration model must have the .astro extension. It defines the parameters used by the code generation process. At present, some values are hardcoded and should be edited manually to match your project before generating a Sirius Web editor.