Ant - Pliki właściwości

Ustawienie właściwości bezpośrednio w pliku kompilacji jest w porządku, jeśli pracujesz z kilkoma właściwościami. Jednak w przypadku dużego projektu sensowne jest przechowywanie właściwości w oddzielnym pliku właściwości.

Przechowywanie właściwości w oddzielnym pliku zapewnia następujące korzyści -

  • Umożliwia ponowne użycie tego samego pliku kompilacji z różnymi ustawieniami właściwości dla różnych środowisk wykonawczych. Na przykład plik właściwości kompilacji może być obsługiwany oddzielnie dla środowisk DEV, TEST i PROD.

  • Jest to przydatne, gdy nie znasz wartości właściwości (w określonym środowisku) z góry. Pozwala to na wykonanie kompilacji w innych środowiskach, w których znana jest wartość właściwości.

Nie ma sztywnej i szybkiej reguły, ale zazwyczaj plik właściwości ma nazwę build.properties i jest umieszczony obok build.xmlplik. Można utworzyć wiele plików właściwości kompilacji w oparciu o środowiska wdrażania - takie jakbuild.properties.dev i build.properties.test.

Zawartość pliku właściwości kompilacji jest podobna do normalnego pliku właściwości Java. Zawierają po jednej właściwości w każdym wierszu. Każda właściwość jest reprezentowana przez nazwę i parę wartości. Pary nazwa i wartość są oddzielone znakiem równości (=). Zdecydowanie zaleca się, aby właściwości były opatrzone odpowiednimi komentarzami. Komentarze są wymienione przy użyciu znaku krzyżyka (#).

Poniższy przykład przedstawia plik build.xml plik i skojarzony z nim plik build.properties plik -

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

W powyższym przykładzie sitenameto właściwość niestandardowa, która jest mapowana na nazwę witryny internetowej. W ten sposób możesz zadeklarować dowolną liczbę właściwości niestandardowych. Inną niestandardową właściwością wymienioną w powyższym przykładzie jestbuildversion, co w tym przypadku odnosi się do wersji pliku build.

Oprócz powyższego, Ant oferuje szereg predefiniowanych właściwości kompilacji, które zostały wymienione w poprzedniej sekcji, ale są ponownie przedstawione poniżej.

Sr.No. Właściwości i opis
1

ant.file

Pełna lokalizacja pliku kompilacji.

2

ant.version

Wersja instalacji Apache Ant.

3

basedir

Bazującyir kompilacji, jak określono w basedir atrybut klasy project element.

4

ant.java.version

Wersja JDK używana przez Ant.

5

ant.project.name

Nazwa projektu, jak określono w name atrybuty project element.

6

ant.project.default-target

Domyślny cel bieżącego projektu.

7

ant.project.invoked-targets

Rozdzielana przecinkami lista celów, które zostały wywołane w bieżącym projekcie.

8

ant.core.lib

Pełna lokalizacja pliku jar Ant.

9

ant.home

Katalog domowy instalacji Ant.

10

ant.library.dir

Katalog domowy dla plików biblioteki Ant - zwykle folder ANT_HOME / lib.

W przykładzie przedstawionym w tym rozdziale zastosowano rozszerzenie ant.version wbudowana nieruchomość.