Extraer de repositorios

La infraestructura ofrecida por la Construcción PDE proporciona pasos para extraer el código fuente y los plug-ins preconstruidos a partir de un repositorio como parte del proceso de construcción (consulte la tarea eclipse.fetch y las propiedades para controlar la extracción). Hay dos posibilidades disponibles: dejar que la construcción PDE extraiga automáticamente el código fuente o extraerlo manualmente.

Primer paso para la automatización, el archivo de correlación

Dado el identificador de una característica o un plug-in que debe construirse, la infraestructura de construcción es capaz de extraer de un repositorio todas las características y plug-ins incluidos.

Para saber de dónde debe extraer los elementos, el PDE utiliza archivos de correlación. Un archivo de correlación es un archivo de propiedades java que correlaciona ID de característica y plug-in con una ubicación y un código de un repositorio. El formato de los archivos de correlación está abierto pero la parte de clave está fijada por la Construcción PDE:

<tipoElemento>@<IDElemento>[,<versiónElemento>] = <contenidoEspecíficoRepositorio>

donde tipoElemento puede ser bundle, feature, plugin o fragment e IDElemento y versiónElemento especifican el elemento.

Entrada de archivo de correlación para CVS

El formato de una entrada de archivo de correlación para extraer contenido de CVS es el siguiente:
<clave> = CVS, [,args]
donde args es una lista de pares clave/valor separados por comas que se describen a continuación: Ejemplo:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Entradas de correlación de estilo antiguo
En Eclipse 3.2 y versiones anteriores, el formato de archivo de correlación para CVS era:
<tipoElemento>@<IDElemento> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Si no se especifica ninguno de los argumentos opcionales, las comas siguen siendo necesarias para delimitar los argumentos siguientes. Este formato debe considerarse en desuso, prefiriéndose el formato clave/valor.

Entrada de archivo de correlación para GET de Ant

El formato de una entrada de archivo de correlación de cualquier URL soportado por GET de Ant es el siguiente:

<clave> = GET, <url> [,args]
donde url es el url del que recuperar los datos y args es una lista opcional de pares de clave/valor separados por comas que se describen a continuación: Ejemplo:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Entrada de archivo de correlación para una extracción p2

Se ha añadido una ampliación nueva a la construcción de PDE que permite a los usuarios extraer artefactos de repositorios de p2. Ahora puede añadir una entrada en el archivo de correlación para la entrada de construcción y la construcción de PDE recuperará el artefacto y lo incluirá en la construcción. La entrada de archivo de correlación debe incluir el id y la versión de la unidad instalable y el URI del repositorio en el que se puede encontrar la unidad instalable. Se supone que Los metadatos y los repositorios de artefacto están coubicados.

El formato de una entrada de archivo de correlación para extraer contenido mediante p2 es el siguiente:

<elementType>@<IDdeElemento> = p2IU, id=<ID>, version=<versión>, repository=<repositorio>
Captar características con p2

En el release de Helios, las características se pueden captar con p2 especificando la unidad instalable que representa el jar de característica. Consulte la página de metadatos de característica para conocer los detalles sobre la estructura de metadatos de p2 para características.

Ejemplos:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Entrada de archivo de correlación para otros repositorios

La construcción PDE suministra un punto de extensión al que pueden conectarse generadores de scripts de extracción para diversos repositorios. Si la instalación de Eclipse contiene un paquete compuesto que suministra una ampliación de generador de scripts para un tipo de repositorio diferente, puede utilizar ese repositorio especificándolo en las entradas de archivo de correlación.

Configurar la extracción de código fuente de CVS

Para configurar la extracción del código fuente de CVS, debe hacer lo siguiente:

Obtener los archivos de correlación de CVS

Los archivos de correlación se almacenan generalmente en un repositorio. La construcción PDE ofrece una infraestructura predeterminada para obtener dichos archivos de correlación de un repositorio CVS. Para habilitar esta función, cambie las siguientes propiedades en el archivo build.properties de la configuración desde el directorio de configuración: la extracción de los archivos de correlación de CVS se produce durante la fase de preconstrucción de la construcción.  Los scripts destinados a extraer todas las características y plug-ins incluidos en la característica que se construye se generarán y ejecutarán durante la fase de extracción de la construcción. 

Extracción automática de otros repositorios

Si  está extrayendo de forma automática los archivos de correlación del repositorio, deberá copiar el archivo customTarget.xml de org.eclipse.pde.build/templates/headless-build en el directorio de configuración.  El destino  getMapFiles se utiliza para extraer los archivos de correlación, y debe modificarse para extraer del repositorio.

Obtener código fuente manualmente

Puede escribir destinos de extracción personalizados para recuperar los plug-ins y características que pueden invocarse desde los destinos preSetup o postSetup del archivo customTargets.xml.  Las características y plug-ins deben extraerse en ${buildDirectory}/features y ${buildDirectory}/plugins, respectivamente.