Sección de lista de propiedades y propiedades

La sección de lista de propiedades opcional permite definir y asignar las variables (denominadas “propiedades”) que se podrán usar más adelante en el archivo de configuración. Las definiciones de propiedades realizadas en esta sección se denominan propiedades “internas”.

<!-- definir propiedades ampliables -->
<!-- opcional -->
<propertylist>
 <property name="projectname" value="myproject"/>
 <property name="projectdir" value="c:\myprojects"/>
</propertylist>

Las variables (“referencias a propiedades”) también se pueden usar en el archivo de configuración sin definirlas en esta sección. Por ejemplo, se pueden definir en la línea de comandos o proceder del entorno.

Las propiedades funcionan mediante la sustitución de cadenas y usan el siguiente algoritmo para encontrar un valor asociado a la propiedad:

1. Busca un valor en la lista de propiedades externas.
2. Si no lo encuentra, busca una variable de entorno con el mismo nombre que la propiedad.
3. Si no la encuentra, busca una definición interna en la sección propertylist del archivo de configuración.
4. Si no la encuentra, usa la cadena vacía como valor.

Las propiedades externas se pasan desde la línea de comandos mediante la opción –p. Hay tres propiedades externas integradas:

• “applicationdir”, que indica el directorio de instalación de Dotfuscator.
• “appdatadir”, que indica el directorio de datos locales de Dotfuscator.
• “configdir”, que indica el directorio donde se encuentra el archivo de configuración.

Las propiedades resultan útiles para crear archivos de configuración que actúan como plantillas para varios proyectos, para diferentes versiones del mismo proyecto o con fines de portabilidad entre diferentes entornos de compilación.

Para hacer referencia a una propiedad se usa la siguiente sintaxis:

${property_name}

Las referencias a propiedades distinguen entre mayúsculas y minúsculas, por lo tanto ${MyProjectDir} hace referencia a una propiedad diferente que ${myprojectdir}.

Las referencias a propiedades no se pueden usar en cualquier lugar del archivo de configuración. En este momento, las referencias a propiedades sólo se pueden usar como valores de los atributos “dir” o “name” del elemento <file>. A continuación se ofrece una lista de las secciones que usan el elemento <file>:

inputassembly	mapinput	mapoutput
output	tempdir	assembly
removalreport	transform	key
loadpaths	program	filelist

Una referencia a una propiedad se interpretará literalmente en otro lugar del archivo de configuración.

Las referencias a propiedades no se pueden anidar. La anidación produce un error.

A continuación se ofrece un ejemplo del uso de una referencia a una propiedad:

<output> 
 <file dir="${testdir}\output"/>
</output>

© 2002-2007 PreEmptive Solutions. Reservados todos los derechos.