Development

The Eclipse tooling is based on the Dart analysis server and LSP4E.

See the Dart analysis server README for the current status of the server.

Setting up

Due to the project being an Eclipse plugin, it is recommended to use the Eclipse IDE to develop the plugin.

The following steps should get you all set up for development. If you encounter any problems on the way, feel free to ask on the dartboard-dev mailing list or open an issue.

It is recommended to use at least Eclipse version 2019-06.

Get Started

1. Clone this repository git clone git@github.com:eclipse/dartboard.git

2. Import the projects to the Workspace in Eclipse

3. Wait for the project build to finish

4. Right click on org.eclipse.dartboard, choose Run As and run it as an Eclipse Application

Note	If you have troubles with compilation and/or running try to install the necessary dependencies as described below.

Tip	The project org.eclipse.dartboard.tests is only required if you work with tests. It might show dependency errors on first import as it requires different plugins to compile. To circumvent this you can right click on the project and choose Close project. See the Testing section.

Installing the dependencies

For the plugin to work as expected you need to install some dependencies.

Add the update site of the LSP4E project: http://download.eclipse.org/lsp4e/releases/latest/.

Install the plugins:

• Language Server Protocol client for Eclipse IDE (Incubation) Source

• Language Server Protocol client for Eclipse IDE (Incubation)

Add the update site of the TM4E project: http://download.eclipse.org/tm4e/snapshots/.

Install the plugins:

• TextMate Core

• TextMate Core Developer Resources

For logging we use the logback library. You can install these from the Install new software…​ dialog:

• m2e - slf4j over logback logging (Optional)