Añadir archivos a la raíz de una construcción

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.

Propiedades de archivo raíz

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:
  • root=rootfiles: una vía de acceso relativa a una carpeta, el contenido de la carpeta está incluido
  • root=file:license.html,licenses: una vía de acceso relativa a un archivo "license.html" y una vía de acceso relativa a una carpeta "licenses"
  • root=absolute:/eclipse/rootfiles: una vía de acceso absoluta a una carpeta, el contenido de la carpeta está incluido
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: una vía de acceso absoluta para incluir "about.html" así como una vía de acceso relativa para incluir todos los archivos *.so* bajo la carpeta lib.

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.win32.win32.x86=rootfiles: una vía de acceso relativa a una carpeta, el contenido de la carpeta está incluido en la configuración de win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: una vía de acceso absoluta a un archivo para incluir en la configuración de linux.gtk.x86.
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.folder.docs/html=html_files: el contenido de la carpeta "html_files" de la característica se copia en la carpeta docs/html en la instalación de eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: una vía de acceso absoluta, el contenido de la carpeta /build/jres/linux se copia en la carpeta jre de la instalación de eclipse.
Estas propiedades las utiliza PDE/IU cuando se especifica un JRE en un archivo .product para exportar. PDE/Construcción no soporta actualmente la inclusión de un JRE mediante el archivo .product y estas propiedades deberían especificarse en una característica para incluir un JRE en una construcción de producto autónoma.
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:
  • root.permissions.755=eclipse: establecer que el archivo 'eclipse' tenga permisos de ejecutable.
  • root.linux.gtk.x86.permissions.755=lib/**: establecer que todos los archivos bajo el directorio lib sean ejecutables

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:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: en la configuración macosx.carbon.ppc crea un enlace dinámico en la raíz llamado "eclipse" que señala al archivo "Eclipse.app/Contents/MacOS/eclipse".

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

Incluir archivos raíz en una construcción de producto

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: