Ant - Compila file
In genere, il file build di Ant, chiamato build.xmldovrebbe risiedere nella directory di base del progetto. Tuttavia non ci sono restrizioni sul nome del file o sulla sua posizione. Sei libero di usare altri nomi di file o di salvare il file di build in qualche altra posizione.
Per questo esercizio, crea un file chiamato build.xml ovunque nel tuo computer con i seguenti contenuti:
<?xml version = "1.0"?>
<project name = "Hello World Project" default = "info">
<target name = "info">
<echo>Hello World - Welcome to Apache Ant!</echo>
</target>
</project>Nota che non dovrebbero esserci righe o spazi vuoti prima della dichiarazione xml. Se li consenti, viene visualizzato il seguente messaggio di errore durante l'esecuzione di ant build:
La corrispondenza della destinazione dell'istruzione di elaborazione "[xX] [mM] [lL]" non è consentita.
Tutti i file di build richiedono l'estensione project elemento e almeno uno target elemento.
L'elemento XML project ha tre attributi:
| Sr.No. | Attributi e descrizione |
|---|---|
| 1 | name Il nome del progetto. (Opzionale) |
| 2 | default La destinazione predefinita per lo script di build. Un progetto può contenere un numero qualsiasi di obiettivi. Questo attributo specifica quale target deve essere considerato come predefinito. (Obbligatorio) |
| 3 | basedir La directory di base (o) la cartella principale del progetto. (Opzionale) |
Un obiettivo è una raccolta di attività che si desidera eseguire come un'unità. Nel nostro esempio, abbiamo un semplice obiettivo per fornire un messaggio informativo all'utente.
Le destinazioni possono avere dipendenze da altre destinazioni. Ad esempio, adeploy target può avere una dipendenza da package target, il package target può avere una dipendenza da compileobiettivo e così via. Le dipendenze sono indicate utilizzando ildependsattributo. Ad esempio:
<target name = "deploy" depends = "package">
....
</target>
<target name = "package" depends = "clean,compile">
....
</target>
<target name = "clean" >
....
</target>
<target name = "compile" >
....
</target>L'elemento di destinazione ha i seguenti attributi:
| Sr.No. | Attributi e descrizione |
|---|---|
| 1 | name Il nome del target (obbligatorio) |
| 2 | depends Elenco separato da virgole di tutti i target da cui dipende questo target. (Opzionale) |
| 3 | description Una breve descrizione del target. (opzionale) |
| 4 | if Consente l'esecuzione di un obiettivo basato sull'esattezza di un attributo condizionale. (opzionale) |
| 5 | unless Aggiunge la destinazione all'elenco delle dipendenze del punto di estensione specificato. Un punto di estensione è simile a un obiettivo, ma non ha attività. (Opzionale) |
Il echotask nell'esempio precedente è un'attività banale che stampa un messaggio. Nel nostro esempio, stampa il messaggio Hello World .
Per eseguire il file di build ant, apri il prompt dei comandi e vai alla cartella in cui risiede build.xml e digita ant info. Puoi anche digitareantanziché. Entrambi funzioneranno, perchéinfoè la destinazione predefinita nel file di build. Dovresti vedere il seguente output:
C:\>ant
Buildfile: C:\build.xml
info: [echo] Hello World - Welcome to Apache Ant!
BUILD SUCCESSFUL
Total time: 0 seconds
C:\>