Mark Phippard edited this page May 1, 2018 · 17 revisions

Help/Contributing

  • If you need help, use StackOverflow.
  • If you found a bug, use GitHub issues.
  • If you have an idea, use GitHub issues.
  • There is also a Google Group for general discussions or to follow release announcements.
  • If you want to contribute, fork the project and submit a pull request.

Requirements - current master

  • Eclipse 4.2 (Juno) or later
  • Java 6 or later
  • Subversion 1.9 JavaHL client libraries

Installation

Subclipse is available in the Eclipse Marketplace and can be installed via the Marketplace Client. It is also available at the following update site URL's.

NOTE: These are update site URL's to be entered inside the Eclipse installation dialog, not your web browser.

  • Latest - https://dl.bintray.com/subclipse/releases/subclipse/latest/
  • 4.2.x - https://dl.bintray.com/subclipse/releases/subclipse/4.2.x/

The "latest" site will automatically move on to 4.2.1, 4.3.0, 5.0.0 etc. as those releases are produced. Where as the "4.2.x" site will only pick up new releases in the 4.2.x series such as 4.2.1, 4.2.2 etc.

There is also a p2 repository for each specific release. These only contain Subclipse and do not pull in the optional plugins that the primary sites do. These sites are mainly for internal use and third party packagers.

If you have problems upgrading from one of the legacy 1.x.y versions, see the FAQ

Available Features

The following features are available on the update site.

  • Subclipse - this is the main feature and the only one that is absolutely required. However, you will also need the JavaHL libraries installed. If you are on Windows, there is another feature on the update site that will provide this. For all other operating systems refer to the relevant pages in this wiki for details.
  • Subclipse JavaHL Windows Binaries - as noted this provides the necessary native Windows DLL's for JavaHL and is required on Windows in order to use the JavaHL API for Subversion.
  • SVNKit Client Adapter - SVNKit is a pure Java reverse-engineered implementation of the Subversion API and is an alternative to using JavaHL. If you install this adapter, then you must also install the SVNKit library which it uses. This is available on the update site as:
    • SVNKit Library - the main SVNKit library
    • JNA Library - used by the SVNKit library to enable some native OS functions it can benefit from using
  • Subversion Revision Graph - this adds an ability to view the history of an item as a graphical revision graph. This requires the Eclipse GEF and Draw2D plugins are installed.
  • Subclipse Integration for Mylyn - if you are using the Eclipse Mylyn plugin and its changeset and focused workspace functionality, this plugin provides an integration between that and Subclipse, so that Mylyn can automatically create SVN changesets.
  • Subclipse Maven Integration - if you are using the m2e Maven Eclipse plugin, this provides the Subclipse SCM handler for that plugin so that a Maven project can execute SVN checkout operations.

Zipped Update Sites

Zipped update sites are also available for download. https://dl.bintray.com/subclipse/releases/subclipse/

Legacy Releases

These are the old releases from tigris.org. They only require Eclipse 3.2 or later, and the required SVN client version varies for each version as noted. These are no longer going to be updated.

  • SVN 1.9.x - https://dl.bintray.com/subclipse/archive/release/1.12.x/
  • SVN 1.8.x - https://dl.bintray.com/subclipse/archive/release/1.10.x/
  • SVN 1.7.x - https://dl.bintray.com/subclipse/archive/release/1.8.x/

Snapshot Builds

Latest Subclipse master branch is built and posted to a p2 repository which you can use to install the latest build. This is available via the following update site URL:

https://dl.bintray.com/subclipse/snapshots/

JavaHL Installation

Subclipse is written against the Subversion Java interface which is called JavaHL. There are two implementations of this interface available:

JavaHL

This is the native implementation provided with Subversion itself. JavaHL is a thin Java API layer that talks to the Subversion native libraries via JNI. Subclipse provides the Java part of this, but you must have the native libraries installed, which means you also have to have the right version of those libraries installed for the version of Subclipse you are using.

Subclipse is able to provide an Eclipse plugin for Windows that includes the needed native DLL's, so installation on Windows is easy. On Linux and Mac, due to differences in how library loading is handled, it is not possible to provide the libraries in a way that "just works". The best option is to install the native packages for your distribution. See:

JavaHL on Linux
JavaHL on OSX

SVNKit

SVNKit is a pure-Java reverse-engineered version of Subversion. It is available via the Subclipse update site which makes it easy to install and use. SVNKit is NOT developed or maintained as part of this project. More information is available at http://svnkit.com

Subclipse is developed and tested primarily against the native JavaHL implementation so that is what we recommend using when possible. The convenience of a pure Java implementation cannot be ignored though, so use whatever works best for you.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.