Giusto oggi mi e’ stato chiesto, da un amico che sta muovendo i primi passi con UNIX(e JAVA) e che soprattutto non aveva molta voglia di leggere la documentazione ;), come installare ANT su una macchina Linux quindi ho preso spunto da questa semplice domanda per fare un piccolo howto sull’ argomento.

Ecco il processo:

iniziamo con il prelevare l’ultimo binario(nel momento in cui scrivo e’ l’1.7.0) disponibile dal sito ant.apache.org

$ cd downloads
$ wget http://www.apache.org/dist/ant/binaries/apache-ant-1.7.0-bin.tar.gz

solitamente questi “programmi” li metto in /usr/local dove mantengo la versione originale inalterata sia nel contenuto che nel nome della directory cosi da poter fare dei link che mi permettono in futuro di cambiare velocemente versione senza dover modificare path precedentemente impostati, quindi:

$ cd /usr/local
$ sudo su
# tar zxf ~/downloads/apache-ant-1.7.0-bin.tar.gz
# ln -s apache-ant-1.7.0 apache-ant

fatto?
bene, ora e’ necessario impostare la variabile d’ambiente “ANT_HOME”, e’ possibile renderla disponibile solo per il proprio utente oppure renderala disponibile a tutti, personalmente preferisco la seconda opzione, quindi edito il file /etc/profile

# vi /etc/profile

e aggiungo la seguente riga:

export ANT_HOME=”/usr/local/apache-ant”

poi aggiungo la directory dove risiedono i binari alla variabile PATH(sempre nel file /etc/profile) in questo modo:

PATH=”/usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin:$HOME/bin:$ANT_HOME/bin

cosi da avere disponibile nel mio ambiente i comandi necessari per eseguire ANT, salvo il file appena editato e il gioco e’ fatto.

Ora per vedere se funziona tutto correttamente creiamo un file build.xml dove andremo ad inserire un xml simile a questo:

<project name="IlMioPrimoAnt" default="test-1">
  <target name="test-1">
    <echo>Questo e' il mio primo file ant #1</echo>
  </target>
  <target name="test-2">
    <echo>Questo e' il mio primo file ant #2</echo>
  </target>
</project>

mettiamo che abbia creato il file nella directory temporanea tmp della mia home quindi

$ cd ~/tmp
$ ant
ant
Buildfile: build.xmltest-1:
     [echo] Questo e' il mio primo file ant #1
 
BUILD SUCCESSFUL
Total time: 0 seconds
 
$ ant test-2
Buildfile: build.xml
test-2:
     [echo] Questo e' il mio primo file ant #2
 
BUILD SUCCESSFUL
Total time: 0 seconds

Perfetto, ANT funziona correttamente.

Tutti i task che mette a disposizione ANT sono ben descritti e documentati sulla documentazione ufficiale, oltre alle sue funzioni ANT supporta un discreto numero di tasks opzionali che richiedono pero’ l’ausilio di librerie esterne, anche queste ben documentate nella sezione “Library Dependencies” della socumentazione.
Le librerie esterne, per poter essere utilizzate, devono essere messe o nella dir $ANT_HOME/lib o specificate nel parametro -lib in fase di esecuzione del comando ant oppure nella variabile di sistema CLASS_PATH

Prossimamente un “lezione” su un utilizzo piu’ avanzato di questo, forse un po macchinoso ma utile, programma.

Ciao,
Cristian.