Development Environment

This page contains all required information in order to contribute to the Cooperate modeling environment.

Setup Core Environment

• Download Eclipse Oxygen.1 Modeling Edition
• Use the installation script from the repository to install the required dependencies
  • File - Import - Install - Install Software Items from File
  • Select the installation script from the repository that matches the Eclipse version
  • Continue and confirm the warning about unsigned packages
  • Restart Eclipse
• Setup a CDO server according to the description in the repository
  • This is not necessary to build the bundles but might be neccessary for testing several features
• Checkout the whole repository and import all plugin projects
  • You might want to configure git to support long paths in order to be able to checkout all files: git config --system core.longpaths true

Build / Deploy

• Build and deployment is done automatically by our build system
  • You will receive mails about failed builds if you set your email address correctly in git
  • Pull requests will be build as well
  • Deployment is only done for tagged releases in the master branch
• To test your changes before pushing, use Maven
  • mvn clean verify
  • You have to configure Maven according to the manual below

Configure Maven

If you do not only want to test your implementation inside Eclipse but simulate our build process locally, you have to use Maven. You have to configure Maven because we use custom Maven plugins that are only available in specific plugin repositories.

• Download our settings.xml
• Copy the settings.xml into the .m2 folder in your home directory
  • On Windows, this folder is usally located under C:\Users\yourUserName\.m2
  • If you already have a settings.xml, merge the entries