Муравей - Файлы свойств

Установка свойств непосредственно в файле сборки - это нормально, если вы работаете с несколькими свойствами. Однако для большого проекта имеет смысл хранить свойства в отдельном файле свойств.

Хранение свойств в отдельном файле дает следующие преимущества:

Он позволяет повторно использовать один и тот же файл сборки с разными настройками свойств для разных сред выполнения. Например, файл свойств сборки можно поддерживать отдельно для сред 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- настраиваемое свойство, которое сопоставляется с именем веб-сайта. Таким образом вы можете объявить любое количество настраиваемых свойств. Еще одно настраиваемое свойство, указанное в приведенном выше примере, - этоbuildversion, который в данном случае относится к версии сборки.

В дополнение к вышесказанному, Ant поставляется с рядом предопределенных свойств сборки, которые перечислены в предыдущем разделе, но еще раз представлены ниже.

Sr. No.	Свойства и описание
1	ant.file Полное расположение файла сборки.
2	ant.version Версия установки Apache Ant.
3	basedir Основание сборки, как указано в basedir атрибут project элемент.
4	ant.java.version Версия JDK, используемая Ant.
5	ant.project.name Название проекта, как указано в name атрибут project элемент.
6	ant.project.default-target Цель по умолчанию для текущего проекта.
7	ant.project.invoked-targets Разделенный запятыми список целей, которые были вызваны в текущем проекте.
8	ant.core.lib Полное расположение файла jar Ant.
9	ant.home Домашний каталог установки Ant.
10	ant.library.dir Домашний каталог для файлов библиотеки Ant - обычно папка ANT_HOME / lib.

В примере, представленном в этой главе, используется ant.version встроенная собственность.