Apache Ant

Formiga

Em formação

Desenvolvido por	Apache Software Foundation
Primeira versão	Julho de 2000 e 17 de fevereiro de 2006
Última versão	1,10.9 (30 de setembro de 2020)
Depósito	git-wip-us.apache.org/repos/asf/ant.git e gitbox.apache.org/repos/asf/ant.git
Escrito em	Java
Sistema operacional	Multi plataforma
Meio Ambiente	Windows , Linux
Modelo	Motor de produção
Licença	Licença Apache
Local na rede Internet	ant.apache.org

Ant é um software criado pela fundação Apache que visa automatizar operações repetitivas de desenvolvimento de software , como compilação , geração de documentos ( Javadoc ) ou arquivamento no formato JAR , como o software Make .

Ant é escrito em Java e seu nome é um acrônimo para " Another Neat Tool " . É utilizado principalmente para automatizar a construção de projetos na linguagem Java , mas pode ser utilizado para qualquer outro tipo de automação em qualquer linguagem .

Entre as tarefas mais comuns, Ant permite a compilação , geração de páginas de documentação HTML ( Javadoc ), geração de relatórios, execução de ferramentas relacionadas ( checkstyle , FindBugs , etc.), arquivamento em forma distribuível ( JAR , etc.)

História

Ant foi desenhado por James Duncan Davidson (in) quando transferido para o código aberto produto da Sun . Este produto e o mecanismo JSP / Servlet da Sun Apache Tomcat chegaram mais tarde. A ferramenta proprietária make foi usada para compilá-lo no sistema operacional Solaris da Sun, mas no mundo do código aberto não é possível controlar qual plataforma é usada para compilar o Tomcat. O Ant foi criado para ser simplesmente uma ferramenta independente do sistema operacional para compilar o Tomcat a partir de diretivas contidas em um " arquivo de construção " XML . Ant (versão 1.1) está oficialmente disponível como um produto completo desde19 de julho de 2000.

Ele começa a se tornar o projeto de suporte a Java de software livre; os desenvolvedores planejam um arquivo build.xml para todos os projetos. Além disso, a ferramenta tornou mais fácil integrar o teste JUnit ao processo de compilação, tornando os desenvolvedores mais dispostos a adotar o Desenvolvimento Orientado a Testes e a Programação Extrema .

um exemplo de build.xml

Aqui está um exemplo 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">  <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>  <pathelement path="${classpath}" />  <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>  <javac srcdir="${src.dir}" destdir="${build.dir}"> <classpath>  <pathelement path="${classpath}" />  <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>  <javac srcdir="tests" destdir="tests"> <classpath path="c:/eclipse3.1-WTP/plugins/org.junit_3.8.1/">  <pathelement path="${classpath}" />  <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>

Portabilidade

Um dos principais objetivos do Ant era resolver o problema da portabilidade total de desenvolvimento em Java . Em um Makefile , as ações necessárias para realizar uma tarefa são especificadas como comandos de shell , que são específicos para uma determinada plataforma (a de execução).

Assim, quando se deseja implantar sua aplicação em várias plataformas, é necessário torná-la mais complexa ou produzir vários Makefiles para atender a cada um desses ambientes. O Ant resolveu esse problema fornecendo um conjunto de recursos por padrão, que se comportará da mesma forma em todos os sistemas.

Por exemplo, em um Makefile podemos cumprir a seguinte regra, em um ambiente UNIX :

clean: rm -rf classes/

Enquanto no Windows, por exemplo, a mesma regra é escrita:

clean: rmdir /S /Q classes

Em um arquivo Ant, apenas uma diretiva é comum para todos os sistemas suportados pelo software: <delete dir="classes"/>

Uma das principais diferenças entre as plataformas também são os delimitadores de itens em um sistema de arquivos : os ambientes UNIX usam a barra (/), enquanto o MS Windows usa a barra invertida (\). O Ant permite que os desenvolvedores escolham qualquer convenção que desejem e fará uma conversão perfeita no tempo de execução, dependendo da plataforma.

Alternativas

Apache Maven : compilação de fonte Java, gerenciamento de dependências, implantação de artefatos gerados.
SCons : Compilação de fontes Java, C, C ++ usando scripts Python.
Make : Compilação e construção de arquivos automatizados.
CMake : Compilação, construção de arquivos automatizados e criação de arquivos para IDEs .

Notas e referências

" https://projects.apache.org/json/projects/ant.json " (acessado em 8 de abril de 2020 )
(en) " Lançado Apache Ant 1.10.9 " ,30 de setembro de 2020(acessado em 28 de janeiro de 2021 )
" CMake para compilar código java " , em Stack Overflow (acessado em 2 de junho de 2020 ) .

Apêndices

links externos

(fr) O projeto Ant .