Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Developer's guide to driving the AJDT build process"
(How to build AJDT from the command line) |
|||
| Line 1: | Line 1: | ||
The AJDT automated build process generates various artifacts not created by running an eclipse build, and now provides additional functionality such as packing JARs with the pack200 command, to produce a faster udpate site. However, getting the build working on your own machine has various gotchas, which this page hopes to help you through. | The AJDT automated build process generates various artifacts not created by running an eclipse build, and now provides additional functionality such as packing JARs with the pack200 command, to produce a faster udpate site. However, getting the build working on your own machine has various gotchas, which this page hopes to help you through. | ||
| − | This guide assumes | + | <strong> *** This is work in progress, currently being updated from draft version on another machine - please don't attempt to follow this guide until this comment is removed :-) *** </strong> |
| + | |||
| + | This guide assumes, for now, that your starting point is that you have followed all the steps in the standard developer's guide here: | ||
http://www.eclipse.org/ajdt/developers.php | http://www.eclipse.org/ajdt/developers.php | ||
| − | The first thing | + | It is certainly a good idea to familiarise yourself with the Eclipse environment prior to attempting a command line build, but by no means essent |
| + | |||
| + | The first thing to do is create a root build directory, e.g. | ||
| + | |||
| + | <pre> C:\ajdt\build </pre> | ||
| + | |||
| + | and inside it <strong> two </strong> directories containing Eclipse installs (including AJDT) versions 3.2 and 3.3, e.g.: | ||
| + | |||
| + | <pre>C:\ajdt\build\eclipse32 | ||
| + | C:\ajdt\build\eclipse33 | ||
| + | </pre> | ||
| + | |||
| + | NB The naming of these directories is important so use these names, unless you want to change config files (clue: you don't). Both these versions of Eclipse are required, as the build runs using 3.2 but needs 3.3 to build the latest versions of AJDT. So, the simplest thing to do is run up a couple of versions of Eclipse, install AJDT in each, then copy the file sets to your build directory. | ||
| + | |||
| + | Next you need to patch the two Eclipse installs to use the AJDT version of a file called "pdebuild-ant.jar". You'll find that target version under the two respective eclipse3x directories, e.g.: | ||
| + | |||
| + | <pre> eclipse\plugins\org.eclipse.pde.build_3.2.100.v20061210\lib\pdebuild-ant.jar </pre> | ||
| + | |||
| + | or something silmilar, depending on the versions of the plugin you have. Replace this file with the AJDT version from: | ||
| + | |||
| + | <pre> eclipse\plugins\org.eclipse.ajdt.pde.build_1.5.0.200611060620\lib\pdebuild-ant.jar </pre> | ||
| + | |||
| + | again, allowing for the version of AJDT you have. This patching results in the AspectJ compiler being used instead of the Java one, so is important, as it saves you wasting a lot of time staring at lots of compilation errors :-) | ||
| + | |||
| + | You now need the AJDT build file for the version of AJDT that you want to build. This is not currently available in CVS, so has been added here as a separate document for now: | ||
Revision as of 13:42, 11 January 2007
The AJDT automated build process generates various artifacts not created by running an eclipse build, and now provides additional functionality such as packing JARs with the pack200 command, to produce a faster udpate site. However, getting the build working on your own machine has various gotchas, which this page hopes to help you through.
*** This is work in progress, currently being updated from draft version on another machine - please don't attempt to follow this guide until this comment is removed :-) ***
This guide assumes, for now, that your starting point is that you have followed all the steps in the standard developer's guide here:
http://www.eclipse.org/ajdt/developers.php
It is certainly a good idea to familiarise yourself with the Eclipse environment prior to attempting a command line build, but by no means essent
The first thing to do is create a root build directory, e.g.
C:\ajdt\build
and inside it two directories containing Eclipse installs (including AJDT) versions 3.2 and 3.3, e.g.:
C:\ajdt\build\eclipse32 C:\ajdt\build\eclipse33
NB The naming of these directories is important so use these names, unless you want to change config files (clue: you don't). Both these versions of Eclipse are required, as the build runs using 3.2 but needs 3.3 to build the latest versions of AJDT. So, the simplest thing to do is run up a couple of versions of Eclipse, install AJDT in each, then copy the file sets to your build directory.
Next you need to patch the two Eclipse installs to use the AJDT version of a file called "pdebuild-ant.jar". You'll find that target version under the two respective eclipse3x directories, e.g.:
eclipse\plugins\org.eclipse.pde.build_3.2.100.v20061210\lib\pdebuild-ant.jar
or something silmilar, depending on the versions of the plugin you have. Replace this file with the AJDT version from:
eclipse\plugins\org.eclipse.ajdt.pde.build_1.5.0.200611060620\lib\pdebuild-ant.jar
again, allowing for the version of AJDT you have. This patching results in the AspectJ compiler being used instead of the Java one, so is important, as it saves you wasting a lot of time staring at lots of compilation errors :-)
You now need the AJDT build file for the version of AJDT that you want to build. This is not currently available in CVS, so has been added here as a separate document for now: