NOTE: Starting with the 0.3 early release, Eclipse version 2022-09 and Java 17 are required. If using Eclipse version 2022-03 or 2022-06, you must use Liberty Tools version 0.2 .
A Liberty plugin for Eclipse IDE. The plugin allows you to run your Liberty Maven or Liberty Gradle projects in dev mode through the Liberty dashboard view or through the project explorer view. You can start, stop, or interact with Liberty dev mode on all configured Liberty Maven and Liberty Gradle projects in your workspace.
| Maven Projects | Gradle Projects |
|---|---|
 |
 |
| Maven Projects | Gradle Projects |
|---|---|
 |
 |
- Install Liberty Tools.
- Install your Maven or Gradle application.
- Open the Liberty dashboard view by clicking on the Open Liberty icon on the toolbar, or open the project explorer view.
- Right-click on your application in the Liberty dashboard to view the available action commands, or, if you are using the project explorer view, right-click on your application and select the
Run Asentry on the menu to view the available Liberty launch shortcuts.
For detailed instructions on how to use the Liberty dashboard context menu commands or the Liberty launch shortcuts provided thought the project explorer view, check out the Getting Started page.
- View supported projects in the dashboard.
- Start/Stop dev mode.
- Start dev mode with custom parameters.
- Start dev mode in a container.
- Start dev mode with the debugger attached.
- Run tests.
- View test reports.
| Action Command | Description |
|---|---|
| Start | Starts dev mode. |
| Start... | Opens the Run Configurations dialog to customize and run dev mode. Supported parameters can be found in the documentation for the dev goal of the Liberty Maven Plugin and the libertyDev task of the Liberty Gradle Plugin. |
| Start in container | Starts dev mode with the server in a container. |
| Debug... | Opens the Debug Configurations dialog to customize and run dev mode, and attach the debugger to the server JVM running the application. |
| Stop | Stops dev mode. |
| Run tests | Runs the unit tests and integration tests that are configured for your project. This command requires dev mode to be already started. |
| View integration test report (Maven) | Opens the integration test report file if it exists at /target/site/failsafe-report.html. This action command is only available to Maven projects. |
| View unit test report (Maven) | Opens the unit test report file if it exists at /target/site/surefire-report.html. This action command is only available to Maven projects. |
| View test report (Gradle) | Opens the test report file if it exists at the default location: build/reports/tests/test/index.html. This action command is only available to Gradle projects. Gradle projects only have a single action command for test result reporting. |
Contributions to the Liberty Tools for Eclipse IDE plugin are welcome!
Our CONTRIBUTING document contains details for setting up your development environment and submitting pull requests.
Please report bugs, issues and feature requests by creating a GitHub issue