E4/Scripting/Contribute

EASE - Contributing

Prerequisites

To build EASE in Eclipse you should start with 'Eclipse for RCP and RAP Developers' (Kepler SR2, Luna M7).

After startup go to 'Preferences/Maven/Discovery' and click 'Open Catalog'. Continue installing the 'Tycho Configurator'.

Next install the Mylyn Gerrit connector from the Mylyn update site: http://download.eclipse.org/mylyn/releases/latest We need the 'Mylyn Reviews Connector: Gerrit' feature.

If you want to work on the EMF models you might want to additionally install 'EMF Eclipse Modeling Framework SDK' and 'Diagram Editor for Ecore (SDK)' from the official Kepler update site.

Importing Repository

Short link to Gerrit: https://git.eclipse.org/r

The whole procedure: 1. Open the 'Git Repositories' view 2. Click 'Clone a Git repository' 3. In the dialog select 'Gerrit' 4. On the next page hit 'Add...' 5. Set 'Server' to https://git.eclipse.org/r and provide a nice 'Label'. Optionally provide your eclipse credentials, too (necessary to push commits) 6. Finish the dialog 7. Now you should be back at the repository selection page where you should select e4/org.eclipse.e4.scripting, hit next 8. select at least the 'master' branch 9. provide a local path where to keep your repository and check 'Import all existing projects after clone finishes'

Getting rid of workspace errors: 1. locate project 'org.eclipse.ease.releng.target' 2. open the contained target definition 3. click 'Set as Target Platform' in the upper right corner of the editor

The core components along with the JavaScript interpreter can be obtained from eclipse directly. Check the web frontend for git / http clone urls. The python interpreter is hosted on Github due to licensing issues.

After importing you should set your target platform. Therefore open org.eclipse.ease.releng.target/org.eclipse.ease.releng.target.target and hit 'Set as target platform'.

Building

The whole project can be built by right clicking on org.eclipse.ease.releng / Run As / Maven build. Enter 'clean install' as your goals. After the build process you can find a p2 update site available at org.eclipse.ease.releng.p2/target/repository.

You could also build from the command line by navigating to the releng project folder and entering 'mvn clean install'.

Providing code

Currently your best chance to provide code is to create a git patch and submit it via bugzilla. Before creating the patch make sure to have your formatter set to the default 'Eclipse built in'.

Have a look at the open bugs if you are not sure where to start. Some of them are explicitely marked for beginners.