Commencer avec la fourmi

Bootstrap Apache Ivy #

Bonjour le monde #

Ajoutez ce qui suit à un fichier nommé build.xml dans votre répertoire de projet :

<?xml version="1.0" encoding="UTF-8"?>
<project name="HelloWorld" default="main">
    <target name="main" description="this is target main">
        <echo message="Hello World" />
    </target>
</project>

À partir d’une invite de commande sur un ordinateur exécutant Windows, l’exécution de « ant main » affichera ce qui suit :

$ ant main
Buildfile: C:\Users\<me>\Projects\HelloWorld\build.xml

main:
     [echo] Hello World

BUILD SUCCESSFUL

De plus, l’utilisateur peut maintenant exécuter la commande ant en tant que nom de cible default ajouté au projet. Lorsque la commande ant est exécutée, elle recherche la cible default du projet et l’exécute.

$ ant 
Buildfile: C:\Users\<me>\Projects\HelloWorld\build.xml

main:
     [echo] Hello World

BUILD SUCCESSFUL

Si le script de construction est écrit par quelqu’un d’autre et que l’utilisateur final souhaite voir quelle cible il peut exécuter, exécutez la commande qui affichera toutes les cibles qui ont des descriptions.

$ ant -p

Imprimer les informations sur l’environnement avant la construction #

Exécuter JUnit #

Créer un paquet jar #

Ce qui suit créera dist/output.jar à partir du code source dans src et des bibliothèques dans lib, et utilisera src/Main.java comme classe principale.

<project name="Project" default="main" basedir=".">

    <property name="src.dir"     value="src"/>
    <property name="build.dir"   value="build"/>
    <property name="dist.dir"    value="dist"/>

    <path id="classpath">
        <fileset dir="lib" includes="**/*.jar"/>
        <pathelement path="${build.dir}"/>
    </path>

    <target name="clean">
      <delete dir="${build.dir}"/>
      <delete dir="${dist.dir}"/>
    </target>
    

    <target name="compile">
        <mkdir dir="${build.dir}"/>
        <javac srcdir="${src.dir}" destdir="${build.dir}" classpathref="classpath"/>
        <copy todir="${build.dir}">
            <fileset dir="${src.dir}" excludes="**/*.java"/>
        </copy>
    </target>

    <target name="jar" depends="compile">
        <mkdir dir="${dist.dir}"/>
        <jar destfile="${dist.dir}/${ant.project.name}.jar" basedir="${build.dir}">
            <fileset dir="${build.dir}"/>
            <restrict>
                <archives>
                    <zips>
                        <fileset dir="lib" includes="**/*.jar"/>
                    </zips>
                </archives>
            </restrict>
            <manifest>
                <attribute name="Main-Class" value="Main"/>
            </manifest>
        </jar>
    </target>

    <target name="main" depends="clean,jar"/>
</project>

Installation ou configuration #

L’installation d’Ant est très simple. Suivez les étapes ci-dessous pour installer Ant sur la plate-forme Windows :

1. Téléchargez la dernière version de fourmi à partir du [site Web d’Apache][1]

2. Décompressez le fichier sur votre machine.

3. Définissez ANT_HOME dans les variables d’environnement

4. Ajoutez %ANT_HOME%\bin à votre variable d’environnement PATH.

5. Définissez CLASSPATH=%ANT_HOME%\lib;%CLASSPATH%

6. Ouvrez maintenant l’invite de commande et entrez la commande “ant”. Vous devriez voir ci-dessous :

   Buildfile: build.xml does not exist!
    Build failed

Alternativement, en utilisant Homebrew sur macOS ou Linuxbrew sur Linux, vous pouvez simplement exécuter : brew install ant

Lorsque vous utilisez brew, il n’est pas nécessaire de configurer les variables d’environnement.

Plusieurs distributions Linux prennent également en charge l’installation d’Ant à partir de leurs gestionnaires de packages respectifs.

Pour tester Ant est installé correctement, accédez à l’invite de commande et exécutez

ant -version

Cette commande imprimera la version Ant et montrera également qu’Ant a été installé avec succès.

La propre page d’instructions d’installation d’Ant est disponible sur le [site Web d’Apache Ant][2].

[1] : http://ant.apache.org/bindownload.cgi [2] : https://ant.apache.org/manual/install.html