Welcome to this developer guide!

Developing on the GroIMP source code only require a java compiler. Additionally GroIMP support two development setup: Maven and Eclipse.

The first step to start developing on the code is to get it. The code is entirely open source and available on https://gitlab.com/grogra/.

The source code is split between the “core” at https://gitlab.com/grogra/groimp and the plugins at https://gitlab.com/grogra/groimp-plugin. It is possible to work separately on the core and the plugins as each are compilable by themselves.

• Ordered List ItemGo to the git repository page in your internet browser.
• Click on the Fork button of the repository.
• Select your own gitlab namespace and optionally an other project name (not recommended).
• Change or reuse the project slug and description.
• Click on Fork project.

• In an internet browser, go to your own repository that forks the official one.
• On the side bar, click on Settings > Repository.
• Expand the category `Mirroring repositories`.
• Insert the URL of the official repository: https://gitlab.com/grogra/groimp (or the url of the plugin)
• Click on Mirror repository

Note: the two previous steps are optional for users, but highly recommended if you plan on contributing to the code.

This method do not require any Gitlab account.

It is possible to simply download the directory of source code from GitLab on the main page https://gitlab.com/grogra/groimp. There is a download arrow button right next to the _clone_ button. You can then download the whole repository as any archive format you like. Once it is downloaded, extract the archive to the directory in your workspace.

You can clone a repository from GitLab with the command line:

git clone  https://gitlab.com/grogra/groimp.git

This will create a directory named groimp and download all the remote content in it.

Now that you have the source code on your local device, you can compile it with Maven. Maven require pom.xml files to process a project. GroIMP core have both a parent pom.xml and a pom.xml for each plugins. Additional plugins only have their pom.xml. Maven commands are executed from a terminal (bash, Powershell, …), and they are executed at the root of the pom.xml considered. I.e. for the groimp core at the parent repository, for an individual plugin in its repository.

The most useful maven commands are:

• mvn compile will compile the code under /groimpsourcepath/pluginpath/target/. In the case where it is executed at the groimp root (for the groimp core), the compiled classes are stored under each plugin/target directory.
• mvn package will compile the code, and package it for deployment. The compiled package is under /groimpsourcepath/app/. It should automatically include dependency jars and resources. The packaged repository can be copied to an other groimp installation.
• mvn clean clean the repository, deleting all target and app repositories.

If you package the groimp core code, you will have a platform-with-dependency.jar in the /groimpsourcepath/app directory. You can start the compiled version of GroIMP with java -jar platform-with-dependency.jar.

See the guide on how to setup your Eclipse environment here.