Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h2>What is in the AWare distribution?</h2>

<p>The Aware distribution is splitted by components in the following way, so that it is possible to use (and build or test) one single component if you are interested in only one of those:</p>

<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
root
    build.xml
    /lib                                            contains a lot of dependancies, but each component does not use them all
    /src                                            for Aware shared classes
    /components/
        &lt;component name>                            a specific component
           /main
              /org/codehaus/aware/&lt;component name>/ the component name is a reserved package name for the component source
           /test
           /build.xml
</pre></td></tr></table>

<h2>Running AWare samples</h2>

<p>To run AWare samples you will need:</p>
<ul class="alternate">
	<li>an <a href="http://aspectwerkz.codehaus.org/releases.html">AspectWerkz 1.x distribution</a></li>
	<li>set <strong>ASPECTWERKZ_HOME</strong> environment variable to point to the folder containing the AspectWerkz distribution</li>
	<li>have an Ant installation on your system</li>
	<li>invoke the Ant <strong>sample</strong> target, specifying if you want all components or only a specific one</li>
</ul>

<p>Note: if you plan to build your own version of AspectWerkz 1.0 from the cvs, remember to checkout from the branch tagged &quot;branch_1_0&quot;. Refer to AspectWerkz documentation for more information.</p>

<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="java" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6amF2YX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
// we assume you have Ant installed,
// a suitable AspectWerkz distribution in C:\aw
// and AWare in C:\aware

// note: do not add ending slash
set ASPECTWERKZ_HOME=C:\aw

cd C:\aware

// run a specific component test or sample (see component documentation)
ant sample:&lt;component name>
// e.g. :
// ant sample:jmx
</pre></td></tr></table>

<p>Component names are the name of the <em>components</em> sub-folder: indexing, sequence, jmx, etc, and you should read <a class="confluence-link" href="/display/AWARE/Home" data-linked-resource-id="2940" data-linked-resource-type="page" data-linked-resource-default-alias="Home" data-base-url="http://docs.codehaus.org">Components documentation</a> to learn more about them.</p>

<h2>Building AWare</h2>

<p>To (re)build an AWare distribution you will need</p>
<ul class="alternate">
	<li>an <a href="http://aspectwerkz.codehaus.org/releases.html">AspectWerkz 1.x distribution</a></li>
	<li>set <strong>ASPECTWERKZ_HOME</strong> environment variable to point to the folder containing the AspectWerkz distribution</li>
	<li>have an Ant installation on your system</li>
	<li>invoke the Ant target, specifying if you want all components or only a specific one</li>
</ul>

// note: do not add ending slash
set ASPECTWERKZ_HOME=C:\aw

cd C:\aware

// run a specific component test or sample (see component documentation)
ant sample:&lt;component name>
ant compile:&lt;component name>
ant test:&lt;component name>

...

// rebuild the AWare jar from scratch
ant clean
ant compile
ant jars
//
// "ant test" might be a good idea as well
</pre></td></tr></table>