Codewind for Eclipse
Create and develop cloud-native, containerized web applications from Eclipse.
Installing Codewind for Eclipse
You can install Codewind locally in Eclipse. For more information about installing Codewind, see Getting started: Codewind for Eclipse.
- Download and install the latest Eclipse IDE for Java EE Developers or use an existing installation.
- Install Eclipse IDE Version 2019-09 R (4.13.0) or later to avoid Bug 541220.
- However, the earliest supported version of the Eclipse IDE is Version 2019-06 (4.12).
- Install Docker 17.06 or later.
- If you use Linux, you also need to install Docker Compose.
Complete the installation:
- Install Codewind from the Eclipse Marketplace.
- Open the Codewind Explorer view. Go to Window>Show View>Other…>Codewind>Codewind Explorer.
- Double-click the Local entry in the view to finish installing Codewind. The download is approximately 1 GB. For more information, see Installing Codewind for Eclipse.
Using Codewind for Eclipse
Right-click the Local entry in the view to create new projects or add existing projects to Codewind. After a project is created or added, it displays in the Codewind Explorer view. Right-click the project to see the available actions.
- Open Application: Opens the application in the default Eclipse browser. This action is only available when the application is running or debugging.
- Open Project Overview: Opens the overview page for a project. You can use this action to see information about the project and edit project settings.
- Open Container Shell: Opens a shell into your application container. This action is available only when the container is active.
- Open Application Monitor: Opens the application monitor in the default Eclipse browser. Use this action to monitor the activity and health of your application. This action is available only when the application is running or debugging.
- Open Performance Dashboard: Opens the performance dashboard in the default Eclipse browser. This action is available only when the application is running or debugging.
- Import Project: Imports your project into the Eclipse workspace.
- Disable/Enable Project: Disables or enables the project.
- Show Log Files: If log files are available, this action displays a list of log files. Click Show All or an individual log file toggle action to open the log file in the Eclipse Console view. Click the log file again to remove the log file, or click Hide All to remove all log files from the Console view.
- Restart in Run Mode: Restarts the application in run mode.
- Restart in Debug Mode: Restarts the application in debug mode and attaches the debugger. Only MicroProfile/Java EE, Spring, and Node.js projects can be debugged. For more information, see Debugging Codewind projects.
- Attach Debugger: If you detached the debugger accidentally or restarted Eclipse, use this action to re-attach the debugger to an application in debug mode. For more information, see Debugging Codewind projects.
- Build: Initiate a build of your project. This action is not available if a build is already running. For more information, see Building Codewind projects.
- Disable Auto Build: Use this to disable automatic builds if you are making a lot of changes and don't want builds to be triggered until you are done. This action is available only when auto build is enabled.
- Enable Auto Build: Use this to re-enable automatic builds whenever a change is made. This action is available only when auto build is disabled.
- Remove: Removes a project. This action removes the project from Codewind and optionally deletes the project files from the file system.
- Refresh: If the project gets out of sync, use this option to refresh it. To refresh all projects, right-click the Local item in the Codewind Explorer view and select Refresh.
Enabling debug logs
- Create an
.options file in your Eclipse install directory, the same directory with the
eclipse executable. Include the following content in the new file:
- Launch Eclipse with the
- The logs are written to the Eclipse workspace directory to
- Clone the repository to your system:
git clone https://github.com/eclipse/codewind-eclipse
- (Optional:) To get a test build, copy the
codewind-eclipse folder to the
build directory to keep your source folder intact.
- Run a Gradle build:
- Test the driver built from the Gradle build:
Developing Codewind for Eclipse
Running Tests on Codewind for Eclipse
- The tests are located in the
org.eclipse.codewind.test project and are JUnit tests.
- Tests can be run individually or there are two test lists:
- AllTests: This includes all of the tests.
- BuildVerificationTests: This is the subset of tests that are run with the build.
- To run the tests create a new run configuration in Eclipse of type JUnit Plug-in Test:
- Set Test runner to
JUnit 4. Do this first otherwise the Search button for the test class will not work.
- Set Project to
- Set Test class to the test case or test list you want to run.
- (Optional) Un-check Run in UI thread. This allows you to interact with the Eclipse instance running the test.
- Click the Run button.
Developing Codewind images
To contribute to Codewind, see CONTRIBUTING.md.