The Eclipse Integrated Computational Environment (ICE) Main Repository

Please see the website for more information on the project.

Build Instructions

Checkout the project and execute

mvn clean install

Building BATS

The above build instructions will NOT include building org.eclipse.ice.bats.

This is due to the need to have an installation of Docker to run the BATS integration test.

In order to include BATS, you can instead run the full profile for the build instruction:

mvn clean install -P full

Using the project generators

Once the build is complete, use the project generators to get started with a new Eclipse ICE project. From the shell, execute the following for a basic project:

mvn archetype:generate -DarchetypeGroupId=org.eclipse.ice -DarchetypeArtifactId=data-element-archetype -DarchetypeVersion=1.0-SNAPSHOT -DgroupId=com.test -DartifactId=testApp

For a web form project, execute the following

mvn archetype:generate -DarchetypeGroupId=org.eclipse.ice -DarchetypeArtifactId=data-element-webform-archetype -DarchetypeVersion=1.0-SNAPSHOT -DgroupId=com.test -DartifactId=testApp

The group and artifact ids above are examples and should be replaced with the correct ids for your use case.

Data Element Example

There are a number of examples in the test and org.eclipse.ice.renderer packages. There is also a gist available.

Commands Examples

Examples for using the Commands tools are available in the demo bundle.

Getting started on development

Contributions follow the standard Eclipse mechanisms and you should check out our CONTRIBUTING.md file for more information. If you are looking at this, then you are most likely using Git and can start the process by issuing a pull request on our GitHub repo.

If you're using Eclipse for development, you need to install Lombok into the Eclipse environment so that Eclipse knows about the bytecode changes that Lombok makes during the build process. Instructions are available at the Lombok site.

Contacting the development team

Please submit a ticket or pull request to contact the team. Alternatively, use the [email protected] mailing list to post questions.