Spaces/Building from source

The plug-ins and the spaces project update site can be built using Buckminster. Here is a step by step instruction on how to do that. Detailed instructions can be found here.

Installing Buckminster

See to that you have Buckminster installed. You must have a version where core feature is of 1.0.0.r08888 or later. In addition to the core feature, you will need support for PDE and SVN (Subclipse or Subversive doesn't matter. Pick your favorite but not both).

Getting all the source

1. Use File -> Open a Component Query and enter the following URL: http://www.eclipse.org/spaces/queries/spaces.cquery.
2. The Buckminster CQUERY opens up. Click on the button Resolve and Materialize. This should bring all projects from the spaces SVN repository into your workspace.

Properties needed for the build

The build will require two properties to be set:

qualifier.replacement.*=generator:lastRevision
generator.lastRevision.format=r{0,number,00000}

and the output can be controlled using a third property:

buckminster.output.root=<a folder of choice>

This property will default to the folder ${user.temp}/buckminster.

There are multiple ways to assign properties to a build. You can either appoint a file that contains these properties when you execute the action (the file build.properties is provided in the org.eclipse.spaces.update project for this purpose), or you can specify them as string substitutions under the Run/Debug preference page.

Building

1. Right click on the project org.eclipse.spaces.update
2. Choose Buckminster
3. Choose Invoke action...
4. In the action dialog, select build.site
5. Enter the name of the properties file (this step is optional if you have your properties defined as string substitutions
6. Click OK.

Deploying

The resulting product is found here

${buckminster.output.root}/org.eclipse.spaces.update_0.1.0-buckminster/site

. It will be one single file with a name similar to spaces.archivedsite-0.1.0.r10449_incubation.zip The version qualifier at the end reflects the revision of the SVN repository and will thus change over time.

You can use this update site directly by doing the following:

1. Help -> Software Updates -> Find and Install
2. Check Search for new features to install. You do this even if you are updating.
3. Click Next
4. Click on the button New Archived Site...
5. In the dialog that pops up, enter the path of the archived site that was the product of your build.
6. Click Open
7. Accept the default name by clicking OK
8. Continue the install as you normally would.

That's all folks.