Permalink
0590485 Jan 11, 2017
@donat @etiennestuder @oehme
94 lines (70 sloc) 6.44 KB

Installation instructions

Requirements

Buildship 2.x can be installed into Eclipse 4.2 or newer, whereas Buildship 1.x can be installed into Eclipse 3.6-4.6. Different Eclipse versions might be compatible but they aren't explicitly tested. Depending on the Gradle version that Buildship uses for a project import, certain features may not be available.

Installing from eclipse.org update site

We propose you install Buildship from the Eclipse Marketplace.

Buildship is also available through one of the provided composite update sites listed on eclipse.org.

For manual installation use one of the update sites below.

Update sites for Buildship 2.x

Eclipse Version Type Update Site
Neon (4.6) release http://download.eclipse.org/buildship/updates/e46/releases/2.x
milestone http://download.eclipse.org/buildship/updates/e46/milestones/2.x
snapshot http://download.eclipse.org/buildship/updates/e46/snapshots/2.x
Mars (4.5) release http://download.eclipse.org/buildship/updates/e45/releases/2.x
milestone http://download.eclipse.org/buildship/updates/e45/milestones/2.x
snapshot http://download.eclipse.org/buildship/updates/e45/snapshots/2.x
Luna (4.4) release http://download.eclipse.org/buildship/updates/e44/releases/2.x
milestone http://download.eclipse.org/buildship/updates/e44/milestones/2.x
snapshot http://download.eclipse.org/buildship/updates/e44/snapshots/2.x
Kepler (4.3) release http://download.eclipse.org/buildship/updates/e43/releases/2.x
milestone http://download.eclipse.org/buildship/updates/e43/milestones/2.x
snapshot http://download.eclipse.org/buildship/updates/e43/snapshots/2.x
Juno (4.2) release http://download.eclipse.org/buildship/updates/e42/releases/2.x
milestone http://download.eclipse.org/buildship/updates/e42/milestones/2.x
snapshot http://download.eclipse.org/buildship/updates/e42/snapshots/2.x

Update sites for Buildship 1.x

Eclipse Version Update Site
Neon (4.6) http://download.eclipse.org/buildship/updates/e46/releases/1.0
Mars (4.5) http://download.eclipse.org/buildship/updates/e45/releases/1.0
Luna (4.4) http://download.eclipse.org/buildship/updates/e44/releases/1.0
Kepler (4.3) http://download.eclipse.org/buildship/updates/e43/releases/1.0
Juno (4.2) http://download.eclipse.org/buildship/updates/e42/releases/1.0
Indigo (3.7) http://download.eclipse.org/buildship/updates/e37/releases/1.0
Helios (3.6) http://download.eclipse.org/buildship/updates/e36/releases/1.0

The continuous integration server generates nightly snapshot releases each day 23:00 CET which instantly become available at the snapshot update sites above. In regular intervals, the Buildship team also creates new milestone releases and makes them available at the milestone update sites.

Apply the following instructions to install the latest snapshot or milestone of Buildship into Eclipse.

  1. In Eclipse, open the menu item Help >> Install New Software.
  2. Paste the appropriate update site link into the Work with text box.
  3. Click the Add button at the top of the screen, give the update site a name, and press OK.
  4. Ensure that the option Group Items by Category is enabled.
  5. Select the top-level node Buildship: Eclipse Plug-ins for Gradle once it appears.
  6. Click Next. This may take a while.
  7. Review the list of software that will be installed. Click Next again.
  8. Review and accept the licence agreement and click Finish.

Installing from builds.gradle.org update site

We propose you install Buildship from eclipse.org. If, for any reason, you still want to install from builds.gradle.org, the following snapshot update sites are available for all the supported Eclipse versions:

  • https://builds.gradle.org/repository/download/Tooling_Master_IntegrationTests_Linux_Eclipse46Build/.lastSuccessful/update-site (latest 4.6 development snapshot)
  • https://builds.gradle.org/repository/download/Tooling_Master_IntegrationTests_Linux_Eclipse45Build/.lastSuccessful/update-site (latest 4.5 development snapshot)
  • https://builds.gradle.org/repository/download/Tooling_Master_IntegrationTests_Linux_Eclipse44Build/.lastSuccessful/update-site (latest 4.4 development snapshot)
  • https://builds.gradle.org/repository/download/Tooling_Master_IntegrationTests_Linux_Eclipse43Build/.lastSuccessful/update-site (latest 4.3 development snapshot)
  • https://builds.gradle.org/repository/download/Tooling_Master_IntegrationTests_Linux_Eclipse42Build/.lastSuccessful/update-site (latest 4.2 development snapshot)

Apply the following instructions to install the latest snapshot of Buildship into your version of Eclipse.

  1. In Eclipse, open the menu item Help >> Install New Software.
  2. Paste the update site link that matches your Eclipse version into the Work with text box.
  3. Click the Add button at the top of the screen, give the update site a name, and press OK.
  4. If prompted, set the following credentials: username=guest, password=guest.
  5. Ensure that the option Group Items by Category is enabled.
  6. Select the top-level node Buildship: Eclipse Plug-ins for Gradle once it appears.
  7. Click Next. This may take a while.
  8. Review the list of software that will be installed. Click Next again.
  9. Review and accept the licence agreement and click Finish.

Updating from update site

If you have already installed Buildship, you can update to the most recent version by opening the menu item Help >> Check for Updates. Note, that the update works only if Buildship was installed from the updates sites from download.eclipse.org or from builds.gradle.org, as listed above. If Buildship comes preinstalled in your Eclipse (for instance if you use the standard Eclipse for Java developers package) then you have to do the update manually. To do that just follow the steps from the previous section.