|
1 | | -# microclimate-eclipse-plugin |
| 1 | +# Microclimate Developer Tools for Eclipse |
| 2 | + |
| 3 | +## How to install |
| 4 | + |
| 5 | +Complete the following steps to install Microclimate Developer Tools for Eclipse: |
| 6 | + |
| 7 | +1. Download and install the latest [Eclipse IDE for Java EE Developers](https://www.eclipse.org/downloads/packages/release/) or use an existing installation. The earliest supported version of the Eclipse IDE for Microclimate Developer Tools for Eclipse is 4.8 (Photon). |
| 8 | +2. Install the [Microclimate Developer Tools from Eclipse Marketplace](https://marketplace.eclipse.org/content/microclimate-developer-tools-beta). |
| 9 | + |
| 10 | +## How to use |
| 11 | + |
| 12 | +- Create a new connection to Microclimate: |
| 13 | + - From the **File** menu select **New** > **Other** > **Microclimate** > **New Microclimate Connection** |
| 14 | + - Fill in the host (only **localhost** is supported) and port (usually **9090**) |
| 15 | + - Click the **Test Connection** and then click **Finish** |
| 16 | +- This should open the **Microclimate Explorer** view with the connection expanded to show your projects. If it does not open the view then open it manually: |
| 17 | + - From the **Window** menu select **Show View** > **Other** > **Microclimate** > **Microclimate Explorer** |
| 18 | + - Click **Open** |
| 19 | +- Right click on the connection to see the available actions for connections |
| 20 | +- Right click on a project to see the available actions for projects |
| 21 | + |
| 22 | +## Features |
| 23 | + |
| 24 | +- View all Microclimate projects for a connection including the application and build status |
| 25 | +- Import your Microclimate project into the Eclipse workspace |
| 26 | +- Debug **Microprofile/Java EE** and **Spring** applications |
| 27 | +- View application and build logs in the **Console** view |
| 28 | +- Open your application in the default Eclipse browser |
| 29 | +- Integrate Microclimate validation errors into the **Markers** view |
| 30 | +- Open a shell session into a Microclimate application container |
| 31 | +- Open the application monitor page |
| 32 | +- Toggle the project auto build setting |
| 33 | +- Manually initiate project builds |
| 34 | + |
| 35 | +(Add documentation link) |
| 36 | + |
| 37 | +## Contributing |
| 38 | + |
| 39 | +We welcome issues (make this a link) and contributions from the public! See [CONTRIBUTING.md](https://github.ibm.com/dev-ex/microclimate-vscode/tree/master/CONTRIBUTING.md) |
2 | 40 |
|
3 | | -# Summary |
4 | | -Tools for working with Microclimate applications in Eclipse |
5 | 41 |
|
6 | | -## Contribute to Microclimate Developer Tools |
7 | | -1. Clone the repository to your system. |
8 | 42 |
|
9 | | - ```git clone https://github.ibm.com/dev-ex/microclimate-eclipse-plugin``` |
10 | 43 |
|
11 | | -2. [Optional] Copy 'microclimate-eclipse-plugin' folder to 'microclimate-eclipse-plugin_build' to get a test build. This will keep your source folder intact. |
12 | | -3. Run a gradle build. |
13 | 44 |
|
14 | | - ```cd microclimate-eclipse-plugin_build/dev``` |
15 | | - |
16 | | - ```./gradlew``` |
17 | | - |
18 | | - 4. Test the driver built from Step. 3 |
19 | | - |
20 | | - ```microclimate-eclipse-plugin_build/dev/ant_build/artifacts/microclimate-eclipse-plugin-[Version].vYYYYMMDD_hhmm.zip``` |
|
0 commit comments