Le attività di importazione vengono utilizzate per importare un file di build nel progetto corrente. I file importati vengono analizzati utilizzando ProjectHelper. ProjectHelper è effettivamente responsabile dell'analisi dei file importati.
L'attività di importazione è un'attività di livello superiore, quindi non può essere utilizzata all'interno dell'elemento di destinazione. Ci sono due aspetti funzionali legati a questo compito.
Ignoramento dell'obiettivo
Se una destinazione nel file corrente è disponibile anche nel file importato, la destinazione del file corrente avrà la precedenza.
Proprietà speciali
I file importati sono locali nel progetto principale corrente. Per distinguere tra file importati e locali, Ant aggiunge una proprietà che contiene il percorso del file di build importato.
Nota: se il file importato non contiene l'attributo name, la sua proprietà non verrà impostata.
Attributi dell'attività di importazione di Apache Ant
| Attributo | Descrizione | Necessario |
|---|---|---|
| file | Il file da importare. | SÌ |
| opzionale | Se vero, non interrompere la compilazione se il file non esiste. | NO |
| COME | Specifica il prefisso anteposto ai nomi di destinazione. | NO |
| prefissoSeparatore | Un separatore da utilizzare tra il prefisso e il nome di destinazione. | NO |
Esempio di attività di importazione di Apache Ant
Il codice seguente importa le destinazioni dal file common-targets.xml situato nella directory principale.
Importa un progetto
Importa il target dal file target.xml che si trova all'interno della directory comune.