Krótki kurs Anta

task, target, project..

Słowa kluczowe pliku konfiguracyjnego Anta

Apache Ant is a Java-based build tool. In theory, it is kind of like make, without make's wrinkles.

• podróż pociągiem
• lot samolotem
• płynięcie statkiem
• przygotowywanie do podróży poprzez pakowanie się

Składnia używania zmiennych:
${variable}, i.e. <mkdir> dir="${build.dir}" />

możemy czytać zmienne z pliku konfiguracyjnego:

build.properties:

            build.dir=build/
            dist.dir=dist/
            archive.filename=archive.tgz
            ...
            

możemy użyć wbudowanych zmiennych:

• basedir
• ant.file
• ant.version
• ant.project.name
• ant.java.version

definiowanie własnych zmiennych:

<property name="build.dir" location=".." />
<property name="src.dir" location="src/" />
<property name="archive.filename" value="archive.tgz" />
            

użycie zmiennych:

<echo> Źródła są tutaj: ${src} <echo>

Archiwizacja

<bzip2>, <gzip>, <tar>, <zip>, <jar>, <war>, <ear>, ...

Kompilacja

<javac>, <rmic>, ...

Dokumentacja

<javadoc>, <doxygen>

Deployment

 

Zadania logujące czynności (logging tasks)

 

Mail

<mail>

Różne

<echo>, <sound>, <splash>, <sql>, ...

.NET

 

Pre-process

 

Property Tasks

 

Zdalne usługi (remote)

<ftp>, <telnet>

SCM

<cvs>, <cvspass>, <perforce>, <starteam>, ...

Testowania (testing tasks)

<junit>, <junitreport>, <test>

Visual Age for Java

 

Hint!
Zadania: <DirSet>, <FileList>, <FileSet>, <File Mappers>, <FilterChains> i <FilterReaders>, <FilterSet>, <PatternSet>, <Selectors>, <XMLCatalog> są zwane Core types

<!-- ... -->
<fileset dir="${server.src}" casesensitive  ="yes" >
    <include name="**/*.java"/>
    <exclude name="**/*Test*"/>
</fileset>
<!-- ... -->
        

Jak widać, łatwo jest wybrać pliki wewnątrz naszej struktury katalogów. (zakładam, że istnieje jakaś ;-) )

Pierwszy przykład:
Zadanie <javac> kompiluje pliki źródłowe ze wskazanych katalogów.

    <target name="compile" depends="...">
        <javac
            destdir="${build.classes.dir}"
            deprecation="on">

            <include name="**/*.java" />
            <src path="${src.main.dir}" />
            <src path="${src.prevayler.dir}" />
            <src path="${src.ant.dir}" />

        </javac>
    </target>
        

Drugi prosty przykład:
Tu pokażemy, użycie zadania: <copy>, które kopiuje pliki lub katalogi pod wskazane miejsce.

<copy file="myfile.txt" todir="../some/other/dir"/>
        

Trzeci przykład:

<copy todir="../dest/dir" >
<fileset dir="src_dir" >
<exclude name="**/*.java"/>
</fileset>
</copy>
        

Istnieje także zadanie, które pozwala na uruchomienie testów Junit.

<junit>
<test name="my.test.TestCase" />
</junit>
        

Bardziej zaawansowany przykład:

<junit printsummary="yes" haltonfailure="yes">
    <classpath>
      <pathelement location="${build.tests}" />
      <pathelement path="${java.class.path}" />
    </classpath>

    <formatter type="plain" />

    <test name="my.test.TestCase" haltonfailure="no" outfile="result" >
        <formatter type="xml" />
    </test>

    <batchtest fork="yes" todir="${reports.tests}">
        <fileset dir="${src.tests}">
        <include name="**/*Test*.java" />
        <exclude name="**/AllTests.java" />
        <!-- ... -->
        

Plik, który będziemy generowali, wygląda tak:

package nthx.some_project.tests;

import nthx.some_project.order.action.tests.UpdateWorkingDaysInWorkstandActionTest;
import nthx.some_project.order.action.tests.AddWorkingDaysToWorkstandActionTest;
        /** 
         *  many imports more..
         *  cut here 
         */
import junit.framework.*;

public class MasterTest extends TestCase {

    public static Test suite() {
        TestSuite result = new TestSuite();

        result.addTest(new TestSuite(StringUtilsTest.class));
        result.addTest(new TestSuite(OrderTest.class));
        /** 
         *  50 lines more..
         *  cut here 
         */
        result.addTest(new TestSuite(UpdateWorkersExperiencesBeanTest.class));
        result.addTest(new TestSuite(InsertWorkerBeanTest.class));
        return result;
    }