Au-delà de Linux® From Scratch - Version svn-20120120

Chapitre 11. Outils systèmes

Apache Ant-1.8.1

Introduction à Apache Ant

Le paquet Apache Ant est un outil de compilation basé sur Java. En théorie, ça ressemble beaucoup à make, mais sans les inconvénients de make. Ant est différent. Au lieu d'un modèle où il serait étendu avec des commandes basées sur le shell, Ant s'étend en utilisant des classes Java. Plutôt que d'écrire des commandes shell, les fichiers de configuration sont basés sur XML, utilisant une arborescence cible où diverses tâches s'exécutent. Chaque tâche est exécutée par un objet qui implémente une interface de tâche spécifique.

Ce paquet est connu pour se construire et fonctionner correctement sur une plateforme LFS-SVN-20101029 .

Informations sur le paquet

Dépendances d'Apache Ant

Requises

IcedTea6-1.9.7 ou JDK-6 Update 18

Recommandées

JUnit-4.8.1

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/apache-ant

Installation de Apache Ant

[Note]

Note

Il se peut que vous ayez besoin de bibliothèques supplémentaires pour satisfaire les exigences de construction de divers paquets installés en utilisant Apache Ant. Voyez le tableau sur http://ant.apache.org/manual/install.html#librarydependencies pour les bibliothèques prérequises dont vous pourriez avoir besoin.

S'il n'est pas possible d'installer JUnit, installez Apache Ant en supprimant la référence aux instructions de test (remarquez que les tests ne seront pas effectués) : 

sed -i 's;jars,test-jar;jars;' build.xml

Installez Apache Ant en lançant les commandes suivantes : 

sed -i 's|${dist.dir}/etc|/etc/ant|'        build.xml &&
sed -i 's|/etc/ant.conf|/etc/ant/ant.conf|' src/script/ant &&
cp -v /usr/share/junit-4.8.1/junit-4.8.1.jar \
      lib/optional/junit.jar

Les tests de régression de l'unité sont effectués au moment de la construction ci-dessous, sauf si vous n'avez pas installé JUnit. Maintenant, en tant qu'utilisateur root : 

./build.sh -Ddist.dir=/opt/ant-1.8.1 dist &&
ln -v -sf /etc/ant /opt/ant-1.8.1/etc &&
ln -v -sf ant-1.8.1 /opt/ant

Explication des commandes

sed -i 's;jars... : Si le paquet JUnit n'est pas installé, vous ne pouvez pas effectuer les tests de régression.

sed ... : Ces commandes modifient le répertoire de configuration en /etc/ant pour respecter les instructions de la FHS.

cp -v /usr/share/junit-4.8.1/4.8.1.jar ... : Cette commande copie le fichier jar JUnit dans le répertoire où Apache Ant le cherchera.

./build.sh -Ddist.dir=/opt/ant-1.8.1 dist : Cette commande fait tout. Elle construit, teste, puis installe le paquet dans /opt/ant-1.8.1.

ln -v -sf /etc/ant /opt/ant-1.8.1/etc : Les commandes sed modifient le répertoire de configuration en /etc/ant et cette commande crée un lien symbolique entre l'ancien répertoire de configuration et le répertoire d'installation, car un paquet s'attend à y trouver des fichiers.

ln -v -sf ant-1.8.1 /opt/ant : Cette commande est facultative et crée un lien symbolique pratique.

Configuration de Apache Ant

Fichiers de configuration

/etc/ant/ant.conf, ~/.ant/ant.conf et ~/.antrc

Informations de configuration

Certains paquets exigeront que ant soit dans le chemin de recherche et que la variable $ANT_HOME soit définie. Satisfaites ces exigences en ajoutant les lignes suivantes aux fichiers /etc/profile ou ~/.profile personnel de l'utilisateur ou ~/.bashrc : 

export PATH=$PATH:/opt/ant/bin
export ANT_HOME=/opt/ant

Contenu

Programmes installés: ant, antRun, antRun.pl, complete-ant-cmd.pl, runant.pl, et runant.py
Bibliothèques installées: ant.jar, ant-*.jar, xercesImpl.jar, et xml-apis.jar
Répertoires installés: /etc/ant et /opt/ant-1.8.1

Descriptions courtes

ant

est un outil de construction basé sur Java utilisé par de nombreux paquets à la place du programme make conventionnel.

antRun

est un script de support utilisé pour démarrer les scripts de construction de ant dans un répertoire donné.

antRun.pl

est un script Perl qui fournit les mêmes fonctionnalités qu'offre le script antRun.

complete-ant-cmd.pl

est un script Perl qui permet à Bash de compléter une ligne de commande ant.

runant.pl

est un script enveloppe Perl utilisé pour appeler ant.

runant.py

est un script enveloppe Python utilisé pour appeler ant.

ant-*.jar

fichiers qui sont les bibliothèques Apache Ant de la classe Java.

xercesImpl.jar

est une bibliothèque de classe Java utilisée par Apache Ant pour parser du XML.

xml-apis.jar

contient les classes DOM de Java exigées par le formateur XML Apache Ant.

Last updated on 2011-01-05 18:33:32 +0100