Building AMP from source.

Building AMP from source is not as hard as you'd think. If you want to be up on the absolute latest, this is the way to go.

Prerequisites

  • Java SDK 5 or higher (6 preferred)
  • Eclipse SDK 3.5 or higher
  • A number of plugins and dependencies -- see below

Steps

  1. Download and install Eclipse Galileo (Eclipse 3.5.x) - download. We suggest Eclipse Classic build or Eclipse Modeling Tools. (If you install the later you won't need to get the modeling dependencies below, but its a huge download with a bunch of stuff you don't need.) You may also use the latest milestone and interim builds -- These are the versions we usually and are recommended if you run into any issues with the releases.
  2. Install Plugins and Dependencies as described below, or source code bundles, see file downloads.
    1. Launch Eclipse
    2. Open the installation dialog (Help -> Install new software...)
    3. Select the latest milestone builds of the following features for installation. Note that if you just intend to build parts of the system, you may not need all of these.
      AMF Dependencies

      From the Eclipse Galileo Update Site Modeling category: (Or use a more recent build from the Modeling Project Milestone Update Site: http://download.eclipse.org/modeling/emf/updates/milestones/)

      1. EMF SDK 2.5
      2. MWE 0.7.x
      3. XPand SDK
      4. XSD - XML Schema Definition SDK
      5. XText SDK
      AGF Dependencies

      From the Eclipse GEF Update Site: http://download.eclipse.org/tools/gef/updates/milestones

      1. Graphical Editing Framework GEF All-In-One SDK

      From the Eclipse Galileo Update Site Business Intelligence, Reporting and Charting Tools category

      1. BIRT Framework
      AGF 3D Dependencies (Optional)

      If you want to build the agf3d plugins, you will need GEF3D. Please see the GEF3D Installation Page for details.

      Repast Dependencies (Optional)

      If you'd like to use any Repast target features, you'll want that. See the Repast Development page. Note that you can build by including only the repast.simphony.score project. That's what we generally do as it avoids needing to install a bunch of other tools like groovy. Then you can still target the actual Repast environment at runtime, but the setup for that is beyond the scope of this document.

    4. Restart Eclipse
  3. Get the source.

    See CVS Page for repository details.

    • Within the main module, the AMP repository is organized into these components:

      • org.eclipse.amp.amf
      • org.eclipse.amp.axf
      • org.eclipse.amp.agf
      • org.eclipse.amp.escape

    • There are also a number of projects in:

      • dependencies
      • org.ascape

    • Each module is organized in the standard way:

      • features
      • plugins
      • examples
      • tests
    Grab everything from the plugins directories of each module, except that you only need org.eclipse.emf.java and org.jdom from dependencies. (Unless you are planning on releasing code, you really only need the contents of the plugin projects to build.)
  4. Final Steps.
    1. Make sure you use ISO-8859-1 as default text file encoding (Preferences → Workspace → Text file encoding → Other = ISO-8859-1
    2. Do a clean build. Project → Clean.. → Clean all Projects.
    3. Report any issues to the AMP newsgroup.