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:
donde args es una lista de pares clave/valor separados por comas que se describen a continuación:
- tag, el código CVS a reservar;
- cvsRoot, una serie de conexión de CVS;
- path, un módulo CVS opcional y una vía de acceso en la que obtener la carpeta que contiene el elemento. De forma predeterminada, el nombre del elemento se utiliza como nombre de módulo;
- prebuilt, un booleano opcional que indica si el elemento descargado se ha construido previamente. El valor predeterminado de esto es false;
- cvsPassFile, una vía de acceso de opción a un archivo de paso de cvs;
- password, una contraseña opcional a utilizar para conectarse a CVS;
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:
- unpack, establecido en true indica que debe desenziparse el elemento descargado;
- verbose, establecido en true muestra la información de progreso de forma verbosa al descargar. El valor predeterminado es false;
- ignoreerrors, establecido en true anota errores durante el transporte. El valor predeterminado es false;
- usetimestamp, descargar condicionalmente un archivo basado en la indicación de la hora de la copia local
(sólo para los URL de http) cuando se establece en true. El valor predeterminado es false;
- username, el nombre de usuario para la autenticación http "BASIC";
- password, la contraseña para realizar la descarga.
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
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>
- id, el identificador de la Unidad instalable;
- versión, la versión de la Unidad (opcional). Si no se especifica, se captará la versión más alta disponible.
- repositorio, la ubicación (URI) del repositorio donde se encontrará la Unidad instalable.
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:
- 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 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
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.