Wonach suchst Du?
What are you looking for?

Get the code into your IDE

Even if you just want to study the code, it probably makes a lot of sense to do so in an IDE.


Get and install Eclipse

Download the installer for the latest Eclipse version (currently this is Eclipse 2018-12) from http://www.eclipse.org/.
The installer will give you a choice about which “edition” to install.
“Eclipse IDE for Java Developers” will probably do. We found that at least for us, the “Eclipse IDE for Java EE Develeopers” has too much unneeded overhead.

Install Lombok

We use lombok to reduce boilerplate code.

To enable your local Eclipse to compile the code, please go to https://projectlombok.org/download.html and follow the instructions for Eclipse. You might also want to check out our metasfresh-issue #1125 for further details.

Edit the eclipse.ini file

Open the eclipse.ini file in the Eclipse instalation directory and check the -vm value.
This is the java version Eclipse itself will run with. Please make sure that it is a recent version and a that it’s a JDK. Why that?

C:\Program Files\Java\jdk1.8.0_131\bin\javaw.exe

Also, we recomment that you make sure to start eclipse with more than the default 1GB of RAM.
Look for -Xmx1024M within the eclipse.ini file and change it to e.g. -Xmx4096M (the more the better).

Edit your maven settings.xml file

The dependency tree of metasfresh contains a few artifacts that are not part of the default maven repository. Therefore we recommend that you add our public repository to your maven settings.xml file.

Please take a look here for details.

Import the code

Start metasfresh from within Eclipse

Note that until eclipse version neon2 the lombok integration is tricky. The recommended eclipse version is at least neon3, as the lombok integration works out of the box with the lombok gui installer (also across multiple eclipse projects). See here for further infos.

Optional - Install the “Eclipse Mylyn to GitHub connector”

The Eclipse Mylyn to GitHub connector is a plugin that allows you to connect mylyn to the different metasfresh repos and use mylyns features to focus on the particular issue at hand.

The connector can be installed via Eclipse’s “Help -> Install New Software…” Dialog:


With this connector installed, you can add GitHub-based mylyn repositories to your Eclipse instalation.

Other IDEs

We don’t yet have experince with code contributions that were created with Netbeans and are only getting started to gain experience with IntelliJ.

We don’t think there is a need to dictate a particular IDE,

but when contributing, please make sure to text-format your contribution in a way that allows us to get a meaningfull diff. to that end, note that your IDE might be able to import our Eclipse formatting spec.

View source file on GitHub.com