Los archivos raíz son archivos que deben empaquetarse con una instalación de Eclipse pero que no son características ni
plug-ins. Ejemplos comunes son el ejecutable de Eclipse y archivos ini, así como archivos de licencia.
Los archivos
raíz los aporta a una construcción las características que contienen las propiedades raíz adecuadas.
root |
Especificar una lista separada por comas de archivos o carpetas a incluir en todas las configuraciones que se
construyen. Las vías de acceso relativas son relativas a la característica que las contiene. Utilice "file:" para especificar un archivo y "absolute:" para utilizar una vía de acceso absoluta. Ejemplos:
Cada entrada separada por coma se convierte en un conjunto de archivos. Si la entrada hace referencia a una carpeta, esa carpeta es el parámetro "dir" del conjunto de archivos y se utiliza un "**" como el parámetro "includes". Si la entrada es un archivo, el directorio que contiene el archivo se convierte en el parámetro "dir" y el archivo se especifica en el parámetro "includes". Para todos los archivos relativos, se utilizará la propiedad ${baseDir} en el directorio. Esta propiedad ${baseDir} será el directorio raíz de la característica en la que se ubicará el archivo build.xml generado. |
root.<config> |
Especificar una lista de archivos o carpetas a incluir para la configuración dada. Las configuraciones
especificadas aquí deben corresponderse con las configuraciones de la propiedad configs para la construcción.
Las vías de acceso relativas son relativas a la característica que las contiene. Aquí también se aplican los mismos
prefijos "file:" y "absolute:" utilizados en la propiedad "root". Ejemplos:
|
root.folder.<subcarpeta> root.<config>.folder.<subcarpeta> |
Parecido a las propiedades "root" y "root.<config>", excepto por que
en lugar de copiarse en la raíz de la instalación de eclipse, los archivos y las carpetas se copian en la subcarpeta
dada.
Las vías de acceso relativas son relativas a la característica que las contiene. Aquí también se aplican los mismos prefijos "file:" y "absolute:" utilizados en la propiedad "root". Ejemplos:
|
root.permissions.<derechos> root.<config>.permissions.<derechos> |
Especificar una lista de archivos sobre los que ejecutar la tarea chmod de ant. El valor de esta propiedad se
pasará a la tarea chmod de ante como el parámetro "includes". Esto significa que pueden utilizarse patrones
de comodín de ant. Ejemplos:
La parte <derechos> de la propiedad se pasa realmente a la tarea chmod de ant como el parámetro "perm". Si el formato de archivador final para la configuración es antTar, el formato <derechos> también se pasa a un conjunto de archivos tar de ant como el parámetro"filemode". Lo mismo para zip de ant y conjunto de archivos zip. Mientras que la tarea chmod de ant soporta permisos como por ejemplo "og-rwx" (hacer que los no propietarios no puedan tocar el archivo), los conjuntos de archivos tar y zip sólo soportan series octales de 3 dígitos. |
root.link root.<config>.link |
Lista por pares (separados por comas) los archivos y las carpetas que necesitan enlazarse simbólicamente. La
primera entrada del par es el destino y la segunda entrada es el nombre del enlace. Ejemplo:
Esto resulta en una tarea ejecutable que se ejecuta en un mandato "ln -sf". Dado un valor de "targetA, nameA, targetB, nameB, targetC, nameC", un conjunto de mandatos "ln" se ejecutará en la carpeta en la que se recopilan los archivos raíz de eclipse: ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
Cuando se utiliza un archivo .product basado en características, los archivos raíz pueden añadirse al producto simplemente especificando las propiedades de archivo raíz de más arriba en cualquiera de las características incluidas.
Es posible incluir una característica solamente para aportar archivos raíz. Si esta característica "rootfile" no especifica una propiedad "bin.includes" en el archivo build.properties correspondiente, no se incluirá en los resultados de construcción finales, pero los archivos raíz aportados sí se incluirán.
Cuando un archivo .product está basado en plug-ins en lugar de en características, los archivos raíz todavía pueden añadirse a la construcción. En una construcción de producto, PDE/Construcción genera automáticamente una característica de contenedor que incluye todos los plug-ins especificados en el archivo .product (consulte la tarea eclipse.generateFeature). Hay dos formas de añadir archivos raíz a esta construcción de producto:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*