Extraer de repositorios

La infraestructura ofrecida por la Construcción PDE suministra pasos para extraer el código fuente de construcción de un repositorio como parte del proceso de construcción. Hay dos posibilidades disponibles: dejar que la construcción PDE extraiga automáticamente el código fuente o extraerlo manualmente.

Extracción automatizada de código fuente de CVS

Dado el identificador de una característica que debe construirse, la infraestructura de construcción es capaz de extraer de CVS 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 una entrada de archivo de correlación para la extracción de CVS es:

<tipoElemento>@<IDelemento> = CVS, <CÓDIGO>,
<RAÍZCVS>[,<CONTRASEÑA>[,<VÍA_ACCESO>[,<ARCHIVO_PASO_CVS>]]]

donde tipoElemento es bundle, feature, plug-in o fragment.  Si no se especifica la vía de acceso, se utilizará el nombre de elemento como módulo CVS, por ejemplo: 

plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.example.org:/cvsroot/foo

extraerá el plug-in org.foo.bar que se ha etiquetado con el código v20060501 de cvs.eclipse.org/cvsroot/foo/org.foo.bar

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

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 extensió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.  

<elementType>@<elementID> = <DEPÓSITO>, <CÓDIGO>, [...] 

El formato de la entrada de correlación después del CÓDIGO dependerá de la extensión.

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.