Extending or Contributing to Buckminster
< To: Buckminster Project
If you are going to be working with Buckminster itself, writing your own extensions, or provide patches, you should first install Buckminster as described in The Definitive Guide. As Buckminster source is stored in a Subversion repository, you need to install either a Subversive or a Subclipse client.
Installation for Buckminster contributors
Set up a platform agnostic target platform
Prior to resolving this query you MUST ensure that your workspace is set up with a target platform containing the Eclipse SDK and the delta pack.
- Go to Window -> Preferences -> Plugin-In Development -> Target Platform and select Add...
- A wizard pops up. On the first page, check Nothing: Start with an empty target definition
- On the next page, give you definition a Name such as "Eclipse SDK with delta pack".
- Click Add... (under the Locations tab).
- An Add Content Dialog pops up. Select Software Site
- Select The Eclipse Project Updates site and the Eclipse SDK feature for install.
- Uncheck the Include required software
- Check the Include all environmnents
- Click Finish to get back to the Target Content page
- Click Finish to get back to the Preferences page
- Select (put a check mark in) the new platform to make it current.
- Click OK
We recommend that you restart your Eclipse at this point although it should not be strictly necessary.
Populating the workspace
- Execute one of the following component queries - (Select "File" > "Open a Component Query", and paste in out of these URL's depending on which version you want:
- For head development http://www.eclipse.org/buckminster/samples/queries/buckminster-dev.cquery
- For eclipse 3.5.x http://www.eclipse.org/buckminster/samples/queries/buckminster.cquery
- Press "Resolve & Materialize" in the CQUERY editor that appears
- Buckminster will now fetch and build Buckminster from source.
More elaborate patches to Buckminster
If you are going to contribute code to Buckminster in the form of patches, you may want to look at some of the coding policies and conventions used by Buckminster Committers.