java_ApacheAnt_tutorial.pdf

(136 KB) Pobierz
Apache Ant
Ant jest narzędziem umożliwiającym automatyzację procesów związanych
z budowaniem programów. Jego podstawowe cechy to:
konfiguracja zadań zapisana w formacie XML,
wieloplatformowość – m. in. Linux, Unix (np. Solaris and HP-UX), Windows
9x i NT, OS/2 Warp, Novell Netware 6 oraz MacOS X.
rozszerzalność w oparciu o klasy napisane w Javie.
Ant jest rozwijany w ramach Apache Software Foundation. Strona domowa
Wymagania:
parser XML'a zgodny z JAXP,
JDK w wersji 1.2 lub nowszej. W przypadku posiadania samego JRE część
zadań nie będzie działać.
1
Instalacja
Ant jest rozpowszechniany jako archiwum zip. Należy je rozpakować
w wybranym katalogu. Następnie należy:
dodać podkatalog bin do ścieżki poszukiwań,
ustawić zmienną środowiska ANT_HOME ,
ew. ustawić zmienną JAVA_HOME ,
np. (Windows).
set ANT_HOME=c:\ant
set JAVA_HOME=c:\jdk1.2.2
set PATH=%PATH%;%ANT_HOME%\bin
Zwykle należy też zwiększyć pamięć dla konsoli poleceniem:
shell=c:\command.com c:\ /p /e:32768
2
Wykorzystanie – tag project
Informacje na temat zadań są zapisane w pliku XML. Taki plik zawiera jeden
projekt ( project ) i co najmniej jeden cel ( target ). Cel składa się z zadań
( task ).
Projekt posiada trzy opcjonalne atrybuty:
name – nazwa projektu,
default – nazwa domyślnego celu wykonywanego przy budowaniu projektu,
basedir – katalog od którego będą ,,liczone” nazwy ścieżek.
Opcjonalnie projekt może posiadać opis umieszczeny w elemencie
<description> .
Przykład:
<project name="MyProject" default="dist" basedir=".">
<description>
simple example build file
</description>
...
</project>
3
Wykorzystanie – tag target
Cel ( target ) może być zależny od innych celów. Pozwala to na określenie
kolejności wykonywania celów:
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="B,C,A"/>
Ant wykonuje cele ,,zależne” w kolejności od lewej do prawej.
W powyższym przykładzie, jeśli wywołać cel D , zadania zostaną wykonane w
kolejności A , B , C , D .
Należy zwrócić uwagę na możliwość wywołania celu jeszcze wcześniej, jeśli był
on zależny od innego wcześniej wykonanego celu.
4
Wykorzystanie – tag target
Cel może być wywoływany warunkowo, korzystając z następującej składni:
<target name="A" if="property"/>
Jeśli wartość property jest ustawiona cel A jest aktywny. Wartość własności
property jest bez znaczenia.
<target name="A" unless="property"/>
Jeśli wartość property jest nieustawiona cel A jest aktywny.
Cel ( target ) posiada następujące atrybuty:
name - nazwa
depends – zależności,
if – jeśli
unless – ,,jeśli nie”,
description – dodatkowy, krótki opis zadania.
5
Zgłoś jeśli naruszono regulamin