Building AMP from source.
This page just got a lot shorter -- we've completely revamped the AMP
build setup using Buckminster, Hudson and Git. Now you can get your
entire workspace populated, and install all of your dependencies
in a few easy steps! The only thing you need to have is familiarity
with the Eclipse IDE and managing update sites. If you want to be up on
the absolute latest, experiment with the framework itself, help with
documentation, or -- best of all -- create patches and fixes for the
project, building from source is the way to go:
- Get the latest Eclipse Indigo release. (Use the Modeling
release, or just install the SDK and pick the tools you'll need later.
You don't need to worry about dependencies themselves, Buckminster
handles that for you!)
- Install these few features (Help → Install New
- Buckminster from:
(You don't need the Maven feature.)
- EGit and JGit from the Indigo site Collaboration category.
(If you're using Eclipse Modeling download, you'll already have
- The GEF3D project uses SVN (but not for long!)
You'll need the Buckminster Subversive support as well from the site
- Import the target platform and workspace.
- In the wizard enter:
- Click Load, wait for that to finish and click Finish.
- Repeat above steps using:
- Some warnings are expected.
Optional steps recommended for committers and potential contributors:
- Create a target platform in your workspace. You'll need to do
this before you import your target platform. (The target
platform is the set of features needed to build the tool as
opposed to the tools needed to develop the tool. There is a
- File→New→Other..→General→ Project. Name
- Eclipse→Preferences →Plugin-in Development
- Click Add.., Select "Empty", click Next, and then add the TP
directory to the new definition. Name it "TP".
- Don't forget to activate your TP by clicking the checkbox.
- If you're planning on committing code at some point (you know
who you are!) don't forget to change the git push settings to
configure git in preferences and change your push configuration to use
To try out your source build, just create an Eclipse Application. See
documentation for more information.
- Select Run → Run Configurations..
- Select Eclipse Application and click "New Launch
- The default "All Workspace and Enabled Target Plugins.."
option is fine. If you want to specify individual plugins, you will
probably need at least:
Then, select the "Add Required Plugins" button.
- Click the Run button.
- A new Eclipse application should launch. Note that you can
also launch using the Debugger which is helpful for debugging issues
with AMP models.
Problems? Send a note to the amp-developer list or our newsgroup.