developers/_building.html

<h2><strong>Building</strong> AMP from source.</h2>

<p>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.<p>

<h3>Prerequisites</h3>
<ul>
	<li>Java SDK 5 or higher (6 preferred)</li>
	<li>Eclipse SDK 3.5 or higher</li>
	<li>A number of plugins and dependencies -- see below</li>
</ul>

<h3>Steps</h3>

<ol>

	<li><b>Download and install Eclipse</b> Galileo (Eclipse 3.5.x) - <a
		href="http://www.eclipse.org/downloads/" rel="nofollow">download</a>. 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 <a href="http://download.eclipse.org/eclipse/downloads/">milestone and interim builds</a> --
		These are the versions we usually and are recommended if you run into any issues with the releases.
	</li>
	<li><b>Install Plugins and Dependencies</b> as described below, <b>or source code bundles</b>, see <a href="../installing/downloads.php">file downloads</a>.
	<ol><li>Launch Eclipse</li>
	<li>Open the installation dialog (Help -&gt; Install new
	software...)</li>
	<li>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.
	<h5>Dependencies</h5>
	<p>(AMF, AGF Chart) 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/)</p>
	<ul>
	<li>Modeling
	<ul>
		<li>EMF - Eclipse Modeling Framework SDK 2.5</li>
		<li>MWE</li>
		<li>Xpand SDK</li>
		<li>XSD - XML Schema Definition SDK</li>
		<li>Xtext SDK</li>
	</ul>
	<li>Business Intelligence, Reporting and Charting
	<ul>
		<li>BIRT Framework</li>
	</ul>
	</li>
	</ul>
	<p>(AGF) From the Eclipse GEF Update Site: http://download.eclipse.org/tools/gef/updates/milestones</p>
	<ul>
		<li>Graphical Editing Framework GEF All-In-One SDK</a></li>
	</ul>	
	<p>(AGF3D / GEF3D) From the LWLGL libraries from: http://lwjgl.org/update</p>
	<ul>
		<li>Everything</a></li>
	</ul>
	<h5>Repast Dependencies (Optional)</h5>
	<p>If you'd like to use any Repast target features, you'll want that. See the <a href="http://repast.sourceforge.net/docs/development.html">Repast Development</a> 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.</p>
	</li>
	<li>Restart Eclipse</li>
	</ol>
<li><b>Get the source.</b>
<p>A Team Project Set is available at <a href="http://eclipse.org/amp/developers/amp.psf">http://eclipse.org/amp/developers/amp.psf</a>. Simple import the team project set to get all of the sources.</p>
<p>Or, if you want to pick the sources yourself here are the details:</p>
<small></small><p>See <a href="repositoryDetails.php">CVS Page</a> for repository details.</p>
<ul>
<li>
	<p>Within the main module, the AMP repository is organized into these components:</p>
	<ul>
	<li>org.eclipse.amp.amf</li>
	<li>org.eclipse.amp.axf</li>
	<li>org.eclipse.amp.agf</li>
	<li>org.eclipse.amp.escape</li>
	</ul>
</li><li>
	<p>There are also a number of projects in:</p>
	<ul>
	<li>dependencies</li>
	<li>org.ascape</li>
	</ul>
</li><li>
	<p>Each module is organized in the standard way:</p>
	<ul>
	<li>features</li>
	<li>plugins</li>
	<li>examples</li>
	<li>tests</li>
	</ul>
</li>
</ul>
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.)</small>
</li>
<li><b>Final Steps.</b>
<ol>
	<li>Make sure you use ISO-8859-1 as default text file encoding
	(Preferences &rarr; Workspace &rarr; Text file encoding &rarr; Other =
	ISO-8859-1</li>
	<li>Do a clean build. Project &rarr; Clean.. &rarr; Clean all Projects.</li>
	<li>Please report any issues to the AMP newsgroup.</li>
</ol>
</ol>