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

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

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

  • Он позволяет повторно использовать один и тот же файл сборки с разными настройками свойств для разных сред выполнения. Например, файл свойств сборки можно поддерживать отдельно для сред 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 встроенная собственность.