Урок за Apache ANT: Какво представлява Ant Build Tool? Пример

⚡ Умно обобщение

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

  • 🔨 Основна дефиниция: Ant е акроним за Another Neat Tool и преобразува изходния код в изпълнимо приложение от командния ред.
  • 📄 Файл за изграждане: Всяка инструкция се намира в XML файл, обикновено наречен build.xml, който не изисква допълнителен език за програмиране.
  • 🧱 Структура с три възела: Файлът за изграждане винаги влага задачи в целите, а целите - в един проектен елемент.
  • 🔗 Контрол на зависимостите: Атрибутът depends подрежда целите, така че компилацията винаги се изпълнява преди jar и преди deployment.
  • ️ Настройка на средата: Инсталацията изисква JDK, променливата ANT_HOME и папката Ant bin, добавена към системния път.
  • 🆚 Сравнение на инструменти: Ant предлага процедурна свобода, Maven налага конвенция с управление на зависимостите и Gradle комбинира и двете със скриптово изграждане.
  • ???? Предимство на преносимостта: Компилацията работи по същия начин на Windows и Linux, където и да е Java Виртуалната машина е налична.

Урок за Apache ANT

Какво е инструмент за изграждане?

Инструментът за изграждане е инструмент за програмиране, който се използва за изграждане на нова версия на програма. Той автоматизира създаването на изпълнимо приложение от произволен изходен код.

Без инструмент за изграждане, разработчикът би компилирал ръчно всеки изходен файл, би копирал ресурси, би изпълнявал тестовия пакет и би пакетирал резултата при всяка промяна. Инструментът за изграждане записва тези стъпки веднъж и ги повтаря по един и същ начин на всяка машина.

Какво е Apache Ant?

Apache Ant е Javaбазиран на командния ред инструмент за изграждане Java приложения с пълна преносимост на pure Java код. Той позволява на разработчиците да възприемат гъвкави принципи и разработка, управлявана от тестове, за да автоматизират повтарящи се задачи за разработка, като например генериране на документация. Ant е акроним за Another Neat Tool (Друг чист инструмент).

Apache Ant

Както е показано на диаграмата, 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

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 2) Разархивирайте файлове.
Разархивирайте този zip файл на удобно място, като например c:\folder, като използвате WinZip, WinRAR, 7-Zip, или подобен инструмент.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 3) Създайте променлива на средата.
Създайте променлива на средата за „ANT_HOME“ и присвоете стойността на променливата на местоположението на папката Ant.

  1. Щракнете с десния бутон върху иконата „Този ​​компютър“.
  2. Кликнете върху Свойства.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 4) Отидете на системните настройки.
Кликнете върху „Разширени системни настройки“.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 5) В свойствата на системата,
щракнете върху раздела „Разширени“.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 6) Намерете променливите на средата.
Кликнете върху бутона „Променливи на средата…“.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 7) Създайте нова променлива.
Кликнете върху „Ново“, за да създадете нова потребителска променлива.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 8) Въведете данните за променливата.
Въведете данните за новата потребителска променлива.

  1. Въведете името на променливата като ANT_HOME.
  2. Въведете стойността на променливата като папката, където е разархивиран Ant, например C:\apache-ant-1.10.17.
  3. Кликнете върху бутона „OK“.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 9) Променливата е създадена.
Кликнете върху бутона „OK“.

Инсталирайте и конфигурирайте Apache Ant на Windows

Стъпка 10) Затворете екрана.
Кликнете върху „OK“, за да затворите екрана.

Инсталирайте и конфигурирайте Apache Ant на Windows

💡 Съвет: ANT_HOME трябва да сочи към самата инсталационна папка, а не към папката bin в нея. След това добавете %ANT_HOME%\bin към променливата Path, така че командата ant да се разпознава от всяка директория.

Можете да проверите успешната инсталация на Ant чрез typing командата „ant -version“ в командния ред.

Ще видите следния екран:

Инсталирайте и конфигурирайте Apache Ant на Windows

Пример за 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

Структура на проекта 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.

Въпроси и Отговори

Ant е акроним за Another Neat Tool (Друг чудесен инструмент). Джеймс Дънкан Дейвидсън го създава през юли 2000 г., докато работи върху компилацията на Tomcat, и е дарен на Apache Software. Foundation.

Не, но Ant търси build.xml по подразбиране в текущата директория. Всяко друго име работи, когато е подадено с опцията -f или -buildfile от командния ред.

Не самостоятелно. Apache Ivy е съпътстващият проект, който добавя разрешаване на зависимости и може да изтегля артефакти от същите хранилища, които Maven използва.

Папката bin липсва в променливата Path или ANT_HOME сочи към грешна директория. Отворете нов команден ред след редактиране на променливите, защото съществуващите прозорци запазват старите стойности.

Да за стандартни цели за компилиране, jar и test. Проверете записите в classpath и атрибута includeantruntime, защото генерираните файлове често ги пропускат и генерират объркващи предупреждения.

Да, за запазване на наследството Java системи, където съществуващата компилация не може да бъде мигрирана евтино. Новите проекти обикновено започват с Maven или Gradle, които инструментите с изкуствен интелект също така изграждат скеле по-надеждно.

Обобщете тази публикация с: