Урок за Apache ANT: Какво представлява Ant Build Tool? Пример
⚡ Умно обобщение
Apache ANT е Java базиран инструмент за изграждане, който автоматизира компилирането, тестването, пакетирането и внедряването чрез XML файл за изграждане. Тази статия дефинира инструмента, tracнеговата история, обхваща Windows инсталация, обяснява структурата на проекта и го сравнява с Maven и Gradle.

Какво е инструмент за изграждане?
Инструментът за изграждане е инструмент за програмиране, който се използва за изграждане на нова версия на програма. Той автоматизира създаването на изпълнимо приложение от произволен изходен код.
Без инструмент за изграждане, разработчикът би компилирал ръчно всеки изходен файл, би копирал ресурси, би изпълнявал тестовия пакет и би пакетирал резултата при всяка промяна. Инструментът за изграждане записва тези стъпки веднъж и ги повтаря по един и същ начин на всяка машина.
Какво е Apache Ant?
Apache Ant е Javaбазиран на командния ред инструмент за изграждане Java приложения с пълна преносимост на pure Java код. Той позволява на разработчиците да възприемат гъвкави принципи и разработка, управлявана от тестове, за да автоматизират повтарящи се задачи за разработка, като например генериране на документация. Ant е акроним за Another Neat Tool (Друг чист инструмент).
Както е показано на диаграмата, Ant чете файл за компилация, определя реда на целите в него и след това изпълнява отделните задачи, които компилират, копират, тестват и пакетират приложението.
За какво се използва инструментът Apache Ant Build?
Ето важните предимства на използването на инструмента за изграждане:
- Инструментът за изграждане ви позволява да автоматизирате специфични повтарящи се задачи, като например компилиране на изходния код, провеждане на софтуерни тестове и създаване на файлове за внедряване на софтуер.
- Инструментите за изграждане обикновено работят без графичен потребителски интерфейс.
- Помага ви да конвертирате изходния код в изпълним код.
- Той предлага опция за прекомпилиране на файл само ако е необходимо.
- Това ви позволява да компилирате голям брой файлове за сравнително кратко време.
- Два широко популярни инструмента за изграждане, използвани от Java разработчиците са Apache Maven и Ant.
История на Apache Ant
Сега ще научим за историята на инструмента за изграждане Apache Ant.
Ето важни исторически забележителности от инструмента Apache Ant:
- Джеймс Дънкан Дейвидсън създава Ant през юли 2000 г.
- Първоначално е използван за изграждане на Tomcat и е бил вграден продукт на дистрибуторския комплект Tomcat.
- През май 2014 г. беше пусната Apache Ant версия 1.9.4 с много разширени функции.
- Линията 1.10.x започна през 2017 г. и остава активно поддържаният клон.
- Версия 1.10.17 беше издадена на 10 април 2026 г. и изисква минимум Java 8 времетраене.
Характеристики на Apache Ant
Ето основните характеристики на Apache Ant:
- Това е проект с отворен код.
- Позволява ви да изпълнявате компилации и на двете Windows и UNIX или Linux системи.
- Изисква се само JVM, тъй като работи навсякъде, където е налична JVM.
- Той предлага широк набор от предварително дефинирани задачи.
- Това ви помага да копирате файлове от едно място на друго.
- Той предлага интерфейс за разработване на персонализирани задачи.
- Позволява ви да извиквате компилации от командния ред, което лесно се интегрира с безплатни и комерсиални IDE.
- Това ви позволява да разположите двоичните файлове на тестов сървър.
- Той предлага разширяема архитектура.
- Той предлага обратна съвместимост между различните издания.
Как да инсталирате и конфигурирате Apache Ant на Windows
Сега ще научим процеса на инсталиране на Apache Ant на Windows.
Предполагаме, че вече сте изтеглили и инсталирали Java Комплект за разработка (JDK) на вашия компютър. Уверете се, че променливата на средата JAVA_HOME е зададена на папката, където е инсталиран вашият JDK. Следвайте стъпките по-долу за инсталиране на Ant:
Стъпка 1) Изтеглете двоичните файлове.
Изтеглете двоичните файлове от https://ant.apache.org/bindownload.cgi
Стъпка 2) Разархивирайте файлове.
Разархивирайте този zip файл на удобно място, като например c:\folder, като използвате WinZip, WinRAR, 7-Zip, или подобен инструмент.
Стъпка 3) Създайте променлива на средата.
Създайте променлива на средата за „ANT_HOME“ и присвоете стойността на променливата на местоположението на папката Ant.
- Щракнете с десния бутон върху иконата „Този компютър“.
- Кликнете върху Свойства.
Стъпка 4) Отидете на системните настройки.
Кликнете върху „Разширени системни настройки“.
Стъпка 5) В свойствата на системата,
щракнете върху раздела „Разширени“.
Стъпка 6) Намерете променливите на средата.
Кликнете върху бутона „Променливи на средата…“.
Стъпка 7) Създайте нова променлива.
Кликнете върху „Ново“, за да създадете нова потребителска променлива.
Стъпка 8) Въведете данните за променливата.
Въведете данните за новата потребителска променлива.
- Въведете името на променливата като ANT_HOME.
- Въведете стойността на променливата като папката, където е разархивиран Ant, например C:\apache-ant-1.10.17.
- Кликнете върху бутона „OK“.
Стъпка 9) Променливата е създадена.
Кликнете върху бутона „OK“.
Стъпка 10) Затворете екрана.
Кликнете върху „OK“, за да затворите екрана.
💡 Съвет: ANT_HOME трябва да сочи към самата инсталационна папка, а не към папката bin в нея. След това добавете %ANT_HOME%\bin към променливата Path, така че командата ant да се разпознава от всяка директория.
Можете да проверите успешната инсталация на Ant чрез typing командата „ant -version“ в командния ред.
Ще видите следния екран:
Пример за Apache ANT
Файлът за изграждане по-долу дефинира една цел с име hello, която отпечатва съобщение. Елементът project декларира име и цел по подразбиране, така че Ant знае какво да изпълни, когато в командния ред не е посочена цел.
<?xml version="1.0"?> <project name="HelloWorld" default="hello" basedir="."> <target name="hello"> <echo>Hello, World</echo> </target> </project>
Запазете този файл като „build.xml“, след което следвайте тези две стъпки:
- Отворете командния ред и отидете в директорията, която съдържа build.xml.
- бягане
ant hello, или простоant, защото hello е деклариран като цел по подразбиране. За да използвате различно име на файл, изпълнетеant -f mybuild.xml hello.
Изход:
Buildfile: C:\projects\demo\build.xml
hello:
[echo] Hello, World
BUILD SUCCESSFUL
Total time: 0 seconds
Структура на проекта ANT
Структура на проекта ANT
Както показва структурната диаграма, всяка компилация ще съдържа три възела:
- Проект
- Target
- Task
Проект
Всичко вътре в компилационния файл в Apache ANT е под проект.
Атрибути:
- Име: Името на проекта.
- Базиран: Това е директорията, от която ще бъдат изчислени всички пътища. Това може да бъде променено с помощта на свойството „basedir“.
- По подразбиране: Помага ви да дефинирате целта по подразбиране за този проект. Ако не е зададена цел, Ant ще изпълни целта по подразбиране.
Target
Целта е набор от задачи, които са дефинирани за достигане на определено състояние в процеса на изграждане.
Атрибути:
- Име: Име на целта (задължително).
- Descriptйон: Descriptйон на целта.
- Зависи: От коя цел зависи тази текуща цел.
- Ако: Изпълнява целта само ако е зададена стойност за целево свойство.
- Освен ако: Изпълнява целта само ако стойността на свойството не е зададена.
Задачи
Задачата е част от код, която може да бъде изпълнена. Задачите имат множество аргументи или атрибути.
Общият метод за писане на задача е:
<name attribute1="value" attribute2="value2"…/>
Можете да използвате вградена задача или да създадете своя собствена. Таблицата по-долу изброява задачите, които се появяват в почти всеки Java файл за изграждане.
| Task | Цел | Типични атрибути |
|---|---|---|
| ехо | Изписване на съобщение към конзолата | съобщение |
| защитен режим | Създайте директория | реж. |
| изтриване | Премахване на файлове или директории | директория, включителнопразни директории |
| явански | Компилирам Java изходни файлове | srcdir, destdir, includeantruntime |
| буркан | Пакетиране на класове в jar архив | destfile, basedir |
| копирате | Копиране на файлове между местоположения | файл, todir |
| джунит | Изпълняване на модулни тестове | haltonfailure, printsummary |
Пълен пример за build.xm с множество Targets
Реалистичният файл за изграждане свързва няколко цели заедно. Атрибутът depends гарантира реда, така че Ant почиства изходната папка, компилира изходния код и едва след това изгражда jar файла.
<?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>
Изход:
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 срещу Maven срещу Gradle
Три инструмента за изграждане доминират Java екосистема и всяка от тях заема различна позиция относно това колко структура да наложи.
| Параметър | Apache Ant | Apache Maven | Gradle |
|---|---|---|---|
| Формат на скрипт за изграждане | XML | XML | Groovy или Kotlin DSL |
| Подход | Процедурно, вие определяте всяка стъпка | Декларативно, конвенция пред конфигурация | Декларативен със скриптови разширения |
| Управление на зависимости | Не е вграден, добавен е чрез Apache Ivy | Вграден с централно хранилище | Вграден, съвместим с Maven |
| Структура на проекта | Напълно безплатно | Фиксирано стандартно оформление | Базирано на конвенция, но с възможност за отмяна |
| Постепенни компилации | ограничен | ограничен | Да, с кеш за изграждане |
| Крива на обучение | Ниско за потребители на XML | Умерена | По-стръмно, изисква DSL |
| Най-подходящ за | Стари проекти и силно персонализирани разработки | Standard Java проекти | Голям многомодулен и Android проекти |
Ant остава прагматичният избор, когато дадена конструкция не се вписва в стандартно оформление или когато съществуващ проект вече зависи от ръчно написани цели.
Най-добри практики за използване на Apache Ant
Ето някои най-добри практики за използване на Apache Ant.
- Трябва да автоматизирате номерирането на компилации с помощта на файлове със свойства.
- Имплементирайте конфигурируемо компилиране с помощта на файлове със свойства по подразбиране и компилиране. Тези файлове ви позволяват да съхранявате свойства, които определят данните за вашия процес на компилиране, като например версия на компилатора и настройки за оптимизация.
- Можете да използвате повторно готови библиотеки, като използвате файлове със свойства на библиотеката.
- Дайте на всяка цел атрибут за описание, така че
ant -projecthelpизброява използваемо резюме на компилацията. - Дръжте чистата целева папка отделно и никога не изтривайте директория, която съдържа и изходни файлове.
Предимства от използването на Apache Ant
Ето предимствата от използването на Apache Ant:
- Ant е платформено-неутрален, така че ви помага да управлявате платформено-ориентирани свойства, като например разделители на файлове.
- Ant ви позволява да изпълнявате специфични за платформата задачи, като например промяна на времето на промяна на файл, използвайки командата „touch“.
- Ant скриптовете се пишат с помощта на обикновен XML, така че ако вече сте запознати с XML, ще можете бързо да научите Ant.
- Ant предлага голям списък с предварително дефинирани задачи.
- Той предлага интерфейс за разработкаping персонализирани задачи.
- Можете лесно да извикате Ant от командния ред, което позволява интеграция с безплатни и търговски IDE.
- Нуждаете се само от JVM, така че програмата работи навсякъде, където е налична JVM.
- Apache Ant е библиотека с отворен код, която позволява на потребителите да имат достъп до изходния код и да го възпроизвеждат.
- Apache Ant е междуплатформен инструмент, който ви позволява да управлявате Java classpath и структура на файловата директория по достъпен начин.
- Apache Ant е лесно разширим с помощта Java и други езици за програмиране.
- Apache Ant предлага вградена поддръжка за J2EE разработка, като например EJB компилация и пакетиране.
- Можете да го използвате както за малък личен проект, така и за голям софтуерен проект или уебсайт.
Ant често се свързва с тестов сървър и сървър за непрекъсната интеграция. Вижте JUnit за тестовия слой, Jenkins за планирани компилации и използване на Apache Ant с Selenium за автоматизация на тестовете на браузъра. Отчетите, генерирани по време на изграждането, могат да бъдат рендирани с JasperReports.













