blob: ddfe91aeff795137ab65fa1471d994169f76f5fe [file] [log] [blame]
<html>
<head>
<title>Headless Building with APT in Eclipse</title>
</head>
<body>
<h1>Headless Building with APT in Eclipse</h2>
<h2>Instructions for building workspaces from the command-line directly or with ant</h3>
<p>
The APT plugin can be used in conjunction with Eclipse to build your preconfigured
workspace, either directly from the command-line or via ant with its built-in ant task.
</p>
<h3>Building from the command-line</h3>
Given an installation of Eclipse with the APT plugin installed, you can invoke the command-line builder
with the following command (with no line breaks):
<pre>
java -cp %ECLIPSE_HOME%/startup.jar org.eclipse.core.launcher.Main
-noupdate -application org.eclipse.jdt.apt.core.aptBuild -data %WORKSPACE%
</pre>
This invokes Eclipse in headless mode and builds the workspace as provided on the command-line.
Any configuration for the provided workspace will be observed in the build.
<p>
<h3>Building with Ant</h3>
Again, you will need an installation of Eclipse with the APT plugin installed. Given this, the "apt"
task can be invoked with the following xml in your build.xml file:
<pre>
&lt;project name="test_eclipse" default="build" basedir=".">
&lt;taskdef name="apt" classname="org.eclipse.jdt.apt.core.build.JdtApt"/>
&lt;target name="build">
&lt;apt workspace="%WORKSPACE%" eclipseHome="%ECLIPSE_HOME%"/>
&lt;/target>
&lt;/project>
</pre>
You will need to add the jar for APT to your ant installation's <b>lib</b> directory, or place it on
the classpath when invoking ant. The jar lives in
<pre>%ECLIPSE_HOME%/plugins/org.eclipse.jdt.apt.core_X/aptcore.jar</pre>