Utilizar calificadores de versión

Los paquetes compuestos y características de Eclipse tienen números de versión, cuyo formato es mayor.menor.micro.calificador.  El segmento calificador de la versión se utiliza con frecuencia para indicar una construcción específica.  Si establece el calificador de versión de la característica o plug-in en qualifier" (es decir, una versión de 1.0.0.qualifier), Construcción PDE sustituirá automáticamente la palabra "qualifier" por un calificador generado.

Controlar el calificador generado

Una característica o plug-in puede controlar su calificador estableciendo la propiedad "qualifier" en su archivo build.properties. Hay un par de casos distintos para el valor de esta propiedad:

qualifier = noneEstablece el calificador como vacío. (Es decir, "1.2.3.qualifier" pasa a ser "1.2.3")
qualifier = contextEstablece el calificador como el calificador de contexto. Consulte el valor del calificador de contexto más abajo.
no establecidoSi no se establece la propiedad "qualifier", será equivalente a establecer qualifier = context.
qualifier = v12345Cualquier otro valor establece el calificador con ese valor.

El calificador de contexto

El valor del calificador de contexto generado está determinado por el primero de los siguientes elementos que se aplique:
  1. Si la propiedad forceContextQualifier está establecida en el archivo builder.propertiesde configuración del constructor,  el valor de esta propiedad se utilizará como calificador.  Esta propiedad también puede establecerse en la línea de mandatos con la opción -D al invocar ant.
  2. Si se utilizan archivos de correlación para extraer los paquetes compuestos de un repositorio, el código utilizado para extraer el paquete compuesto se utilizará como calificador.
  3. Si no se ha utilizado forceContextQualifier ni archivos de correlación, el calificador será una indicación de la hora en el formato AAAAMMDDHHMM (por ejemplo, 200605121600)

Sufijos de versión de característica

Puede activar la generación de sufijos de calificador para las características estableciendo la propiedad generateFeatureVersionSuffix=true en el archivo build.properties de configuración de la construcción.

La idea de una versión es que, cada vez que se realizan cambios, el calificador de versión aumenta y captura los cambios de una construcción a otra.  Las características raramente cambian, pero sí contienen plug-ins que pueden cambiar con frecuencia.  Si se activan los sufijos de versión, una versión de característica tendrá el formato mayor.menor.micro.sufijo-calificador.   El sufijo es en realidad la suma de los calificadores de versión de todas las características y plug-ins incluidos en la característica.  Esto significa que, cuando uno de los plug-ins incluidos incremente su versión, se incrementará también automáticamente la versión de la característica.  Esto es especialmente útil cuando la característica se despliega por medio de un sitio de actualizaciones.

Versiones finales

Puede haber pasos de construcción personalizados que necesiten la versión final real utilizada en la construcción.  Cuando se establece la propiedad generateVersionsLists, Construcción PDE generará archivos de propiedades que contengan las versiones de las características y los plug-ins construidos.  Estos archivos de propiedades pueden cargarse mediante la tarea de propiedades ant.

Los archivos se llaman: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties y   finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties y finalFeaturesVersions.properties contienen las versiones de todos los plug-ins y las características construidos.  Los archivos de propiedades <config> contienen las versiones de los plug-ins y las características para configuraciones de construcción específicas.

Las propiedades de estos archivos tienen el formato siguiente:

    <nombreSimbólicoPaquete> = <versión>
    <nombreSimbólicoPaquete>_<primeros 3 segmentos de versión> = <versión>
Si hay más de una versión de un plug-in o una características, <nombreSimbólicoPaquete>=<versión> hace referencia al plug-in o la característica con la versión más alta. Ejemplo:
    org.eclipse.pde.build = 3.3.0.v20070524
    org.eclipse.pde.build_3.3.0=3.3.0.v20070524
    org.eclipse.pde.build_3.2.1=3.2.1.r321_v20060823