Build

Build preconditions

You need the following tools being installed on your machine to build the Eclipse plugin:

• Java (JDK 11)
• Graphviz

Recommended Eclipse Versions

• Context Mapper Development (Xtext): Eclipse IDE for Java and DSL Developers (Download Link)
• Installing and testing Context Mapper: Eclipse IDE for Enterprise Java Developers (Download Link)

Building the project

The project uses the Maven Wrapper.

After cloning the project it can be built with the following command within the root directory of the project:

./mvnw clean install

Note: This is an Xtext project and the tests which are evaluating the correctness of the language grammar need an additional maven goal besides test to be executed. Use this command if you want to execute the tests:

./mvnw clean integration-test

They are also executed with a clean install.

Install locally built Eclipse plugin

The Maven build generates an update site (as a *.zip file) to test new language and plugin features in any of your Eclipse instances.

Just, call the Maven build first:

./mvnw clean install

... after that, you will find a org.contextmapper.dsl.repository-x.y.z.YYYYMMDDhhmm.zip in the folder org.contextmapper.dsl.repository/target.

You can install the locally built Context Mapper version with this ZIP file in any Eclipse instance :

1. Start your Eclipse instance.
2. In the menu click Help -> Install New Software...
3. At the top/right part of the dialog that opened, there is an Add... button that allows you to add a new update site. Click it.
4. Another dialog with an Archive... button opens. Click Archive... and choose the *.zip file mentioned above.
5. Click Add to add the update site.
6. Now you can select all Context Mapper packages (Select All) and finish the wizard to install the locally built plugin.
7. After the restart of Eclipse, you can test your new Context Mapper features and the Eclipse plugin.

VSC

to be continued

Testing

to be continued