Установка свойств непосредственно в файле сборки — это хорошо, если вы работаете с несколькими свойствами. Однако для большого проекта имеет смысл хранить свойства в отдельном файле свойств.
Хранение свойств в отдельном файле дает следующие преимущества:
-
Это позволяет повторно использовать один и тот же файл сборки с разными настройками свойств для разных сред выполнения. Например, файл свойств сборки можно поддерживать отдельно для сред DEV, TEST и PROD.
-
Это полезно, если вы заранее не знаете значения свойства (в конкретной среде). Это позволяет выполнять сборку в других средах, где значение свойства известно.
Это позволяет повторно использовать один и тот же файл сборки с разными настройками свойств для разных сред выполнения. Например, файл свойств сборки можно поддерживать отдельно для сред DEV, TEST и PROD.
Это полезно, если вы заранее не знаете значения свойства (в конкретной среде). Это позволяет выполнять сборку в других средах, где значение свойства известно.
Не существует жесткого и быстрого правила, но обычно файл свойств называется build.properties и размещается рядом с файлом build.xml . Вы можете создать несколько файлов свойств сборки на основе сред развертывания, таких как build.properties.dev и build.properties.test.
Содержимое файла свойств сборки похоже на обычный файл свойств java. Они содержат одно свойство на строку. Каждое свойство представлено именем и парой значений. Пары имя и значение разделены знаком равенства (=). Настоятельно рекомендуется пометить свойства соответствующими комментариями. Комментарии перечислены с использованием символа хеша (#).
В следующем примере показан файл build.xml и связанный с ним файл build.properties:
build.xml
<?xml version = "1.0"?> <project name = "Hello World Project" default = "info"> <property file = "build.properties"/> <target name = "info"> <echo>Apache Ant version is ${ant.version} - You are at ${sitename} </echo> </target> </project>
build.properties
# The Site Name sitename = www.tutorialspoint.com buildversion = 3.3.2
В приведенном выше примере sitename — это пользовательское свойство, которое сопоставляется с именем веб-сайта. Вы можете объявить любое количество пользовательских свойств таким способом. Другим пользовательским свойством, перечисленным в приведенном выше примере, является версия сборки , которая в данном случае относится к версии сборки.
В дополнение к вышесказанному, Ant поставляется с рядом предопределенных свойств сборки, которые перечислены в предыдущем разделе, но представлены еще раз ниже.
| Sr.No. | Свойства и описание |
|---|---|
| 1 |
ant.file Полное расположение файла сборки. |
| 2 |
ant.version Версия установки Apache Ant. |
| 3 |
имя_базовой_папки Basedir сборки, как указано в атрибуте basedir элемента проекта . |
| 4 |
ant.java.version Версия JDK, используемая Ant. |
| 5 |
ant.project.name Имя проекта, указанное в атрибуте имени элемента проекта . |
| 6 |
ant.project.default-мишени Цель по умолчанию для текущего проекта. |
| 7 |
ant.project.invoked-мишени Разделенный запятыми список целей, которые были вызваны в текущем проекте. |
| 8 |
ant.core.lib Полное расположение файла Ant jar. |
| 9 |
ant.home Домашний каталог установки Ant. |
| 10 |
ant.library.dir Домашний каталог для файлов библиотеки Ant — обычно это папка ANT_HOME / lib. |
ant.file
Полное расположение файла сборки.
ant.version
Версия установки Apache Ant.
имя_базовой_папки
Basedir сборки, как указано в атрибуте basedir элемента проекта .
ant.java.version
Версия JDK, используемая Ant.
ant.project.name
Имя проекта, указанное в атрибуте имени элемента проекта .
ant.project.default-мишени
Цель по умолчанию для текущего проекта.
ant.project.invoked-мишени
Разделенный запятыми список целей, которые были вызваны в текущем проекте.
ant.core.lib
Полное расположение файла Ant jar.
ant.home
Домашний каталог установки Ant.
ant.library.dir
Домашний каталог для файлов библиотеки Ant — обычно это папка ANT_HOME / lib.
В примере, представленном в этой главе, используется встроенное свойство ant.version .