-
Notifications
You must be signed in to change notification settings - Fork 23
Eclipse Configuration for Developers
This guide discusses on how to configure Eclipse for the Janssen project. This guide is useful to developers in customizing the Janssen or any of its sub projects. The content and instructions in this document were tested on Ubuntu 18.04. If you are using other operating systems, adjust the instructions accordingly.
This document is organized in a few sections as:
-
Required Tools
- Java: Install Java Development Kit (JDK) 1.8+.
- Eclipse: Install Eclipse IDE for Enterprise Java Developers.
- Download and setup latest Maven binaries.
-
Configuration and installation inside Eclipse: Before starting the development, Eclipse requires some configuration of JDK, Maven and Git/ source codes, etc.
-
Java: Go to Windows-->Preferences Menu, on next sub-screen expand the Java section and select Installed JREs as:
-
Maven: To setup installed Maven, again visit Windows-->Preferences, now expand the maven option, click installations and select the installed Maven as:
-
SCM Connectors: SCM Connectors are required during project import from Git repository. It may not be bundled with the default Eclipse installation, if is it now installed by default then you will see the following screen where there is no option to select for SCM URL.
To install it, visit Windows-->Preferences and expand the Maven section. Select the Discovery option and click Open Catalog. In the pop up dialog go towards the bottom there will be an option for Maven SCM handler(m2e-eGit) select it and click finish.
Once the installation is complete, on the “check out as Maven project from SCM” dialog, there will be an option of git in SCM URL as follows.
-
-
Importing the projects: There are multiple ways to import the Janssen and its sub projects in Eclipse.
- Go to File-->Imports, then under the Maven section click “check out Maven Projects from SCM”. In the next dialog select git in SCM URL and paste the project’s github url (from https://github.com/GluuFederation/).
- Another option is to download the project locally using git clone and then use “import Existing Maven Projects” from Maven Projects section (under File-->Imports)
-
Compilation/ building WAR file: Right click on the project then move the pointer to Run as-->then select Maven Install. The generated WAR can be used to test the customization.