Skip to content
Common SpringSource components used to integrate tooling with Eclipse, like the SpringSource Dashboard, Eclipse Spring UAA, common framework components and workspace configurators
Java HTML CSS
Latest commit dca4760 @kdvolder kdvolder Move ExceptionUtil so that we can reverse the dependency from
livexp to frameworks.core
Failed to load latest commit information.
bundles/repo updated spring framework to 4.2.4
org.springsource.ide.eclipse.commons-feature Remove receptor client lib
org.springsource.ide.eclipse.commons.browser updated version to 3.7.3
org.springsource.ide.eclipse.commons.cloudfoundry.client updated version to 3.7.3
org.springsource.ide.eclipse.commons.completions updated version to 3.7.3
org.springsource.ide.eclipse.commons.configurator updated version to 3.7.3
org.springsource.ide.eclipse.commons.content.core updated version to 3.7.3
org.springsource.ide.eclipse.commons.core Update SteProperties for Spring Boot 1.3.1
org.springsource.ide.eclipse.commons.frameworks.core Move ExceptionUtil so that we can reverse the dependency from
org.springsource.ide.eclipse.commons.frameworks.test.util Deprecate waitFor method in ACondition
org.springsource.ide.eclipse.commons.frameworks.ui updated version to 3.7.3
org.springsource.ide.eclipse.commons.gettingstarted updated version to 3.7.3
org.springsource.ide.eclipse.commons.livexp Move ExceptionUtil so that we can reverse the dependency from
org.springsource.ide.eclipse.commons.quicksearch.feature updated version to 3.7.3
org.springsource.ide.eclipse.commons.quicksearch.test updated version to 3.7.3
org.springsource.ide.eclipse.commons.quicksearch Fixup some java doc.
org.springsource.ide.eclipse.commons.site-e44 updated version to 3.7.3
org.springsource.ide.eclipse.commons.site updated version to 3.7.3
org.springsource.ide.eclipse.commons.test-feature updated version to 3.7.3
org.springsource.ide.eclipse.commons.tests.util Cleanup debug output
org.springsource.ide.eclipse.commons.tests More information in test failure message
org.springsource.ide.eclipse.commons.ui Generalize method signature of LaunchUtils.whenTerminated
org.springsource.ide.eclipse.dashboard-feature-e44 updated version to 3.7.3
org.springsource.ide.eclipse.dashboard-feature updated version to 3.7.3
org.springsource.ide.eclipse.dashboard.ui updated version to 3.7.3
.gitignore initial commit, part of making the complete SpringSource Tool Suite o…
.project Attempt to fix quicksearch selection issue on Windows
CODE_OF_CONDUCT.adoc add contributor covenant
README.md removed empty line
license.txt updated license information for 3.2.0 release
open_source_licenses.txt updated legal information for 3.7.0 release
pom.xml Remove receptor client lib

README.md

Eclipse Integration Common Components

The Eclipse Integration Common Components are a set of plugins and features that are used and consumed by other Eclipse tooling projects at SpringSource. It contains the commonly used parts and provides two individually installable features:

Spring UAA (User Agent Analysis): The Eclipse integration for the Spring UAA project that helps us to collect some usage data. This is completely anonymous and helps us to understand better how the tooling is used and how to improve it in the future.

The SpringSource Dashboard feature brings you up-to-date information about SpringSource-related projects as well as an easy-to-use extension install to get additional tooling add-ons, like the famous Spring IDE or the Cloud Foundry Integration for Eclipse.

Both components are usually optional features of the other end-used-oriented tooling projects.

Installation

Usually you don't need to install these components directly from this project yourself. They come as part of Spring IDE, the tc Server integration, the Grails IDE, or the Cloud Foundry Integration for Eclipse.

However, if you want to install those features yourself, you could use the following update sites manually:

For Eclipse 4.x and 3.8:

- CI builds: http://dist.springsource.com/snapshot/TOOLS/eclipse-integration-commons/nightly/e4.4 
- Milestone builds: http://dist.springsource.com/milestone/TOOLS/eclipse-integration-commons/e4.4
- Release builds: http://dist.springsource.com/release/TOOLS/eclipse-integration-commons/e4.4

For Eclipse 3.7:

- CI builds: http://dist.springsource.com/snapshot/TOOLS/eclipse-integration-commons/nightly/e3.7 
- Milestone builds: http://dist.springsource.com/milestone/TOOLS/eclipse-integration-commons/e3.7
- Release builds: http://dist.springsource.com/release/TOOLS/eclipse-integration-commons/e3.7

Questions and bug reports:

If you have a question that Google can't answer, the best way is to go to the forum:

http://forum.springsource.org/forumdisplay.php?32-SpringSource-Tool-Suite

There you can also ask questions and search for other people with related or similar problems (and solutions). New versions are announced there as well, usually as part of the releases of the consuming projects.

With regards to bug reports, please go to:

https://issuetracker.springsource.com/browse/STS

Developing Eclipse Integration Common Components

Just clone the repo and import the projects into an Eclipse workspace. The easiest way to ensure that your target platform contains all the necessary dependencies, install a CI build into your target platform and proceed.

JavaFx Setup

As of 3.5.0.M2 commons contains some code that leverages JavaFX to implement the dashboard and other managed html views. To build these inside Eclipse, you'll need to have the e(fx)clipse tooling installed.

  1. Add e(fx)clipse Update site to 'Available Update Sites': http://download.eclipse.org/efxclipse/updates-nightly/site
  2. Add Xtext update site to 'Available Update Sites' : http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/
  3. From the efx Update Site Install the "e(fx)clipse - IDE - Kepler" (or equivalent) feature.

    If experiencing difficulty installing efx with above update sites. Try using efx release compatible with your version of Eclipse instead of efx nightly sites. E.g. for Eclipse 4.3 (Kepler) use these sites:

 - http://download.eclipse.org/efxclipse/updates-released/0.9.0/site
 - http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/

If installed properly, you should see a "jfxrt.jar" under org.springsource.ide.eclipse.commons.gettingstarted "Plugin Dependencies" and compile errors this plugin should disapear.

  1. Add the following vm arguments to your Eclipse Runtime(s). (This is only necessary for self-hosted execution. You should not need to modify your config.ini file.)

    -Dosgi.framework.extensions=org.eclipse.fx.osgi

Test dependencies

If you are not interested in building/running JUnit tests in your development environment then you can skip this step and just close/ignore any xxx.xxx.test plugins that have errors in them.

If you want to build and run tests inside of Eclipse then you'll need to add a few more things to your target platform:

  • TODO: fill this in

Building Eclipse Integration Common Components

The Eclipse Integration Common Components project uses Maven Tycho to do continuous integration builds and to produce p2 repos and update sites. To build the project yourself, you can execute:

mvn -Pe44 -Dmaven.test.skip=true clean install

or

mvn -Pe37 -Dmaven.test.skip=true clean install

Contributing

Code of Conduct

This project adheres to the Contributor Covenant link:CODE_OF_CONDUCT.adoc[code of conduct]. By participating, you are expected to uphold this code. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io.

Get Involved

Here are some ways for you to get involved in the community:

  • Get involved with the Spring community on the Spring Community Forums. Please help out on the forum by responding to questions and joining the debate.
  • Create JIRA tickets for bugs and new features and comment and vote on the ones that you are interested in.
  • Github is for social coding: if you want to write code, we encourage contributions through pull requests from forks of this repository. If you want to contribute code this way, please reference a JIRA ticket as well covering the specific issue you are addressing.
  • Watch for upcoming articles on Spring by subscribing to springframework.org

Contributor License Agreement

Before we accept a non-trivial patch or pull request we will need you to sign the contributor's agreement. Signing the contributor's agreement does not grant anyone commit rights to the main repository, but it does mean that we can accept your contributions, and you will get an author credit if we do. Active contributors might be asked to join the core team, and given the ability to merge pull requests.

Something went wrong with that request. Please try again.