Skip to content

Home

Jump to bottom
Mark Phippard edited this page Feb 3, 2021 · 23 revisions

Help/Contributing

  • If you need help, use StackOverflow.
  • If you found a bug, use GitHub issues.
  • For questions, ideas on features or general comments, use GitHub discussions
  • 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 8 or later
  • Subversion 1.10 - 1.14 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://subclipse.github.io/updates/
  • 4.3.x - https://subclipse.github.io/updates/subclipse/4.3.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.3.x" site will only pick up new releases in the 4.3.x series such as 4.3.1, 4.3.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 and/or SVNKit features installed as these provide the connection to a Subversion API library.
  • Subversion 1.10 JavaHL - (you may need to tell Eclipse to show all versions to see this). This feature includes the JavaHL library AND for Windows it also includes the native DLL libraries.
  • Subversion 1.11 JavaHL - This feature includes the JavaHL library AND for Windows it also includes the native DLL libraries. You can only install one of these two versions.
  • Subversion 1.14 JavaHL - This feature includes the JavaHL library AND for Windows it also includes the native DLL libraries. You can only install one of these two versions.
  • 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

As of the 4.3.2 release, zipped update sites are available for download from the Github Release detail page. For earlier releases, zipped update sites are available for download at https://github.com/subclipse/updates/tree/main/subclipse

Legacy Releases

These are releases that have been superseded by the current version. These should only be used if you specifically need support for an older version of Subversion on the client.

  • SVN 1.9.x - https://subclipse.github.io/updates/subclipse/4.2.x/

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://subclipse.github.io/updates/subclipse/1.12.x/
  • SVN 1.8.x - https://subclipse.github.io/updates/subclipse/1.10.x/
  • SVN 1.7.x - https://subclipse.github.io/updates/subclipse/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://subclipse.github.io/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.

Clone this wiki locally