Apache ANT Tutorial: Hva er Ant Build Tool? Eksempel

Hva er et byggeverktøy?

Et byggeverktøy er et programmeringsverktøy som brukes til å bygge en ny versjon av et program. Den automatiserer opprettelsen av et kjørbart program fra hvilken som helst kildekode.

Uten et byggeverktøy ville en utvikler kompilere hver kildefil manuelt, kopiere ressurser, kjøre testpakken og pakke resultatet av hver endring. Et byggeverktøy registrerer disse trinnene én gang og gjentar dem identisk på hver maskin.

Hva er Apache Ant?

Apache Ant er en Java-basert kommandolinjeverktøy for bygging Java applikasjoner med full portabilitet av pure Java kode. Det lar utviklere ta i bruk smidige prinsipper og testdrevet utvikling for å automatisere repeterende utviklingsoppgaver som å generere dokumentasjon. Ant er et akronym for Another Neat Tool.

Som diagrammet viser, leser Ant en byggefil, bestemmer rekkefølgen på målene i den, og kjører deretter de individuelle oppgavene som kompilerer, kopierer, tester og pakker applikasjonen.

Hva brukes Apache Ant Build-verktøyet til?

Her er viktige fordeler med å bruke byggeverktøyet:

• Et byggeverktøy lar deg automatisere spesifikke, repeterende oppgaver som å kompilere kildekoden, kjøre programvaretester og opprette filer for programvaredistribusjon.
• Byggverktøy kjører stort sett uten et grafisk brukergrensesnitt.
• Det hjelper deg å konvertere kildekode til kjørbar kode.
• Den tilbyr et alternativ for å kompilere en fil på nytt bare hvis det er nødvendig.
• Det lar deg kompilere et stort antall filer på relativt kort tid.
• To svært populære byggeverktøy som brukes av Java utviklerne er Apache Maven og Ant.

Historien til Apache Ant

Nå skal vi lære om historien til byggeverktøyet Apache Ant.

Her er viktige historiske landemerker fra Apache Ant-verktøyet:

• James Duncan Davidson opprettet Ant i juli 2000.
• Den ble opprinnelig brukt til å bygge Tomcat og kom som et innebygd produkt i Tomcat-distribusjonssettet.
• I mai 2014 ble Apache Ant versjon 1.9.4 utgitt med mange avanserte funksjoner.
• 1.10.x-linjen startet i 2017 og er fortsatt den aktivt vedlikeholdte grenen.
• Versjon 1.10.17 ble utgitt 10. april 2026 og krever minimum Java 8 kjøretid.

Funksjoner av Apache Ant

Her er de viktigste funksjonene i Apache Ant:

• Det er et åpen kildekode-prosjekt.
• Det lar deg kjøre bygg på begge Windows og UNIX- eller Linux-systemer.
• Du trenger bare en JVM, ettersom den kjører overalt hvor en JVM er tilgjengelig.
• Den tilbyr et bredt utvalg av forhåndsdefinerte oppgaver.
• Det hjelper deg med å kopiere filer fra ett sted til et annet.
• Den tilbyr et grensesnitt for å utvikle tilpassede oppgaver.
• Den lar deg starte bygg fra kommandolinjen, som enkelt integreres med gratis og kommersielle IDE-er.
• Den lar deg distribuere binærfilene til en testserver.
• Den tilbyr en utvidbar arkitektur.
• Den tilbyr bakoverkompatibilitet på tvers av utgivelser.

Hvordan installere og konfigurere Apache Ant på Windows

Nå skal vi lære prosessen med å installere Apache Ant på Windows.

Vi antar at du allerede har lastet ned og installert Java Utviklingssett (JDK) på datamaskinen din. Sørg for at miljøvariabelen JAVA_HOME er satt til mappen der JDK-en din er installert. Følg trinnene nedenfor for å installere Ant:

Trinn 1) Last ned binærfiler.
Last ned binærfiler fra https://ant.apache.org/bindownload.cgi

Trinn 2) Pakk ut filer.
Pakk ut denne zip-filen til et passende sted, for eksempel c:\mappen, ved å bruke WinZip, WinRAR, 7-Zip, eller et lignende verktøy.

Trinn 3) Lag en miljøvariabel.
Opprett en miljøvariabel for «ANT_HOME» og tilordne verdien av variabelen til plasseringen av Ant-mappen.

1. Høyreklikk på Denne PC-en-ikonet.
2. Klikk på Egenskaper.

Trinn 4) Gå til systeminnstillinger.
Klikk på "Avanserte systeminnstillinger".

Trinn 5) På systemegenskaper,
klikk på fanen «Avansert».

Trinn 6) Finn miljøvariablene.
Klikk på knappen «Miljøvariabler…».

Trinn 7) Opprett en ny variabel.
Klikk på "Ny" for å opprette en ny brukervariabel.

Trinn 8) Skriv inn variabeldetaljene.
Skriv inn detaljene for den nye brukervariabelen.

1. Skriv inn variabelnavnet som ANT_HOME.
2. Skriv inn variabelverdien som mappen der Ant ble pakket ut, for eksempel C:\apache-ant-1.10.17.
3. Klikk på “OK” -knappen.

Trinn 9) Variabel opprettet.
Klikk på “OK” -knappen.

Trinn 10) Lukk skjermen.
Klikk på "OK" for å lukke skjermen.

Du kan bekrefte en vellykket Ant-installasjon ved å typing kommandoen «ant -version» i ledeteksten.

Du vil se følgende skjerm:

Eksempel på Apache ANT

Byggefilen nedenfor definerer et enkelt mål kalt hello som skriver ut en melding. Prosjektelementet deklarerer et navn og et standardmål, slik at Ant vet hva som skal kjøres når det ikke er noe mål navngitt på kommandolinjen.

<?xml version="1.0"?>
<project name="HelloWorld" default="hello" basedir=".">

    <target name="hello">
        <echo>Hello, World</echo>
    </target>

</project>

Lagre denne filen som «build.xml», og følg deretter disse to trinnene:

• Åpne ledeteksten og gå til mappen som inneholder build.xml.
• Kjør ant hello, eller bare ant, fordi hello er deklarert som standardmål. For å bruke et annet filnavn, kjør ant -f mybuild.xml hello.

Utgang:

Buildfile: C:\projects\demo\build.xml

hello:
     [echo] Hello, World

BUILD SUCCESSFUL
Total time: 0 seconds

ANT-prosjektets struktur

ANT-prosjektets struktur

Som strukturdiagrammet viser, vil hver build inneholde tre noder:

• Prosjekt
• Target
• Oppgave

Prosjekt

Alt inne i byggefilen i Apache ANT er under et prosjekt.

Attributter:

• Navn: Navnet på prosjektet.
• Basert adresse: Dette er katalogen som alle stiene skal beregnes fra. Dette kan overstyres ved å bruke egenskapen «basedir».
• Misligholde: Hjelper deg med å definere standardmålet for dette prosjektet. Hvis det ikke er gitt noe mål, vil Ant utføre standardmålet.

Target

Et mål er et sett med oppgaver som er definert for å nå en bestemt tilstand i byggeprosessen.

Attributter:

• Navn: Navn på målet (obligatorisk).
• Description: Description av målet.
• Avhenger av: Hvilket mål dette nåværende målet avhenger av.
• If: Utfører bare målet hvis en verdi er angitt for en målegenskap.
• Med mindre: Utfører bare målet hvis egenskapsverdien ikke er angitt.

Oppgaver

En oppgave er et stykke kode som kan kjøres. Oppgaver har flere argumenter eller attributter.

Det generelle metodemønsteret for å skrive en oppgave er:

<name attribute1="value" attribute2="value2"…/>

Du kan enten bruke en innebygd oppgave, eller du kan lage din egen oppgave. Tabellen nedenfor viser oppgavene som vises i nesten alle Java byggefilen.

Komplett build.xml-eksempel med flere Targets

En realistisk byggefil kjeder flere mål sammen. depends-attributtet garanterer rekkefølgen, så Ant renser utdatamappen, kompilerer kildekoden og bygger først deretter jar-filen.

<?xml version="1.0"?>
<project name="DemoApp" default="jar" basedir=".">

    <!-- reusable values -->
    <property name="src.dir"   value="src"/>
    <property name="build.dir" value="build"/>

    <target name="clean" description="Remove previous output">
        <delete dir="${build.dir}"/>
    </target>

    <target name="compile" depends="clean" description="Compile sources">
        <mkdir dir="${build.dir}/classes"/>
        <javac srcdir="${src.dir}" destdir="${build.dir}/classes"
               includeantruntime="false"/>
    </target>

    <target name="jar" depends="compile" description="Package the jar">
        <mkdir dir="${build.dir}/jar"/>
        <jar destfile="${build.dir}/jar/DemoApp.jar"
             basedir="${build.dir}/classes">
            <manifest>
                <attribute name="Main-Class" value="com.guru99.Main"/>
            </manifest>
        </jar>
    </target>

</project>

Utgang:

Buildfile: C:\projects\DemoApp\build.xml

clean:
   [delete] Deleting directory C:\projects\DemoApp\build

compile:
    [mkdir] Created dir: C:\projects\DemoApp\build\classes
    [javac] Compiling 3 source files to C:\projects\DemoApp\build\classes

jar:
    [mkdir] Created dir: C:\projects\DemoApp\build\jar
      [jar] Building jar: C:\projects\DemoApp\build\jar\DemoApp.jar

BUILD SUCCESSFUL
Total time: 1 second

Apache Ant vs Maven vs Gradle

Tre byggeverktøy dominerer Java økosystem, og hver enkelt tar forskjellig standpunkt til hvor mye struktur de skal pålegge.

Ant er fortsatt det pragmatiske valget når en konstruksjon ikke passer til et standardoppsett, eller når et eksisterende prosjekt allerede er avhengig av håndskrevne mål.

Beste fremgangsmåter for bruk av Apache Ant

Her er noen gode fremgangsmåter for bruk av Apache Ant.

• Du bør automatisere byggnummerering ved å bruke egenskapsfiler.
• Implementer en konfigurerbar bygging ved hjelp av standard- og byggeegenskapsfiler. Disse filene lar deg lagre egenskaper som definerer dataene for byggeprosessen, for eksempel kompilatorversjon og optimaliseringsinnstillinger.
• Du kan gjenbruke forhåndsbygde biblioteker ved å bruke bibliotekets eiendomsfiler.
• Gi hvert mål et beskrivelsesattributt, slik at ant -projecthelp viser et brukbart sammendrag av bygget.
• Hold det rene målet separat, og slett aldri en katalog som også inneholder kildefiler.

Fordeler med å bruke Apache Ant

Her er fordelene med å bruke Apache Ant:

• Ant er plattformnøytral, så det hjelper deg med å administrere plattformsentriske egenskaper som filseparatorer.
• Ant lar deg utføre plattformspesifikke oppgaver, for eksempel å endre den endrede tiden til en fil ved hjelp av kommandoen «touch».
• Ant-skript skrives med vanlig XML, så hvis du allerede er kjent med XML, vil du raskt kunne lære Ant.
• Ant tilbyr en stor liste med forhåndsdefinerte oppgaver.
• Den tilbyr et grensesnitt for utviklingping tilpassede oppgaver.
• Du kan enkelt starte Ant fra kommandolinjen, noe som tillater integrering med gratis og kommersielle IDE-er.
• Du trenger bare en JVM, så den kjører overalt hvor en JVM er tilgjengelig.
• Apache Ant er et åpen kildekode-bibliotek som lar brukere få tilgang til kildekoden og reprodusere den.
• Apache Ant er et verktøy på tvers av plattformer som lar deg håndtere Java klassesti og filkatalogstruktur på en rimelig måte.
• Apache Ant er lett å utvide med Java og andre programmeringsspråk.
• Apache Ant tilbyr innebygd støtte for J2EE-utvikling, for eksempel EJB-kompilering og -pakking.
• Du kan bruke den til et lite personlig prosjekt så vel som til et stort programvareprosjekt eller nettsted.

Ant kobles ofte sammen med en testkjører og en kontinuerlig integrasjonsserver. Se JUnit for testlaget, Jenkins for planlagte bygg, og bruker Apache Ant med Selenium for automatisering av nettlesertester. Rapporter som produseres under en bygging kan gjengis med Jasper rapporterer.

Spørsmål og svar