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ść.