Changes
Page history
Rescaling images
authored
Dec 01, 2023
by
Bernhard Johannes Berger
Show whitespace changes
Inline
Side-by-side
User/Installation.md
View page @
ae6c1474
...
@@ -9,13 +9,13 @@ Installation](#eclipse-installation).
...
@@ -9,13 +9,13 @@ Installation](#eclipse-installation).
First, you have to download an EvoAl release. To do so, please go to the
[
Pipelines
First, you have to download an EvoAl release. To do so, please go to the
[
Pipelines
Page
](
https://gitlab.informatik.uni-bremen.de/evoal/source/evoal-core/-/pipelines
)
.
Page
](
https://gitlab.informatik.uni-bremen.de/evoal/source/evoal-core/-/pipelines
)
.
{width=512px}
Here, you can see all the automatic builds and you can download a fresh EvoAl build.
Here, you can see all the automatic builds and you can download a fresh EvoAl build.
Search for the most recent build where the status indicates a successful build. There,
Search for the most recent build where the status indicates a successful build. There,
look for the
`Actions`
chooser and click the
`Download Artifacts`
chevron.
look for the
`Actions`
chooser and click the
`Download Artifacts`
chevron.
{width=512px}
Select the entry
`all:package:archive`
and download the linked
`.zip`
file.
Select the entry
`all:package:archive`
and download the linked
`.zip`
file.
The download will start automatically when you click the entry. Next, open
The download will start automatically when you click the entry. Next, open
...
@@ -33,38 +33,39 @@ to install Eclipse.
...
@@ -33,38 +33,39 @@ to install Eclipse.
To install Eclipse, you first have to download the Eclipse installer. Head over
To install Eclipse, you first have to download the Eclipse installer. Head over
to the
[
Eclipse download page
](
https://www.eclipse.org/downloads/
)
.
to the
[
Eclipse download page
](
https://www.eclipse.org/downloads/
)
.
{width=512px}
There, you have to hit the Download button and-depending on your operating
There, you have to hit the Download button and-depending on your operating
system-choose a matching package. The Eclipse page will forward you to a
system-choose a matching package. The Eclipse page will forward you to a
mirror selection page since the Eclipse installer is hosted on many servers
mirror selection page since the Eclipse installer is hosted on many servers
over the world, it will ask you to select a server nearby.
over the world, it will ask you to select a server nearby.
{width=512px}
Click the
`Download`
button and wait until your browser has downloaded the
Click the
`Download`
button and wait until your browser has downloaded the
installer successfully. Then, start the Installer from your
`Downloads`
folder.
installer successfully. Then, start the Installer from your
`Downloads`
folder.
{width=440px}
Select the
`Eclipse Modeling Tools`
installation package on the
Select the
`Eclipse Modeling Tools`
installation package on the
first page. Then, you can change the installation folder so it
first page. Then, you can change the installation folder so it
fits your needs. Otherwise, please remember the default location
fits your needs. Otherwise, please remember the default location
so you can find your Eclipse installation.
so you can find your Eclipse installation.
{width=440px}
Click the
`Install`
button and wait for the installation process
Click the
`Install`
button and wait for the installation process
to finish. The installation process might ask you whether you
to finish. The installation process might ask you whether you
trust the installed packages. In this case, you have to check the
trust the installed packages. In this case, you have to check the
corresponding checkbox and then press the
`Trust Selected`
button.
corresponding checkbox and then press the
`Trust Selected`
button.
{width=512px}
After the installation process, a final window shows up that
After the installation process, a final window shows up that
allows you to start Eclipse directly. Simply click on the
allows you to start Eclipse directly. Simply click on the
`Launch`
button.
`Launch`
button.
{width=440px}
Eclipse will start up and ask you to select a workspace location. The
Eclipse will start up and ask you to select a workspace location. The
workspace is the location where Eclipse stores the files you are
workspace is the location where Eclipse stores the files you are
...
@@ -72,7 +73,7 @@ creating and editing, for instance, the DSL files. Select a folder
...
@@ -72,7 +73,7 @@ creating and editing, for instance, the DSL files. Select a folder
that fits your needs, for instance, in your
`Documents`
folder and
that fits your needs, for instance, in your
`Documents`
folder and
select
`Launch`
.
select
`Launch`
.
{width=512px}
Please see the next section for more details on the EvoAl plugin
Please see the next section for more details on the EvoAl plugin
installation process.
installation process.
...
@@ -81,18 +82,18 @@ installation process.
...
@@ -81,18 +82,18 @@ installation process.
After the first start, you will find yourself in the Eclipse workspace
After the first start, you will find yourself in the Eclipse workspace
and have to install the EvoAl plugins. Therefore, go to
```Help > Install New Software ...```
.
and have to install the EvoAl plugins. Therefore, go to
```Help > Install New Software ...```
.
{width=512px}
A window will show up that allows you to install new plugins for Eclipse.
A window will show up that allows you to install new plugins for Eclipse.
{width=512px}
Click the
`Add ...`
button. In the appearing
`Add Repository`
dialog use
Click the
`Add ...`
button. In the appearing
`Add Repository`
dialog use
`EvoAl`
as
`Name`
and
`EvoAl`
as
`Name`
and
`https://evoal.glpages.informatik.uni-bremen.de/source/evoal-core/develop/`
`https://evoal.glpages.informatik.uni-bremen.de/source/evoal-core/develop/`
as
`Location`
.
as
`Location`
.
{width=512px}
Click the
`Add`
button to add the repository to Eclipse. Eclipse will
Click the
`Add`
button to add the repository to Eclipse. Eclipse will
use this repository to fetch new plugins. Now, check the checkbox
use this repository to fetch new plugins. Now, check the checkbox
...
@@ -100,23 +101,23 @@ next to ```EvoAl's DSLs``` in the `Install` dialog and press `Next >`.
...
@@ -100,23 +101,23 @@ next to ```EvoAl's DSLs``` in the `Install` dialog and press `Next >`.
Eclipse will now calculate the plugins to install and the result should
Eclipse will now calculate the plugins to install and the result should
look like the following:
look like the following:
{width=512px}
Confirm the dialog either by clicking
`Finish`
or
`Next >`
. If you have
Confirm the dialog either by clicking
`Finish`
or
`Next >`
. If you have
to click next, you have to review the licenses of the installed plugins
to click next, you have to review the licenses of the installed plugins
and accept them.
and accept them.
{width=512px}
Finally, you have to trust the authorities once more by checking the
Finally, you have to trust the authorities once more by checking the
checkbox next to the EvoAl Update Site.
checkbox next to the EvoAl Update Site.
{width=512px}
After the installation has finished, Eclipse asks you to restart Eclipse
After the installation has finished, Eclipse asks you to restart Eclipse
to properly load the plugins. Please restart Eclipse here.
to properly load the plugins. Please restart Eclipse here.
{width=512px}
## Write your first DDL file
## Write your first DDL file
After starting Eclipse, you now can create a new project for writing
After starting Eclipse, you now can create a new project for writing
...
@@ -124,25 +125,25 @@ EvoAl configurations. To do so, please close the `Welcome` tab and
...
@@ -124,25 +125,25 @@ EvoAl configurations. To do so, please close the `Welcome` tab and
expand the
`Model Explorer`
(the small icon on the left-hand side of
expand the
`Model Explorer`
(the small icon on the left-hand side of
Eclipse). Now, right-click on the
`Model Explorer`
and select
```New > Project ...```
.
Eclipse). Now, right-click on the
`Model Explorer`
and select
```New > Project ...```
.
{width=512px}
Select
```General > Project```
in the dialog.
Select
```General > Project```
in the dialog.
{width=512px}
Now, choose a project name for the new file you want to create:
Now, choose a project name for the new file you want to create:
{width=512px}
Select
`Finish`
. After the dialog has closed, right-click on your newly
Select
`Finish`
. After the dialog has closed, right-click on your newly
created project and select
```New > File ...``````
created project and select
```New > File ...``````
{width=512px}
Select ```
example.ddl
``` as the file name and select `Finish`. In the following dialog that asks if you want to convert the project to an
Select ```
example.ddl
``` as the file name and select `Finish`. In the following dialog that asks if you want to convert the project to an
Xtext project click `Yes`.
Xtext project click `Yes`.
{width=512px}
Now, write your data description, for instance:
Now, write your data description, for instance:
...
@@ -181,7 +182,7 @@ module weather {
...
@@ -181,7 +182,7 @@ module weather {
Your Eclipse should look like the following and you can start
Your Eclipse should look like the following and you can start
testing with describing your domain data.
testing with describing your domain data.
{width=512px}
If you want to use some predefined EvoAl constraints for your
If you want to use some predefined EvoAl constraints for your
data, you have to link the EvoAl specifications. Right-click
data, you have to link the EvoAl specifications. Right-click
...
@@ -192,7 +193,7 @@ Click on `Browse ...` and go to your EvoAl installation (the
...
@@ -192,7 +193,7 @@ Click on `Browse ...` and go to your EvoAl installation (the
path from the [EvoAl Installation](#evoal-installation)) and
path from the [EvoAl Installation](#evoal-installation)) and
select the `definitions`` folder there.
select the `definitions`` folder there.
{width=512px}
Click `Open` and then `Finish`. Afterwards, you can add the
Click `Open` and then `Finish`. Afterwards, you can add the
...
...
...
...
