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:
- Asegúrese de tener un archivo cvs.exe en la vía de búsqueda del sistema.
(Descargue CVS desde aquí).
- Cree una carpeta denominada maps en el directorio de construcción.
- Cree un archivo con la extensión .map en la carpeta maps.
- Rellene este archivo map (correlación) con todos los elementos que deban extraerse
de un
repositorio.
- Edite el archivos build.properties de la carpeta de configuración y comente la
línea skipFetch=true. Si dicha propiedad está establecida, la construcción
PDE pasará por alto toda la fase de extracción. Si desea que que se pase por alto
el código especificado en los archivos map, puede establecer la propiedad
fetchTag en un valor específico. Esto resulta de utilidad al realizar una
construcción nocturna desde HEAD en lugar de hacerlo desde las versiones codificadas.
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:
- skipMaps: comente esta propiedad.
Si esta propiedad está establecida, la construcción PDE no extraerá los archivos de
correlación.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. El repositorio CVS desde el que deben
obtenerse los archivos de correlación.
- mapsRoot =
/path/to/maps. La vía de acceso del repositorio CVS al directorio que contiene los
archivos de correlación.
- mapsCheckoutTag =
HEAD. El código CVS que debe utilizarse para reservar los archivos de correlació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.