Issues and code contribution are handled via Eclipse.org infrastructure. See https://projects.eclipse.org/projects/technology.lsp4e/developer

TL;DR: mvn verify will build a p2-accessible repository in repository/target/repository.

Development

This project is built using Maven Tycho, a set of extensions to Maven for building Eclipse bundles and features.

Requirements

  1. Maven 3.6.3 or later. Although m2eclipse is bundled with its own Maven install, Maven is necessary for command-line builds.

  2. JDK 11. Only JDK 8 is required to run core LSP4E, but some components, such as JDT extensions and tests JDK11 is required.

  3. git (optional: you can use EGit from within Eclipse instead)

  4. The Eclipse IDE. It's easiest to use the Eclipse IDE for Enterprise Java Developers package.

  5. The m2eclipse plugin (also called m2e) is required to import the projects into Eclipse. m2eclipse is included in several packages, such as the Eclipse IDE for Enterprise Java Developers package.

  6. Clone the project to a local directory using git clone ssh://username@git.eclipse.org:29418/lsp4e/lsp4e.git.

Configuring Maven/Tycho Builds

The plugin is built using Maven/Tycho and targeted to Java 8.

Eclipse Platform Target Platform

The build is generally targeted against the newest release of the Eclipse Platform. Refer to target-platform-latest.target for details on the current dependencies used to build LSP4E.

Import into Eclipse

Prerequisites:

  1. You have installed Eclipse for RCP and RAP Developers 4.7 or later. Other distributions that include PDE and reasonable Java support may also work.

  2. You have cloned the lsp4e repo into a local directory.

In Eclipse:

  1. File > Import > Existing Maven Projects

  2. Click Next.

  3. In the Root Directory chooser select the directory where you cloned the project, and which contains pom.xml.

  4. All targets should be selected. Click Finish.

  5. At this point the Problems view should show on the order of 1000 errors.

  6. In the Project Explorer, select the file target-platform-latest.target. Open this file with the target editor.

  7. Click the “Set as Target Platform” link on the top right.

Contributing Changes

When sending a pull request please squash your commits and set the commit message in this form:

Bug 528908 - Change Description

Change details, if needed

Signed-Off-By: Your Name <email@example.org>
Change-Id: I8cd4aa13a8c61b550cfc80f68ab2b4d230b9f9b3

To push to Gerrit for review:

$ git push ssh://username@git.eclipse.org:29418/lsp4e/lsp4e.git HEAD:refs/for/master

Make sure that the name/email in the git commits matches the name/email you have registered with the Eclipse project.

Please see Gerrit info on the Eclipse Wiki for more information.