Ant - Arquivos de propriedade

Definir propriedades diretamente no arquivo de construção é bom, se você estiver trabalhando com um punhado de propriedades. No entanto, para um projeto grande, faz sentido armazenar as propriedades em um arquivo de propriedades separado.

Armazenar as propriedades em um arquivo separado oferece os seguintes benefícios -

• Ele permite que você reutilize o mesmo arquivo de construção, com diferentes configurações de propriedade para diferentes ambientes de execução. Por exemplo, o arquivo de propriedades de construção pode ser mantido separadamente para ambientes DEV, TEST e PROD.

• É útil quando você não sabe os valores de uma propriedade (em um ambiente específico) antecipadamente. Isso permite que você execute a construção em outros ambientes onde o valor da propriedade é conhecido.

Não existe uma regra rígida e rápida, mas normalmente o arquivo de propriedade é nomeado build.properties e é colocado ao lado do build.xmlArquivo. Você pode criar vários arquivos de propriedades de construção com base nos ambientes de implantação - comobuild.properties.dev e build.properties.test.

O conteúdo do arquivo de propriedades de construção é semelhante ao arquivo de propriedades java normal. Eles contêm uma propriedade por linha. Cada propriedade é representada por um nome e um par de valores. Os pares de nome e valor são separados por um sinal de igual (=). É altamente recomendável que as propriedades sejam anotadas com comentários adequados. Os comentários são listados usando o caractere hash (#).

O exemplo a seguir mostra um build.xml arquivo e seu associado build.properties arquivo -

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

No exemplo acima, sitenameé uma propriedade personalizada mapeada para o nome do site. Você pode declarar qualquer número de propriedades personalizadas desta maneira. Outra propriedade customizada listada no exemplo acima é obuildversion, que, neste caso, se refere à versão da construção.

Além do acima, Ant vem com uma série de propriedades de construção predefinidas, que estão listadas na seção anterior, mas são representadas abaixo novamente.

Sr. Não.	Propriedades e descrição
1	ant.file A localização completa do arquivo de construção.
2	ant.version A versão da instalação do Apache Ant.
3	basedir O basedir da construção, conforme especificado no basedir atributo do project elemento.
4	ant.java.version A versão do JDK usada pelo Ant.
5	ant.project.name O nome do projeto, conforme especificado no name Atributo do project elemento.
6	ant.project.default-target O destino padrão do projeto atual.
7	ant.project.invoked-targets Lista separada por vírgulas dos destinos que foram chamados no projeto atual.
8	ant.core.lib A localização completa do arquivo jar Ant.
9	ant.home O diretório inicial da instalação do Ant.
10	ant.library.dir O diretório inicial para os arquivos da biblioteca Ant - normalmente a pasta ANT_HOME / lib.

O exemplo apresentado neste capítulo usa o ant.version propriedade embutida.