Plugin Development

Setting up the project

1. Clone project from git

   git clone [email protected]:OpenLiberty/liberty-tools-eclipse.git

2. Start up Eclipse (create a new directory to use as the workspace - not the cloned repo above^)

3. Import the projects (multiple ways to do this):

• Using Git

  1. Click on Window > Show View > Other...

  2. Search "git" and click on Git Repositories

  3. From the Git Repositories view, right click > Add a Git Repository

  4. Add the liberty-tools-eclipse directory that you cloned in step 1.

  5. Right click on the new repo and Import Projects

• OR

  1. File->Import -> General -> Existing Projects into Workspace

  2. In the "Select root directory" type the liberty-tools-eclipse directory that you cloned in step 1 and hit "Browse".

  3. Click to select the option "Search for nested projects".

  4. Click "Finish".

Starting the development workspace

1. Setup the target platform information (versions, addons and such):

   1. Go to releng/target-platform and open target-platform.target

   2. Click Set as Active Target Platform in the top Right

2. Launch the plugin (this will open a "child" Eclipse window with the plugin installed)

   NOTE: At the moment, we either need to launch the child eclipse app with MAVEN_HOME/GRADLE_HOME configured OR make sure the Maven/Gradle wrapper (mvnw/gradlew) is included in whatever test app we import.

   1. Under bundles right click on liberty

   2. (Wrapper in test app) Run As > Eclipse Application

   3. (Setting MAVEN_HOME) Run As > Run Configurations > Eclipse Application > New Configuration > Environment tab > Add your MAVEN_HOME variable here

Notes:

• Supported Java version: 11 and 17