Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
- 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
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 -
- 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
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/
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 -
- SVN 1.8.x -
- SVN 1.7.x -
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:
Subclipse is written against the Subversion Java interface which is called JavaHL. There are two implementations of this interface available:
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:
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.