The OpenNET Project / Index page

[ новости/++ | форум | wiki | теги ]

Ant за 10 шагов (make ant java)


<< Предыдущая ИНДЕКС Правка src / Печать Следующая >>
Ключевые слова: make, ant, java,  (найти похожие документы)
From: http://javatech.info Date: Mon, 10 Apr 2006 18:21:07 +0000 (UTC) Subject: Ant за 10 шагов Оригинал: docs.javatech.info (Перевод Ant in Ten Steps by Russ Olsen) Штука в том, что файлы Ant похожи на фруктовый кекс - на самом деле он один, и вы передаете их друг другу на протяжении лет. Если больше читателей прекратят это делать и выучат немного Ant, может их проекты станут чуточку лучше. Итак, это 10 вещей, которые вы должны знать об этом инструменте. Содержание * 1 Шаг 1: Почему Ant? * 2 Шаг 2: Как работает Ant * 3 Шаг 3: Твой первый сценарий Ant. * 4 Шаг 4: Зависимости в Ant * 5 Шаг 5: Асоциальные задания * 6 Шаг 6: Компилирование Java * 7 Шаг 7: Jar'ы и Filesets * 8 Шаг 8: Свойства как переменные, но... * 9 Шаг 9: Файлы Properties * 10 Шаг 10: Задачи по условию * 11 В заключение Шаг 1: Почему Ant? Ant - это инструмент, который призван автоматизировать процесс сборки ПО. В идеале Ant сделает из всех ваших исходных файлов инсталлируемый пакет, готовый к записи на CD. Новички Ant'а иногда спрашивают, что может Ant, чего нельзя сделать другими способами. Например, если я хочу откомпилировать несколько Java файлов и сделать Jar из полученных файлов классов, то я могу просто набрать команды руками: $ javac -d build src/Main.Java src/Utils.src/Java GUI.Java $ cd build $ jar -cvf ../mystuff.jar Main.class Utils.class GUI.class Это сработает, но этот метод может порождать ошибки и утомительный, он не станет лучше, если ваша система станет включать все больше и больше Java файлов. Конечно, вы можете засунуть все это в сценарий оболочки или Perl: #!/bin/sh javac -d build src/Main.Java src/Utils.Java src/GUI.Java cd buildre are ten things you need to know about this tool. jar -cvf ../mystuff.jar Main.class Utils.class GUI.class Проблема в том, что оболочка и Perl являются инструментами общего назначения - наряду со сборкой ПО, вы можете написать web сервер или ПО баз данных на Perl. Ant специализируется на одном - на сборке ПО. Он может, и использует любую возможность чтобы помочь вам собрать ваше ПО. Ant делает это потому что знает, что вы занимаетесь сборкой ПО - вот почему вы должны использовать Ant для сборки и никакие другие средства. Это отличие является несущественным, когда вы начинаете маленький проект, но с большими системами специализированные средства, такие как Ant могут быть выбором между жизнью и смертью. Шаг 2: Как работает Ant Ant немного похож на фабрику. Сырьем для него является то, что создают программисты - исходный код на Java, программы, написанные на других языках, дескрипторы развертывания и т.д. Что должно получится на выходе - скомпилированные программы, готовые к использованию. В процессе получения из исходного кода готового продукта, Ant'у необходима помощь в виде build файла. Build файл (также известный как <<Ant файл>>, или <<build сценарий>> (<<сценарий сборки>>) или <<файл build.xml>>) показывает Ant'у что надо делать, чтобы превратить то что есть (как правило, исходный код) в то что вы хотите. Build файл похож на детальный план - он говорит вам как собрать из частей единое целое. Build файл содержит правила, которые указывают Ant'у делать вещи наподобие таких: - В соответствии с тем что мне нужно, скопируй Russell.jar в каталог релиза... - кстати, сначала ты должен собрать Russell.jar; - кстати, для того, чтобы собрать Russell.jar, примени команду jar к *.class файлам - кстати, тебе нужно скомпилировать class файлы, если ты этого еще не сделал. - Для того, чтобы сделать *.class файлы, запусти компилятор Java для *.java файлов. Шаг 3: Твой первый сценарий Ant. Хватит теории, давай посмотрим на реальный, хотя и очень маленький Ant файл. Нижеследующее является <<Hello world>> build файлов. <project name="MyProject" default="all"> <target name="all" description="Do the entire build" > <echo>I'm building my software</echo> </target> </project> Как видишь, это XML файл, содержащий элемент <project>. <project> содержит 2 атрибута: - Имя; - Задание по умолчанию, под названием <<all>>. Имя является просто обозначением, обычно оно нигде не используется. Задание по умолчанию - это имя того задания, которое вы хотите, чтобы Ant выполнял по умолчанию. Это задание Ant выполнит если вы не укажите ему, что собирать. Наполнением build файла являются элементы <target>. По сути, этот элемент <target> значит следующее: чтобы собрать нечто под названием <<all>>, выполни команду <echo>. Для того чтобы заставить Ant что-то сделать, вы должны выполнить команду Ant и указать ей какой файл содержит инструкции сборки: $ Ant -f build.xml Buildfile: build.xml all: [echo] I'm building my software BUILD SUCCESSFUL Total time: 1 second Итак, что здесь произошло? - Ant нашел build файл и прочитал его; - Так как ты не указал ему, что делать, он решил выполнить задание по умолчанию <<all>>; - Ant собрал цель путем выполнения команды <echo>. Шаг 4: Зависимости в Ant Давай рассмотрим файл с более чем одним заданием: <project name="02.depend" default="all" > <description>This is a project which uses dependancies</description> <target name="make.dirs" description="Make a dir"> <mkdir dir="build"/> </target> <target name="all" description="Do the build" depends="make.dirs"> <echo>I'm building my software</echo> </target> </project> Так как имя по умолчанию для build файла - это build.xml, то мы можем опустить аргумент -f и просто набрать Ant без параметров: $ Ant Buildfile: build.xml make.dirs: [ mkdir] Created dir: /home/russ/Ant_example/02.depend/build all: [echo] I'm building my software BUILD SUCCESSFUL Total time: 1 second Этот build файл содержит два задания, уже знакомое <<all>> и новое, <<make.dirs>>. <<make.dirs>> вызывает встроенную в Ant команду mkdir - Ant называет его встроенные команды задачами - для создания новой директории. Обратите внимание на тот факт, что задание <<all>> указывает на то, что оно зависит от задания <<make.dirs>>. Эта зависимость означает, что для того чтобы собрать <<all>>, мы должны сначала собрать <<make.dirs>>. Идея зависимости является ключевой в работе Ant'а - большая часть работы по написанию Ant файлов состоит в построении сложных паутин зависимости. Шаг 5: Асоциальные задания Наш следующий пример содержит 3-е задание, под названием <<clean>>: <project name="nodefault" default="all" > <target name="make.dirs" description="Make some dirs"> <mkdir dir="build"/> </target> <target name="all" description="Do the build" depends="make.dirs"> <echo>I'm building my software</echo> </target> <target name="clean" description="Clean up"> <echo>I'm cleaning up.</echo> <delete dir="build"/> </target> </project> <<clean>> просто удаляет каталог сборки, который создается заданием <<make.dirs>>. Ты обычно включаешь <<clean>> для уборки после сборки всех сгенерированных файлов. Но замечу, что <<clean>> не является заданием по умолчанию и задание по умолчанию не зависит от него. Так как же ты сможешь выполнить <<clean>>? Путем набора следующего: $ Ant clean Buildfile: build.xml clean: [echo] I'm cleaning up. BUILD SUCCESSFUL Total time: 1 second Шаг 6: Компилирование Java Итак, давай попытаемся сделать что-нибудь полезное с Ant, например, откомпилируем что-то из Java кода: <project name="MyProject" default="all" > <target name="make.dirs" description="Make some dirs"> <mkdir dir="build"/> <mkdir dir="build/class"/> </target> <target name="compile" description="compile java" depends="make.dirs"> <javac destdir="build/class"> <src path="src"/> </javac> </target> <target name="all" description="Do the build" depends="compile"/> <target name="clean" description="clean up"> <echo>I'm cleaning up.</echo> <delete dir="build"/> </target> </project> Похоже, что мы имеем задание по умолчанию <<all>>, зависящее от <<compile>>, которое вызывает задачу javac, встроенную в Ant. Вот что произойдет, когда мы запустим этот сценарий: Ant Buildfile: build.xml make.dirs: [mkdir] Created dir: /home/rolsen/Documents/Ant/04.compile/build [mkdir] Created dir: /home/rolsen/Documents/Ant/04.compile/build/class compile: [javac] Compiling 1 source file to /home/russ/build/class all: BUILD SUCCESSFUL Total time: 2 seconds Существует 2 интересные особенности задачи javac. Во-первых, ты можешь не указывать непосредственно имена java файлов, которые хочешь скомпилировать - достаточно просто указать каталог. Во-вторых, javac может определить, когда class файл существует и новее, чем java файл, в этом случае, она ничего не откомпилирует. Ты можешь проверить это, выполнив строку дважды - во втором случае javac ничего не откомпилирует. Эти 2 особенности являются примерами приемов сборки ПО, упоминавшихся ранее. Так как Ant знает, что то, что вы делаете, это попытка собрать ПО, он пропускает все, что уже сделано. Сейчас давай обратимся к яду, отравляющему жизнь Java программиста - classpath. Как ты знаешь, classpath в Java это список Jar файлов и/или каталогов, который сообщает Java где искать файлы библиотек. Проблема состоит в том, что в сложных системах classpath может становиться очень длинным и запутанным. Ant предоставляет тебе 2 метода для определения classpath, или прямо в самой javac: <project name="04b.classpath" default="all" > <target name="make.dirs" description="Make some dirs"> <mkdir dir="build"/> <mkdir dir="build/class"/> </target> <target name="all" description="compile java" depends="make.dirs"> <javac destdir="build/class" classpath="extra.jar"> <src path="src"/> </javac> </target> </project> ...или ты можешь указать classpath отдельно, что удобно есть путь длинный или используется в нескольких заданиях. <project name="04c.classpath" default="all" > <target name="make.dirs" description="Make some dirs"> <mkdir dir="build"/> <mkdir dir="build/class"/> </target> <path id="myclasspath" > <fileset dir="lib"> <include name="**/*.jar"/> </fileset> </path> <target name="all" description="compile java" depends="make.dirs"> <javac destdir="build/class" classpathref="myclasspath"> <src path="src"/> </javac> </target> </project> Недостаток этого в том, что Ant принимает это значение без дополнительной проверки, существует ли jar файл, который ты указал в сценарии. Поэтому, если ты ошибся в имени jar файла, Ant не покажет тебе место ошибки - проверяй то, что вводишь. Шаг 7: Jar'ы и Filesets Java приложения как правило поставляются упакованными в jar файлы. Jar файлы похожи на привычные нам zip файлы - один jar файл может содержать любое количество файлов собранных вместе и сжатых. Ant предоставляет специальную задачу для создания jar файлов: <project name="05.jar" default="all" > <target name="make.dirs" description="Make some dirs"> <mkdir dir="build"/> <mkdir dir="build/class"/> </target> <target name="compile" description="compile java" depends="make.dirs"> <javac destdir="build/class"> <src path="src"/> </javac> </target> <target name="stuff.jar" description="make jar file" depends="compile"> <jar destfile="build/stuff.jar"> <fileset dir="build/class"> <include name="**/*.class"/> <exclude name="**/CVS"/> </fileset> </jar> </target> <target name="all" description="Do the build" depends="stuff.jar"/> </project> Заметьте, что атрибут <<distfile>> сообщает Ant'у имя создаваемого jar файла, в то время как файлы, помещаемые в jar файл, указываются через элемент fileset. Filese'ыt могут быть использованы во многих задачах, требующих списков файлов и являются очень мощным методом указания файлов по маске. Jar задача имеет те же особенности, что и javac: если jar файл существует и имеет более новую дату и время, то задача jar сэкономит время и ничего не сделает. Шаг 8: Свойства как переменные, но... Ant также позволяет тебе установить аналогичные переменным сущности, называемые свойствами: <project name="MyProject" default="all" > <property name="month" value="July"/> <target name="all" description="Uses properties"> <echo>The month is ${month}</echo> </target> </project> Причина того, что Ant не называет их переменными в том, что свойства не могут изменять своего значения, будучи раз установленными. То есть, свойства похожи на переменные, за исключением того, что они не изменяются. Поэтому, если мы выполним следующий Ant сценарий: <project name="07.notvars" default="all" > <property name="month" value="Jan"/> <property name="month" value="Dec"/> <target name="all" description="Uses properties"> <echo>This month is ${month}</echo> </target> </project> Значение month не измениться с того времени, как оно установиться в "Jan": Buildfile: build.xml all: [echo] This month is Jan BUILD SUCCESSFUL Total time: 0 seconds Шаг 9: Файлы Properties Ant также позволяет тебе установить переменные в отдельном property файле, называемом Ant.properties: # # A sample Ant properties file # month=30 days year=2004 Ты можешь получить доступ к файлу свойств, используя специальную форму элемента <property>: <project name="08.propfile" default="all" > <property file="Ant.properties"/> <property name="month" value="Jan"/> <property name="year" value="1066"/> <target name="all" description="Uses properties"> <echo>This month is ${month}</echo> <echo>This year is ${year}</echo> </target> </project> Просто запомните, что неважно как оно было установлено, если свойство получает значение, оно ведет себя как собака с костью: однажды установив, ты не можешь поменять значение свойства. Собрав все вместе, ниже приведен ранее упоминавшийся пример с построением jar файла с повторяющимися путями, помещенными в свойства: <project name="09.jarprops" default="all" > <property file="Ant.properties"/> <property name="build.dir" value="build"/> <property name="class.dir" value="${build.dir}/class"/> <property name="stuff.jar" value="${build.dir}/stuff.jar"/> <target name="make.dirs" description="Make some dirs"> <mkdir dir="${build.dir}"/> <mkdir dir="${class.dir}"/> </target> <target name="compile" description="compile java" depends="make.dirs"> <javac destdir="${class.dir}"> <src path="src"/> </javac> </target> <target name="stuff.jar" description="make jar file" depends="compile"> <jar destfile="${stuff.jar}"> <fileset dir="${class.dir}"> <include name="**/*.class"/> <exclude name="**/CVS"/> </fileset> </jar> </target> <target name="all" description="Do the build" depends="stuff.jar"/> <target name="clean" description="clean up"> <echo>I'm cleaning up.</echo> <delete dir="${build.dir}"/> </target> </project> Шаг 10: Задачи по условию Ты можешь использовать свойства для включения и выключения отдельных заданий. Посмотри на следующий пример: <project name="10.ifprop" default="all" > <target name="debug.build" unless="production"> <echo>Pretending to do a debug build</echo> </target> <target name="production.build" if="production"> <echo>Pretending to do a production build</echo> </target> <target name="all" description="Do the build" depends="production.build,debug.build"/> </project> Как видишь, если установлено свойство <<production>>, то выполниться задание <<production.build>>, но если свойство не установлено, то будет выполнено <<debug.build>>. Обрати внимание на то, что в if и unless Ant лишь проверяет, имеет ли свойство значение. Ant не проверяет, какое это значение - поэтому, в преведеном выше файле мы получим сборку production если свойство <<production>> будет установлено в <<true>>, <<false>> или <<waitingforgodot>>. В заключение Естественно, невозможно в такой статье как эта, провести нечто больше чем вступление в Ant. К счастью, Ant поставляется с детальной документацией. А его основной сайт - очень интересное и приятное лекарство от бессонницы. Напоследок, пара хороших книг: Java Development with Ant Erik Hatcher and Steve Loughran ISBN 1930110588 Ant: The Definitive Guide By Jesse E. Tilly, Eric M. Burke ISBN 0596001843

<< Предыдущая ИНДЕКС Правка src / Печать Следующая >>

Обсуждение [ Линейный режим | Показать все | RSS ]
 
  • 1.1, oracl3l, 00:04, 01/02/2008 [ответить] [смотреть все]
  • +/
    Спасибо. Просто и понятно.
     
  • 1.2, mkind, 17:34, 04/02/2008 [ответить] [смотреть все]
  • +/
    а вот теперь можно начинать читать мануал на ant.apache.org :)
     
  • 1.3, Цыба, 18:03, 13/03/2008 [ответить] [смотреть все]
  • +/
    для дошкольников :)
     
  • 1.4, tenzor, 18:52, 13/03/2008 [ответить] [смотреть все]
  • +/
    большое спасибо! отличное вступление в ант
     
  • 1.5, Zubilo, 11:48, 18/04/2008 [ответить] [смотреть все]
  • +/
    Супер! То что надо!
     
  • 1.6, lego, 18:39, 09/07/2008 [ответить] [смотреть все]  
  • +/
    Спасибо) я дошкольник) мне помогло)
     
  • 1.7, EugeneS, 16:59, 14/08/2008 [ответить] [смотреть все]  
  • +/
    Спасибо
     
  • 1.8, dimiosis, 19:51, 08/09/2008 [ответить] [смотреть все]  
  • +/
    "Спасибо) я дошкольник) мне помогло) "
    +1
     
  • 1.9, проорми, 21:28, 30/09/2008 [ответить] [смотреть все]  
  • +/
    а мне не помогло..........плакаю((((
     
     
  • 2.12, Дошкольник, 14:54, 22/10/2008 [^] [ответить] [смотреть все] [показать ветку]  
  • +/
    Значит уже ничего непоможет!
    А Автору спасибо!
     
  • 1.10, trikoz, 11:49, 13/10/2008 [ответить] [смотреть все]  
  • +/
    а что за ошибка по 3 примеру?
    Buildfile: C:\Documents and Settings\user\workspace\Project\build.xml
    make.dirs:
    compile:
        [javac] Compiling 33 source files to C:\Documents and Settings\user\workspace\Project\build\class

    BUILD FAILED
    C:\Documents and Settings\user\workspace\Project\build.xml:9: Unable to find a javac compiler;
    com.sun.tools.javac.Main is not on the classpath.
    Perhaps JAVA_HOME does not point to the JDK.
    It is currently set to "C:\Program Files\Java\jre1.5.0"

    Total time: 156 milliseconds

     
  • 1.11, DimYLiK, 12:54, 16/10/2008 [ответить] [смотреть все]  
  • +/
    ska4aj takoe jdk1.5.0_11 i ukazhi JAVA_HOME na nevo.
     
  • 1.13, Google, 12:56, 09/12/2008 [ответить] [смотреть все]  
  • +/
    Тут ошибка

    $ javac -d build src/Main.Java src/Utils.src/Java GUI.Java

    надо

    src/Main.Java src/Utils.Java src/GUI.Java

     
  • 1.14, atol, 10:29, 20/02/2009 [ответить] [смотреть все]  
  • +/
    ага.. и мне немного помогло..
     
  • 1.15, новичок, 13:54, 27/04/2009 [ответить] [смотреть все]  
  • +/
    отлично!!! для меня самое то!!!!
     
  • 1.17, kio21, 17:07, 03/09/2009 [ответить] [смотреть все]  
  • +/
    10-ый шаг туманно описан, за остальное спс
     
  • 1.19, Тант, 18:57, 09/02/2010 [ответить] [смотреть все]  
  • +/
    Спасибо
     
  • 1.20, школьник, 10:53, 12/02/2010 [ответить] [смотреть все]  
  • +/
    хорошая статья для начала... не отпугивает.
    Спасибо.
     
  • 1.21, гы, 10:57, 09/07/2010 [ответить] [смотреть все]  
  • +/
    спасибо!
     
  • 1.22, Sergey, 15:58, 22/09/2010 [ответить] [смотреть все]  
  • +/
    Огромное спсб! Статья просто супер!!! :)
     
  • 1.23, Alex, 18:57, 23/09/2010 [ответить] [смотреть все]  
  • +/
    Гуд!
     
  • 1.24, almat, 13:08, 13/11/2010 [ответить] [смотреть все]  
  • +/
    спасибо, то что надо для начала!
     
  • 1.25, hakobhn, 11:46, 01/12/2010 [ответить] [смотреть все]  
  • +/
    very helpful, thanks
     
  • 1.26, пендальф, 09:41, 16/12/2010 [ответить] [смотреть все]  
  • +/
    Спасибо большое, просто и лаконично...пойду собирать
     
  • 1.27, nobody, 18:22, 24/12/2010 [ответить] [смотреть все]  
  • +/
    очень интересно! теперь можно читать документацию :)
     
  • 1.28, Женя, 18:29, 02/08/2011 [ответить] [смотреть все]  
  • +/
    Спасибо, просто и понятно =)))
     
  • 1.29, Валерия, 12:36, 04/02/2013 [ответить] [смотреть все]  
  • +/
    Спасибо! Очень помогло! Для старта то что нужно.
     
  • 1.30, cornholio, 18:28, 12/03/2013 [ответить] [смотреть все]  
  • +/
    Хорошая статья. Очень помогла.
     
  • 1.31, Артем, 17:19, 24/07/2013 [ответить] [смотреть все]  
  • +/
    Доступно и понятно. Спасибо автору.
     
  • 1.32, Сергей, 11:06, 21/12/2013 [ответить] [смотреть все]  
  • +/
    Спасибо большое за хорошую статью!
    Очень доступно написано. Все скрипты рабочие - все попробовал)
     
  • 1.33, Piligrim, 13:11, 28/01/2014 [ответить] [смотреть все]  
  • +/
    Спасибо! Очень хорошее руководство для быстрого старта!)
     
  • 1.34, Максуд, 14:36, 28/10/2015 [ответить] [смотреть все]  
  • +/
    Статья супер! Спасибо огромное :)

    P.S.
    Пожалуйста исправьте. Мелочи, но глаз режут.

    Шаг 7. Параграф 2.
    <<distfile>> на  <<dEstfile>>  

    Шаг 4. Строка 2 в коде
    dependancies на dependEncies

    Шаг 8. Параграф 3.
    оба мягких знака в глаголах лишние

    Шаг 10. Параграф 2.
    лишний мягкий знак

    В заключениИ.

     
  • 1.35, httpphylife.ru, 09:26, 03/02/2016 [ответить] [смотреть все]  
  • +/
    ещё ошибка:

    Filese'ыt могут быть

     

    Ваш комментарий
    Имя:         
    E-Mail:      
    Заголовок:
    Текст:





      Закладки на сайте
      Проследить за страницей
    Created 1996-2017 by Maxim Chirkov  
    ДобавитьРекламаВебмастеруГИД  
    Hosting by Ihor