Utilizando Qualificadores de Versão

Os pacotes configuráveis e recursos do Eclipse possuem números de formato no formato maior.menor.micro.qualificador.  O segmento de qualificador da versão é geralmente utilizado para indicar um build específico.  Se você definir o qualificador de versão do recurso ou plug-in como "qualifier" (ou seja, uma versão de 1.0.0.qualifier), então a construção do PDE substituirá automaticamente a palavra "qualifier" por um qualificador gerado.

Controlando o Qualificador Gerado

Um recurso ou plug-in pode controlar seu qualificador definindo a propriedade "qualifier" em seu arquivo build.properties. Existem alguns casos diferentes para o valor desta propriedade:

qualifier = noneDefine o qualificador como vazio. (ou seja, "1.2.3.qualifier" se torna "1.2.3")
qualifier = contextDefine o qualificador como o qualificador de contexto. Consulte abaixo o valor do qualidador de contexto.
not setSe a propriedade "qualifier" não estiver definida, isso será equivalente a definir qualifier = context.
qualifier = v12345Qualquer outro valor define o qualificador como representante desse valor.

Qualificador de Contexto

O valor do qualificador de contexto gerado é determinado pelo primeiro dos seguintes itens que se aplicam:
  1. Se a propriedade forceContextQualifier estiver definida no arquivo build.properties de configuração da construção,  então o valor dessa propriedade será usado como o qualificador.  Essa propriedade também pode ser configurada na linha de comandos com -D ao chamar ant.
  2. Se você estiver utilizando arquivos de mapeamento para buscar seus pacotes configuráveis de um repositório, a tag que foi utilizada para buscar o pacote configurável será utilizada como o qualificador.
  3. Se nem forceContextQualifier nem os arquivos de mapeamento forem usados, então o qualificador será um registro de data e hora no formato YYYYMMDDHHMM (ou seja, 200605121600)

Sufixos de Versão do Recurso

Você pode ativar a geração de sufixos do qualificador para recursos, configurando a propriedade generateFeatureVersionSuffix=true no arquivo de configuração de construção build.properties.

O conceito de uma versão é que ela deve ser incrementada toda vez que algo é alterado; o qualificador de versão incrementa e captura alterações de build para build.  Os recursos raramente são alterados, entretanto, eles contêm plug-ins que podem ser alterados com frequência.  Quando os sufixos de versão forem ativados, uma versão de recurso terá o formato maior.menor.micro.qualificador-sufixo.   O sufixo é, na realidade, a soma dos qualificadores de versão de todos os recursos e plug-ins incluídos pelo recurso.  Isso significa que quando um dos plug-ins incluídos incrementa sua versão, a versão do recurso também é incrementada automaticamente.  Isso é particularmente útil quando o recurso é implementado por meio de um site de atualização.

Versões Finais

Ocasionalmente, pode haver etapas de construção customizadas que exijam a versão final real utilizada na construção.  Quando a propriedade generateVersionsLists estiver definida, o PDE Build gerará arquivos de propriedades que contenham as versões dos recursos e dos plug-ins que foram construídos. Esses arquivos de propriedades podem ser carregados utilizando a tarefa de propriedade ant.

Os arquivos são chamados: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties e  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties e finalFeaturesVersions.properties contêm as versões para todos os plug-ins e recursos que foram construídos. Os arquivos de propriedades <config> contêm as versões de plug-ins e recursos para configurações específicas de construção.

As propriedades desses arquivos têm o formato:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
Se existir mais de uma versão de um plug-in ou recurso, então <bundleSymbolicName>=<version> fará referência ao plug-in ou recurso com a versão mais alta. Exemplo:
    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