blob: c9c910b20d2f68e8b6a7c3d40b8e8d3c2e782ef6 [file] [log] [blame]
<?php require_once($_SERVER['DOCUMENT_ROOT'] . "/"); require_once($_SERVER['DOCUMENT_ROOT'] . "/"); require_once($_SERVER['DOCUMENT_ROOT'] . "/"); $App = new App(); $Nav = new Nav(); $Menu = new Menu(); include($App->getProjectCommon()); # All on the same line to unclutter the user's desktop'
# template.php
# Author: Denis Roy
# Date: 2005-06-16
# Description: Type your page comments here - these are not sent to the browser
# Begin: page-specific settings. Change these.
$pageTitle = "AJDT: Information for developers";
$pageKeywords = "AspectJ, AJDT, Aspect Oriented Software Development, Eclipse";
$pageAuthor = "Matt Chapman";
# Add page-specific Nav bars here
# Format is Link text, link URL (can be, target (_self, _blank), level (1, 2 or 3)
# $Nav->addNavSeparator("My Page Links", "downloads.php");
# $Nav->addCustomNav("My Link", "mypage.php", "_self", 3);
# $Nav->addCustomNav("Google", "", "_blank", 3);
# End: page-specific settings
$rightcolumn = file_get_contents("rightcolumn.html");
# Paste your HTML content between the EOHTML markers!
$html = <<<EOHTML
<div id="maincontent">
<div id="midcolumn">
<h1>Information for developers</h1>
<p>AJDT is changing rapidly and so some of this document may be out of date. If you find anything that is out of date or you have any problems following these instructions, please send a note to the <a href="">AJDT mailing list</a>. We are a friendly bunch and want to encourage new developers to contribute to AJDT.</p>
<p>There are many ways to contribute to AJDT even if you are not developing code: answering questions (or asking them) on the mailing list, raising bugs and feature requests, submitting documentation and sample programs, and generally being a constructive member of the community. These are all ways you can help AJDT and AspectJ grow. Of course, we also appreciate code contributions.
<li><a href="#q:contribute">How can I contribute to the AJDT project?</a> </li>
<li><a href="#q:source">Where will I find the source for AJDT? </a> </li>
<li><a href="#q:versions">What do the version numbers mean?</a> </li>
<li><a href="#q:cvs">How can I connect the AJDT CVS repository? </a> </li>
<li><a href="#q:cvsbranch">I am looking for the AJDT branch 1.X in the CVS repository, but I can&rsquo;t find it.
What gives? </a> </li>
<li><a href="#q:develop">How do I setup an AJDT development environment in Eclipse? </a> </li>
<li><a href="#q:packaging">How can I package my sample code for contribution to the examples plug-in?</a> </li>
<li><a href="#q:extend">How can I build tools which extend AJDT?</a> </li>
<a name="q:contribute"></a>
<li><em>How can I contribute to the AJDT project?</em>
Your contributions to the AJDT project are strongly welcomed! You can create a
patch that fixes a bug or provides an enhancement and submit
it to the AJDT developers either as an attachment to a bug in Bugzilla, or as an
attachment to a post to the newsgroup or developer mailing list.
You can also contribute sample code showing interesting uses of AspectJ, by adding
entries to the example plug-in.
All contributions must be made available under the
<a href="">terms of the Eclipse website</a> see
the Eclipse
<a href="">contribution and participation FAQ</a>. Sorry, but for legal reasons
we are unable to accept patches emailed directly to developers, and will
normally ask you to resubmit these either via Bugzilla or the mailing list.
AJDT development is run as a meritocracy, developers who have a track
record of submitting good patches can become committers on the project.
<a name="q:source"></a>
<li><em>Where will I find the source for AJDT?</em>
AJDT source is held in the Eclipse CVS repository under /cvsroot/tools, see the <a
href=""> root
of the AJDT source tree online</a>.
AJDT is organized in subdirectories under org.eclipse.ajdt. The main source
tree is in the &#8220;AJDT_src&#8221; subdirectory. Currently, the HEAD of this directory contains source code
for AJDT 1.6 (for Eclipse 3.4), although this will change to AJDT 1.7 as Eclipse 3.5 moves closer to its final release. The source code for AJDT 1.7 is in the ajdt1_7 branch.
Similarly, the source code for the Eclipse 3.3 version of AJDT is contained in the ajdt1_5 branch,
the source code for the Eclipse 3.2 version of AJDT is contained in
the "ajdt1_4" branch, and the source code for the Eclipse 3.1 version is contained
in the "ajdt1_3" branch. Here is a description of the various AJDT
plug-ins and features. Some CVS folders are skipped because they are no longer relevant to the current AJDT implementation.
<td><strong>Relevant packages under &#8220;AJDT_src&#8221;</strong></td>
<td ><strong>Description</strong></td>
<td colspan="2">Plugins</td>
<td>The AspectJ compiler and related classes</td>
<td>The AspectJ runtime classes packaged in a jar file</td>
<td>The AspectJ weaver packaged in a jar file</td>
<td>Non-UI parts of AJDT</td>
<td>AJDT Core tests</td>
<td>AspectJ examples plug-in</td>
<td>AJDT-Mylyn connector</td>
<td>AJDT-Mylyn connector tests</td>
<td>Headless build plugin. This is used by the headless build process to build AJDT.</td>
<td>Source code for AJDT plug-ins - only populated by the build process. Includes visualizer source code</td>
<td>AJDT UI Tests</td>
<td>The AJDT UI plug-in</td>
<td >org.eclipse.aspectj</td>
<td>The <em>branding</em> plug-in</td>
<td>The Visualiser plug-in</td>
<td>Visualiser tests</td>
<td>JDT Weaving plugin. This plugin contains zips of the Equinox Aspects project that is unzip and added to the update site during the build process. AJDT 1.6+</td>
<td>JDT Weaving plugin source code. AJDT 1.6+</td>
<td >The Cross References plug-in (non-UI)</td>
<td>Tests for the above</td>
<td >The Cross References source code. AJDT 1.6+</td>
<td>The Cross References UI plug-in</td>
<td>Tests for the above</td>
<td colspan="2">Features</td>
<td>The AJDT feature</td>
<td>Eclipse Weaving service feature (includes JDT Weaving). AJDT 1.6+</td>
<td>The Cross References feature</td>
<td >org.eclipse.aspectj.feature-tests</td>
<td>The test feature/td>
<td colspan="2">Other</td>
<td>Non-Java project used to build an update site</td>
<a name="q:versions"></a>
<li><em>What do the version numbers mean?</em>
<p>Each Eclipse point release has a corresponding AJDT point release. Eclipse 3.1
requires AJDT 1.3, Eclipse 3.2 requires AJDT 1.4, Eclipse 3.3 requires AJDT 1.5,
Eclipse 3.4 requires AJDT 1.6, and Eclipse 3.5 requires AJDT 1.7. Future releases
are expected to follow the same numbering system.</p>
<p>In the CVS repository, each point release of AJDT has its own branch. To do development on a
particular version, you must check out the appropriate branch. See <a href="#q:cvs">How can
I connect the AJDT CVS repository? </a>
and <a href="#q:cvsbranch">I am looking for the AJDT branch 1.X in the CVS repository, but
I can't find it. What gives? </a> for more details/p>
<a name="q:cvs"></a>
<li><em>How can I connect the AJDT CVS repository and download?</em>
<p>Use the following credentials to connect to the repository anonymously:<br/>
<tr><td>connection type:</td><td>pserver</td></tr>
If you are connecting to the repository from Eclipse, do the following:
<li>Start with a clean workspace under Eclipse 3.3, 3.4, or 3.5
<li>Open the CVS Repository Exploring perspective.
<li>Right-click on the CVS Repositories view.
<li>Click &ldquo;New&rdquo; &gt; &ldquo;Repository
<li>Fill in the blanks using the above credentials.
<li>Click &ldquo;Finish&rdquo;.
<li>Use the CVS Repositories view to navigate to
<a name="q:cvsbranch"></a>
<li><em>I am looking for the AJDT branch 1.X in the CVS repository, but I can't find it.
What gives? </em>
<p>Each point version of AJDT has its own branch in the CVS repository. It may not be
initially visible if you are browsing the repository through Eclsipe.</p>
<p>To discover a branch, do the following:
<li>Right-click on the <code>org.eclipse.ajdt</code></li>
<li>Select &ldquo;Configure Branches and Versions...&rdquo;
<li>In the dialog that opens navigate to
<li>Various tags should appear in
the right hand side of the dialog</li>
<li>Press &ldquo;Add Checked Tags&rdquo;, then
<li>Back in the CVS Repositories view you should now be able to
navigate to <code>Branches/ajdt1_6/org.eclipse.ajdt ajdt1_6/AJDT_src</code></li>
<a name="q:develop"></a>
<li><em>How do I setup an AJDT development environment in Eclipse?</em>
<p>There are three stages to this: building AJDT, running the
correctness tests, and creating an
Eclipse update site. The first two stages are sufficient
for most purposes.</p>
<h4>Building AJDT</h4>
<p>Many of the plugins which implement AJDT contain aspects, and so are
AspectJ projects themselves. This means that you first need to install
a <em>recent</em> build of AJDT into your development environment from the
update site or zip file.</p>
<p>Note also that in order to build AJDT from source you will probably
need to increase the memory available to Eclipse. This is
typically done by passing something like &ldquo;<code>-vmargs -Xmx512m</code>&rdquo; to
the Eclipse launcher.</p>
<p>See <a href="#q:cvs">How can I connect the AJDT CVS repository?</a> for
instructions on how to download the projects from CVS.</p>
<p>If you are using Eclipse 3.5 you now need to switch to the
&ldquo;ajdt1_7&rdquo; branch in CVS. See <a href="#q:cvsbranch">
I am looking for the AJDT branch 1.X in the CVS repository, but I can&rsquo;t find it.
What gives? </a> for information on how to
discover this branch.</p>
<p>Eclipse 3.4 uses HEAD.</p>
<p>If you are using Eclipse 3.3 you need to switch
to the &ldquo;ajdt1_5&rdquo; branch instead.</p>
<p>If you are using Eclipse 3.2 you need to switch
to the &ldquo;ajdt1_4&rdquo; branch instead. Note that
AJDT 1.4 is only <em>lightly</em> supported now (i.e.,
there is no ongoing development and only major bugs will
be fixed).</p>
<p>Select the following projects,
right-click and select &ldquo;Check out&rdquo; from the context menu:</p>
<p>Eclipse will build the projects as you import them, after
which should you be ready to run the plugins inside Eclipse:</p>
<li>Switch to the Java Perspective if you are not already in
<li>From the run menu select &ldquo;Run...&rdquo;</li>
<li>For Eclipse 3.4, choose <em>AJDT 1.6 Weaving</em></li>
<li>For Eclipse 3.5, choose <em>AJDT 1.7 Weaving</em></li>
<li>Click &ldquo;Run&rdquo;. The reason for using predefined launchers is that in order to enable
JDT Weaving, a custom config.ini is required.</li>
<li>If weaving is not enabled at startup or if there are any other problems with the runtime workspace,
open up the custom config.ini (org.eclipse.contribution.weaving.jdt/config.ini) and make sure the entries
align with your version of Eclipse. You may need to edit the version number on the <em>osgi.bundles</em>
<li>If you continue to have problems, please send a message to the mailing list.</em>
<h4>Running the correctness tests</h4>
<p>The next step is to add the test projects. These can be used to
verify that everything is okay with your environment and
configuration, plus of course to verify the integrity of any
changes you might make. Switch back to the CVS perspective and
check-out the following projects:</p>
<p>Note that since many of these tests will only pass if JDT Weaving to be enabled, special launch
configurations are provided:</p>
<li>All Weaving Tests---runs the JDT Weaving tests</li>
<li>AllUITests_MaxPermSize---runs the AJDT UI tests</li>
<li>AllCoreTests No UI---runs the core tests</li>
<li>Some UI Tests---runs a sub-set of the UI tests as specified in the java file Edit this file to run any sub-set of the UI tests.</li>
<li>Some Random Test case---allows you to run any single test case of AJDT. Edit this launch configuration to specify a project and a test case inside of it. Useful if you are checking only a single test, but don't want to generate a new, custom launch config for it.</li>
<p>If you have any problems with the launch configurations, please send a note to the mailing list.</p>
<h4>Trouble Shooting</h4>
If you are having problems starting your runtime workspace or running the tests, specifically, if Eclipse is in an infinite restart loop (see (<a href="">Bug 235006</a>), then try the following:
<li>Edit org.eclipse.contribution.weaving.jdt/config.ini and comment the line: osgi.framework.extensions=org.eclipse.equinox.weaving.hook</li>
<li>Run Eclipse (this will run Eclipse with JDT Weaving disabled). Some tests will fail and some functionality will not work, but it is possible to test some things in this mode.</li>
<li>Shut down Eclipse</li>
<li>Uncomment the line from config.ini</li>
<li>Restart Eclipse</li>
<p>Now you&srquo;re ready to start enhancing the plugins by adding to or
extending the code in your projects - just use run (or debug) to
try out your changes. When you have a patch to submit to the
project, go to the &ldquo;Team&lrquo; item in the project context menu and
select &ldquo;Create Patch...&rdquo;. Naturally the correctness tests should
also be run, and new tests written to accompany fixes or new
<a name="q:packaging"></a>
<li><em>How can I package my sample code for contribution to the examples plug-in?</em>
The org.eclipse.ajdt.examples plugin contains various sample projects which
are made available under
the Examples category of the New wizard, from where they can be imported into
your workspace as AspectJ projects.
It is easy to add new samples to this plugin, as follows:
<li>Create a jar file containing your source code, and at least one build
configuration file. Place this
in the archive folder of the examples plugin.
<li>Add an entry to the plugin.xml file for your sample project, by copying
one of the existing entries.
<li>Change the src attribute of the import element to refer to your jar
file, and change the title,
description, pagetitle, and pagedescription property names as appropriate, and add
corresponding entries to the file.
<li>Change the build attribute to refer to your default build configuration
file. Your project may contain
more configurations but the one specified here will be the one used to
initially build the project.
<li>Optionally, you can specify an open attribute to the projectsetup element,
which refers to a file,
such as a README file, which is opened after the project has been imported
to the workspace.
<a name="q:extend"></a>
<li><em>How can I build tools which extend AJDT?</em>
See this Eclipsepedia page: <a href="">Developer&rsquo;s guide to building tools on top of AJDT and AspectJ.</a>
<hr class="clearer" />
# Generate the web page
$App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html);