Riassumo quello che senz'altro sarà già scritto nei tutorial collegati. Tutto sta nel file build.xml e nei percorsi, assoluti o relativi, richiesti per la compilazione dei tuoi sorgenti. E' un file xml quindi parte con il prologo:
<?xml version="1.0"?>
L'elemento principale è "project". Puo anche essere un semplice:
<project>
<!-- qui andrà il resto -->
</project>
Le varie azioni che ant può compiere sulla base dei dati forniti in questo build.xml sono specificate in altrettanti elementi target. Ogni target ha un nome che lo identifica.
<?xml version="1.0"?>
<project>
<target name="compile">
<!-- qui i nodi di compilazione -->
</target>
</project>
La compilazione di per sè è fatta col comando javac che può essere semplicemente:
<javac srcdir="sources" destdir="classes"/>
dove "srcdir" specifica la cartella da cui prelevare i file sorgente e "destdir" la cartella in cui produrre i file class.
<?xml version="1.0"?>
<project>
<target name="compile">
<javac srcdir="sources" destdir="classes"/>
</target>
</project>
Qui devi avere già una cartella sources e una cartella classes. Cioè la struttura dei file del tuo progetto deve essere una cosa di quest tipo:
... = cartella radice, una qualsiasi
.../build.xml
.../sources/[i file sorgenti, con o senza cartelle dei package]
.../classes/[qui dentro ant creerà i file class con relative cartelle]
Per creare la documentazione la storia è la stessa solo che al posto del nodo javac usi javadoc. Per una qualche bizzarra ragione al posto di "srcdir" l'elemento javadoc usa "sourcepath" ma la coerenza è sempre un optional.
Come prima, un target, un nome e dentro al target il "compito":
<target name="makedoc">
<javadoc sourcepath="sources" destdir="docs"/>
</target>
Anche qui devi avere creato prima una cartella "docs" nella directory del tuo progetto. Il file build.xml completo è diventato:
<?xml version="1.0"?>
<project>
<target name="compile">
<javac srcdir="sources" destdir="classes"/>
</target>
<target name="makedoc">
<javadoc sourcepath="sources" destdir="docs"/>
</target>
</project>
Per far partire il programma... un target, un nome e un elemento "java". L'elemento java richiede al minimo il nome pienamente qualificato della classe che contiene il punto d'entrata. Poichè di solito si producono i file class del proprio progetto in una cartella diversa da quella in cui si trova il file build.xml, occorre anche indicare dove si trovino. Nel nostro caso, i file class sono prodotti da "compile" nella cartella "classes". Quando mi capita, io specifico sempre anche l'attributo fork="true". Quest'opzione fa sì che ant lanci il programma non nella JVM che esegue ant ma in un'altra JVM. Lo faccio perchè altrimenti non mi funzionano le applicazioni che usao il Thread ED di Swing. Il target che lancia il programma è:
<target name="execute">
<java classname="pinco.PallinoMain" classpath="classes" fork="true"/>
</target>
Ora il file build.xml è diventato:
<?xml version="1.0"?>
<project>
<target name="compile">
<javac srcdir="sources" destdir="classes"/>
</target>
<target name="makedoc">
<javadoc sourcepath="sources" destdir="docs"/>
</target>
<target name="execute">
<java classname="testant.Main" classpath="classes" fork="true" />
</target>
</project>
Con questo file build, per compilare usi:
ant compile [invio]
per creare la documentazione:
ant makedoc [invio]
per eseguire il programma:
ant execute [invio]
Ho specificato tre diversi target ma la storia si può portare avanti anche in un target solo.
<?xml version="1.0"?>
<project>
<target name="all">
<javac srcdir="sources" destdir="classes"/>
<javadoc sourcepath="sources" destdir="docs"/>
<java classname="testant.Main" classpath="classes" fork="true"/>
</target>
</project>
Oppure, forse più saggiamente, puoi creare un quarto target che esegua gli altri tre. Si fa con le dipendenze, specificate dall'attributo "depends" dell'elemento "target". Un target "all" che dipenda da "compile", "makedoc" ed "execute" e pertanto causi l'esecuzione preliminare di quei compiti sarebbe:
<target name="all" depends="compile,makedoc,execute"/>
Se lo infili nel precedente build.xml:
<?xml version="1.0"?>
<project>
<target name="compile">
<javac srcdir="sources" destdir="classes"/>
</target>
<target name="makedoc">
<javadoc sourcepath="sources" destdir="docs"/>
</target>
<target name="execute">
<java classname="testant.Main" classpath="classes" fork="true"/>
</target>
<target name="all" depends="compile,makedoc,execute"/>
</project>
e, come prima, esegui
ant all
ottieni la successione di compilazione, documentazione ed esecuzione.
Il build.xml che abbiamo creato è il minimo funzionale. Anzi, a dir la verità ha pure qualche pinzillacchera in più. Ovviamente quei file build.xml lunghi venti kilometri non sono scritti da persone a cui piace complicarsi la vita: ci sono una marea di opzioni che si possono specificare ed ognuna ha la sua utilità specifica. Ma da qualche parte bisogna pur iniziare e la mia modestissima opinione è che sia meglio iniziare dal poco necessario.