Utilizar Qualificadores de Versão

Os agrupamentos e as funções do Eclipse contêm números de versão com o formato major.minor.micro.qualifier. O segmento qualificador da versão é frequentemente utilizado para indicar uma construção específica.  Se definir o seu qualificador de versão da função ou do plug-in como "qualificador" (por exemplo, uma versão de 1.0.0.qualifier), a construção de PDE irá substituir a palavra "qualificador" por um qualificador gerado.

Controlar o Qualificador Gerado

Uma função ou plug-in pode controlar o respectivo qualificador definindo a propriedade "qualificador" no respectivo ficheiro build.properties. Existem alguns casos diferentes para o valor desta propriedade:

qualifier = noneDefine o qualificador como vazio. (por exemplo, "1.2.3.qualifier" torna-se "1.2.3")
qualifier = contextDefine o qualificador para ser o qualificador context. Consulte abaixo o valor do qualificador context.
not setSe a propriedade "qualifier" não estiver definida, é equivalente a definir qualifier = context.
qualifier = v12345Qualquer outro valor define o qualificador para ser esse valor.

O Qualificador de Contexto

O valor do qualificador de contexto gerado é determinado pelo primeiro dos seguintes itens que se aplicarem:
  1. Se a propriedade forceContextQualifier for definida no ficheiro build.properties de configuração do construtor,  o valor desta propriedade é utilizado como o qualificador.  Esta propriedade pode também ser definida na linha de comandos com -D ao invocar o ant.
  2. Se estiver a utilizar ficheiros de correlações para obter agrupamentos a partir de um repositório, o identificador utilizado para obter o agrupamento será utilizado como qualificador.
  3. Se não forem utilizados forceContextQualifier nem ficheiros de correlação, o qualificador será a marca de hora no formato YYYYMMDDHHMM (por exemplo 200605121600)

Sufixos da Versão da Função

Pode ligar a geração de sufixos do qualificador para as funções definindo a propriedade generateFeatureVersionSuffix=true no ficheiro build.properties de configuração da construção.

O objectivo da versão é incrementar cada vez que algo seja alterado. O qualificador de versão incrementa e captura alterações de construção em construção. As funções raramente alteram. Contudo, contêm plug-ins que podem alterar frequentemente. Quando os sufixos de versão são activados, uma versão de função terá a forma de major.minor.micro.qualifier-suffix.  O sufixo é, efectivamente, a soma dos qualificadores de todas as funções e plug-ins incluídos pela função. Isto significa que um dos plug-ins incluídos incrementa a respectiva versão, a versão da função também é incrementada automaticamente. Esta acção é útil quando a função é implementada através de um sítio actualizado.

Versões Finais

Ocasionalmente podem existir passos de construção personalizados que podem necessitar da versão final real utilizada na construção.  Quando a propriedade generateVersionsLists estiver definida, o PDE Build vai gerar ficheiros de propriedades que contenham as versões das funções e dos plug-ins que foram construídos.   Esses ficheiros de propriedades podem ser transferidos utilizando a tarefa da propriedade ant.

Os ficheiros com os nomes: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties e finalFeaturesVersions.properties contêm versões de todos os plug-ins e funções que foram construídos.  Os ficheiros de propriedades <config> contêm as versões dos plug-ins e das funções para configurações específica da construção.

As propriedades nesses ficheiros têm o seguinte formato:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
Se existir mais do que uma versão de plug-in ou função, então <bundleSymbolicName>=<version> refere-se ao plug-in ou função da versão mais elevada. 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