Adicionar Ficheiros à Raiz de uma Compilação

Os ficheiros raiz (root) são ficheiros que têm de ser empacotados com uma instalação do Eclipse, mas não são funções ou plug-ins. Os exemplos comuns são o executável de eclipse e ficheiros ini bem como ficheiros de licenciamento.
Os ficheiros raiz (root) são colocados numa compilação por funções que contêm as propriedades raiz adequadas.

Propriedades de ficheiro raiz

raiz
Especifique uma lista com os ficheiros ou as pastas separados por vírgulas a incluir me todas as configurações a construir.
Os caminhos relativos são relativos em relação à função que os contém. Use "file:" para especificar um ficheiro e "absolute:" para usar um caminho absoluto.
Exemplos:
  • root=rootfiles: Um caminho relativo para uma pasta, os conteúdos da pasta estão incluídos
  • root=file:license.html,licenses: Um caminho relativo para um ficheiro "license.html" e um caminho relativo para uma pasta "licenses".
  • root=absolute:/eclipse/rootfiles: Um caminho absoluto para uma pasta, os conteúdos da pasta estão incluídos
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Um caminho absoluto para incluir "about.html", bem como um caminho relativo para incluir todos os ficheiros *.so* sob a pasta lib.

Cada entrada separada por vírgulas torna-se um conjunto de ficheiros ant. Se a entrada se referir a uma pasta, essa pasta representa o parâmetro "dir" do conjunto de ficheiros e é usado um "**" como parâmetro "includes" (inclui). Se a entrada for um ficheiro, o directório que contém o ficheiro torna-se no parâmetro "dir" e o ficheiro é especificado no parâmetro "includes".

Para todos os ficheiros relativos, a propriedade ${baseDir} será usada no directório. Esta propriedade ${baseDir} será o directório raiz da função onde ficará localizado o ficheiro build.xml gerado.

root.<config>
Especifique uma lista de ficheiros ou pastas a incluir na configuração indicada. As configurações aqui especificadas devem corresponder às configurações na propriedade configs para a compilação. Os caminhos relativos são relativos em relação à função que os contém. Os mesmos prefixos "file:" e"absolute:" usados na propriedade "root" também se aplicam aqui.
Exemplos:
  • root.win32.win32.x86=rootfiles: Um caminho relativo para uma pasta, os conteúdos da pasta estão incluídos na configuração win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: Um caminho absoluto para um ficheiro de modo a incluir na configuração linux.gtk.x86.
root.folder.<subfolder>

root.<config>.folder.<subfolder>
Semelhante às propriedades "root" e "root.<config>", à excepção de que, ao invés de ser copiado para a raiz da instalação do eclipse, os ficheiros e as pastas são copiados para a subpasta indicada.
Os caminhos relativos são relativos em relação à função que os contém. Os mesmos prefixos "file:" e "absolute:" usados na propriedade "root" também se aplicam aqui.
Exemplos:
  • root.folder.docs/html=html_files: Os conteúdos da pasta "html_files" de funções são copiados para a pasta docs/html na instalação do eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Um caminho absoluto, os conteúdos da pasta /build/jres/linux são copiados para a pasta jre da instalação do eclipse.
Estas propriedades são usadas pelo PDE/UI quando é especificado um JRE num ficheiro .product para exportação. O PDE/Build não suporta actualmente a inclusão de um JRE com o ficheiro .product e estas propriedades teriam de ser especificadas numa função para inclusão de um JRE numa compilação de produto sem cabeçalho.
root.permissions.<rights>

root.<config>.permissions.<rights>
Especifique uma lista de ficheiros onde executar a tarefa ant chmod. O valor desta propriedade será transmitido à tarefa ant chmod como parâmetro "includes". Significa isto que podem ser usados os padrões de carácter global de ant.
Exemplos:
  • root.permissions.755=eclipse: Defina o ficheiro 'eclipse' para que possa ter permissões executáveis.
  • root.linux.gtk.x86.permissions.755=lib/**: Defina todos os ficheiros sob o directório lib como executáveis.

A parte <rights> da propriedade é actualmente transmitida à tarefa ant chmod como parâmetro "perm". Se o formato de arquivo final para a configuração for antTar, o formato <rights> também é transmitido a um ant tarfileset como parâmetro "filemode". De modo semelhante, o mesmo acontece para antZip e zipfileset. Ao passo que a tarefa ant chmod suporta permissões tais como "og-rwx" (não permitir que os não-proprietários toquem no ficheiro), os conjuntos de ficheiros tar e zip suportam unicamente cadeias octais de 3 dígitos.
root.link

root.<config>.link
Enumera aos pares (separados por vírgulas) os ficheiros e as pastas que necessitam de ser simbolicamente ligados. A primeira entrada do par é o destino e a segunda entrada é o nome da ligação...
Exemplo:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: Na configuração macosx.carbon.ppc cria uma softlink na raiz com o nome "eclipse" que direcciona para o ficheiro "Eclipse.app/Contents/MacOS/eclipse".

Resulta daqui uma tarefa ant exec que executa um comando "ln -sf". Dado um valor de "targetA, nameA, targetB, nameB, targetC, nameC", será executado um conjunto de comandos "ln" na pasta onde são recolhidos os ficheiros raiz do eclipse:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

Incluir Ficheiros Raiz na Compilação de um Produto

Ao usar um ficheiro .product com base em funções, os ficheiros raiz podem ser adicionados ao produtos especificando as propriedades do ficheiro raiz acima indicadas em qualquer uma das funções incluídas.

É possível incluir uma função unicamente com o propósito de contribuir para os ficheiros raiz. Se esta função "rootfile" (ficheiro raiz) não especificar uma propriedade "bin.includes" no respectivo ficheiro build.properties, não será incluída nos resultados finais da compilação, mas serão incluídos os ficheiros raiz contribuídos.

Quando um ficheiro .product é baseado em plug-ins e não em funções, os ficheiros raiz podem também ser adicionados à compilação. Numa compilação de produto, o PDE/Build gera automaticamente uma função de contento que inclui todos os plug-ins especificados no ficheiro .product (Consulte a tarefa eclipse.generateFeature). Existem duas formas de adicionar ficheiros raiz a esta compilação de produto: