Ant Apache

Furnică Descrierea imaginii Xml.gif. informație
Dezvoltat de Apache Software Foundation
Prima versiune Iulie 2000 și 17 februarie 2006
Ultima versiune 1.10.9 (30 septembrie 2020)
Depozit git-wip-us.apache.org/repos/asf/ant.git și gitbox.apache.org/repos/asf/ant.git
Scris in Java
Sistem de operare Multiplatform
Mediu inconjurator Windows , Linux
Tip Motor de producție
Licență Licență Apache
Site-ul web ant.apache.org

Ant este un software creat de fundația Apache care își propune să automatizeze operațiuni repetitive de dezvoltare software cum ar fi compilarea , generarea de documente ( Javadoc ) sau arhivarea în format JAR , cum ar fi software - ul Make .

Furnica este scrisă în Java și numele său este un acronim pentru „  Un alt instrument îngrijit  ” . Este utilizat în principal pentru automatizarea construcției de proiecte în limbaj Java , dar poate fi utilizat pentru orice alt tip de automatizare în orice limbă .

Printre cele mai frecvente sarcini, Ant permite compilarea , generarea de pagini de documentare HTML ( Javadoc ), generarea de rapoarte, executarea instrumentelor auxiliare ( checkstyle , FindBugs etc.), arhivarea în formă distribuibilă ( JAR etc.)

Istorie

Ant a fost proiectat de James Duncan Davidson  (în) atunci când sunt transferate la open source produs de la Soare . Acest produs și motorul JSP / Servlet de la Sun Apache Tomcat au sosit mai târziu. Instrumentul patentat marca a fost folosit pentru a-l compila pe sistemul de operare Solaris Sun, dar în lumea open source nu este posibil să se controleze ce platformă este utilizată pentru a compila Tomcat. Ant a fost creat pentru a fi pur și simplu un instrument independent de sistem de operare pentru a compila Tomcat din directivele conținute într-un „ fișier build ” XML . Ant (versiunea 1.1) a fost disponibil oficial ca produs complet de atunci19 iulie 2000.

Începe să devină proiectul de suport Java open source; dezvoltatorii planifică un fișier build.xml pentru toate proiectele. În plus, instrumentul a facilitat integrarea testelor JUnit în procesul de compilare, făcând dezvoltatorii mai dispuși să adopte Test Driven Development și Extreme Programming .

un exemplu de build.xml

Iată un exemplu de build.xml:

<?xml version="1.0" encoding="UTF-8"?> <project name="projetWar" basedir="." default="checkstyle"> <property name="base.dir" value="../" /> <property name="baseTool.dir" value="../../outils/" /> <property name="src.dir" value="${base.dir}src" /> <property name="build.dir" value="${base.dir}webapp/WEB-INF/classes" /> <property name="doc" location="${base.dir}doc" /> <property name="lib" location="${base.dir}lib" /> <property name="reports" value="${baseTool.dir}/rapports" /> <property name="classpath" value="${build.dir}" /> <taskdef resource="checkstyletask.properties" classpath="${baseTool.dir}checkstyle-4.0-beta6/checkstyle-all-4.0-beta6.jar" /> <target name="reports" depends="checkstyle, classcycle, findbugs, jdepend"> <echo>Génération des rapports terminé.</echo> </target> <target name="jdepend"> <delete dir="${reports}/jdepend/" /> <mkdir dir="${reports}/jdepend/" /> <java classname="jdepend.xmlui.JDepend" fork="yes"> <classpath> <fileset dir="${baseTool.dir}/jdepend/" includes="**/*.jar" /> </classpath> <arg value="-file" /> <arg value="${reports}/jdepend/jdepend-report.xml" /> <arg value="${build.dir}" /> </java> <style basedir="${reports}/jdepend/" destdir="${reports}/jdepend/" includes="jdepend-report.xml" style="${baseTool.dir}/jdepend/jdepend.xsl" /> </target> <taskdef classpath="${baseTool.dir}findbugs-0.9.1/lib/findbugs-ant.jar" name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask" /> <property name="findbugs.home" value="${baseTool.dir}findbugs-0.9.1/" /> <target name="findbugs"> <delete dir="${reports}/findbugs/" /> <mkdir dir="${reports}/findbugs/" /> <findbugs home="${findbugs.home}" output="html" outputFile="${reports}/findbugs/bcel-fb.html"> <classpath> </classpath> <sourcePath path="${src.dir}" /> <class location="${build.dir}" /> </findbugs> </target> <taskdef classpath="${baseTool.dir}/Classycle/classycle.jar" name="classycleReport" classname="classycle.ant.ReportTask" /> <target name="classcycle"> <delete dir="${reports}/classycle/" /> <mkdir dir="${reports}/classycle/" /> <classycleReport reportFile="${reports}/classycle/classycle.xml"> <fileset dir="${build.dir}"> <include name="**/*.class" /> </fileset> </classycleReport> <style in="${reports}/classycle/classycle.xml" out="${reports}/classycle/classycle.html" style="${baseTool.dir}/Classycle/reportXMLtoHTML.xsl" /> <copydir dest="${reports}/classycle/images" src="${baseTool.dir}/Classycle/images"> </copydir> </target> <target name="init"> <!-- création d'un répertoire pour la compilation --> <mkdir dir="${build.dir}" /> </target> <target name="checkstyle" description="Generates a report of code convention violations."> <delete dir="${reports}/checkstyle/" /> <mkdir dir="${reports}/checkstyle/" /> <checkstyle config="${baseTool.dir}/checkstyle-4.0-beta6/sun_checks.xml" failureProperty="checkstyle.failure" failOnViolation="false"> <classpath> <!-- use the value of the ${classpath} property in the classpath --> <pathelement path="${classpath}" /> <!-- include all jar files --> <fileset dir="${lib}"> <include name="**/*.jar" /> </fileset> <fileset dir="\var\www\jakarta-tomcat-4.0.6-LE-jdk14\common\lib"> <include name="**/*.jar" /> </fileset> </classpath> <formatter type="xml" tofile="${reports}/checkstyle/checkstyle_report.xml" /> <fileset dir="${src.dir}"> <include name="**/*.java" /> </fileset> </checkstyle> <style in="${reports}/checkstyle/checkstyle_report.xml" out="${reports}/checkstyle/index.html" style="${baseTool.dir}/checkstyle-4.0-beta6/contrib/checkstyle-noframes-sorted.xsl" /> </target> <target name="compil" depends="cleanTomcat"> <echo>Compilation des sources java</echo> <!-- compilation des sources Java --> <javac srcdir="${src.dir}" destdir="${build.dir}"> <classpath> <!-- use the value of the ${classpath} property in the classpath --> <pathelement path="${classpath}" /> <!-- include all jar files --> <fileset dir="${lib}"> <include name="**/*.jar" /> </fileset> <fileset dir="\var\www\jakarta-tomcat-4.0.6-LE-jdk14\common\lib"> <include name="**/*.jar" /> </fileset> </classpath> </javac> </target> <target name="compilJUnit"> <echo>Compilation des sources Junit</echo> <!-- compilation des sources Java --> <javac srcdir="tests" destdir="tests"> <classpath path="c:/eclipse3.1-WTP/plugins/org.junit_3.8.1/"> <!-- use the value of the ${classpath} property in the classpath --> <pathelement path="${classpath}" /> <!-- include all jar files --> <fileset dir="${lib}"> <include name="**/*.jar" /> </fileset> <fileset dir="\var\www\jakarta-tomcat-4.0.6-LE-jdk14\common\lib"> <include name="**/*.jar" /> </fileset> </classpath> </javac> </target> <target name="doc" depends="compil" description="Generation de la documentation"> <delete dir="${doc}/" /> <mkdir dir="${doc}/" /> <javadoc destdir="${doc}/" author="true" version="true" use="true" package="true"> <fileset dir="${src.dir}"> <include name="**/*.java" /> <exclude name="**/*Test*" /> </fileset> <classpath> <pathelement path="${java.class.path}" /> </classpath> </javadoc> </target> <target name="clean"> <delete dir="${build.dir}" /> </target> <target name="all" depends="init,compil, doc" description="Generation complete"> <echo message="Generation complete." /> </target> <taskdef name="pmd" classname="net.sourceforge.pmd.ant.PMDTask" classpath="${baseTool.dir}/pmd-bin-3.3/pmd-3.3/lib/pmd-3.3.jar" /> <target name="pmd"> <delete dir="${reports}/pmd/" /> <mkdir dir="${reports}/pmd/" /> <taskdef name="pmd" classname="net.sourceforge.pmd.ant.PMDTask" classpath="${baseTool.dir}/pmd-bin-3.3/pmd-3.3/lib/pmd-3.3.jar" /> <pmd rulesetfiles="rulesets/optimizations.xml"> <formatter type="xml" toFile="${reports}/pmd/report_pmd.xml"/> <fileset dir="${src.dir}"> <include name="**/*.java" /> </fileset> </pmd> <xslt in="${reports}/pmd/report_pmd.xml" style="${baseTool.dir}/pmd-bin-3.3/pmd-3.3/etc/xslt/pmd-report-per-class.xslt" out="${reports}/pmd/report_pmd.html" /> </target> </project>  

Portabilitate

Unul dintre principalele obiective ale Ant a fost rezolvarea problemei portabilității depline a dezvoltării în Java . Într-un Makefile , acțiunile necesare pentru a efectua o sarcină sunt specificate ca comenzi shell , care sunt specifice unei anumite platforme (cea de execuție).

Astfel, atunci când doriți să implementați aplicația pe mai multe platforme, este necesar să o faceți mai complexă sau să produceți mai multe Makefiles pentru a satisface fiecare dintre aceste medii. Ant a rezolvat această problemă oferind în mod implicit un set de caracteristici, care se vor comporta la fel pe toate sistemele.

De exemplu, într-un Makefile putem îndeplini următoarea regulă, într-un mediu UNIX  :

clean: rm -rf classes/

În Windows, de exemplu, se scrie aceeași regulă:

clean: rmdir /S /Q classes

Într-un fișier Ant, o singură directivă este comună pentru toate sistemele acceptate de software: <delete dir="classes"/>

Una dintre principalele diferențe între platforme este, de asemenea, delimitatorii de elemente dintr-un sistem de fișiere  : mediile UNIX folosesc slash-ul direct (/), în timp ce MS Windows folosește backslash-ul (\). Ant le permite dezvoltatorilor să aleagă orice convenție doresc și se vor converti fără probleme în timpul rulării, în funcție de platformă.

Alternative

  • Apache Maven  : compilare sursă Java, gestionarea dependenței, implementarea artefactelor generate.
  • SCons  : Compilarea surselor Java, C, C ++ folosind scripturi Python.
  • Marcă  : Compilarea și construirea fișierelor automate.
  • CMake  : Compilarea, construirea de fișiere automate și crearea de fișiere pentru IDE-uri .

Note și referințe

  1. „  https://projects.apache.org/json/projects/ant.json  ” (accesat la 8 aprilie 2020 )
  2. (ro) „  Apache Ant 1.10.9 lansat  ” ,30 septembrie 2020(accesat la 28 ianuarie 2021 )
  3. „  CMake to compile java code  ” , pe Stack Overflow (accesat la 2 iunie 2020 ) .

Anexe

Articol asociat

linkuri externe