Incluindo Arquivos à Raiz de um Build

Os arquivos raiz são arquivos que devem ser ser empacotados com uma instalação do Eclipse, mas não são recursos nem plug-ins. Exemplos comuns são os arquivos executáveis e ini do eclipse, bem como os arquivos de licença.
Os arquivos raiz contribuem com um build com os recursos que contêm as propriedades raiz apropriadas.

Propriedades do arquivo raiz

root
Especifica uma lista separada por vírgulas de arquivos ou pastas a serem incluídos em todas as configurações em build.
Os caminhos relativos são relativos ao recurso contido. Utilize "file" para especificar um arquivo e "absolute:" para utilizar um caminho absoluto.
Exemplos:
  • root=rootfiles: Um caminho relativo para uma pasta, o conteúdo da pasta é incluído
  • root=file:license.html,licenses: Um caminho relativo para um arquivo "license.html" e um caminho relativo para uma pasta de "licenças"
  • root=absolute:/eclipse/rootfiles: Um caminho absoluto para uma pasta, o conteúdo da pasta é incluído
  • 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 arquivos *.so* sob a pasta lib.

Cada entrada separada por vírgulas se torna um conjunto de arquivos ant. Se a entrada se referir a uma pasta, essa pasta será o parâmetro "dir" do conjunto de arquivos, e um "**" será utilizado como o parâmetro "includes". Se a entrada for um arquivo, o diretório contido do arquivo se tornará o parâmetro "dir", e o arquivo será especificado no parâmetro "includes".

Para todos os arquivos relativos, a propriedade ${baseDir} será utilizada no diretório. Essa propriedade ${baseDir} será o diretório raiz do recurso onde o arquivo buil.xml gerado estará localizado.

root.<config>
Especifica uma lista de arquivos ou pastas a serem incluídos para a configuração determinada. As configurações especificadas aqui devem corresponder às configurações na propriedade configs para a pasta. Os caminhos relativos são relativos ao recurso contido. Os mesmos prefixos "file:" e "absolute:" utilizados na propriedade "root" também se aplicam aqui.
Exemplos:
  • root.win32.win32.x86=rootfiles: Um caminho relativo para uma pasta, o conteúdo da pasta é incluído na configuração win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: Um caminho absoluto para um arquivo a ser incluído na configuração linux.gtk.x86.
root.folder.<subfolder>

root.<config>.folder.<subfolder>
Semelhante às propriedades "root" e "root.<config>", exceto pelo fato de serem copiados para a raiz da instalação do eclipse, em vez disso, arquivos e pastas são copiados na subpasta fornecida.
Os caminhos relativos são relativos ao recurso contido. Os mesmos prefixos "file:" e "absolute:" utilizados na propriedade "root" também se aplicam aqui.
Exemplos:
  • root.folder.docs/html=html_files: O conteúdo da pasta"html_files" de recursos é copiado para a pasta docs/html na instalação do eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Um caminho absoluto, o conteúdo da pasta /build/jres/linux é copiado para a pasta jre da instalação do eclipse.
Essas propriedades são utilizadas por PED/UI quando a JER é especificado em um arquivo .product para exportação. PDE/Build não suporta atualmente a inclusão de um JRE utilizando o arquivo .product file, e essas propriedades precisariam ser especificadas em um recurso para incluir um JRE em um build de produto sem periféricos.
root.permissions.<rights>

root.<config>.permissions.<rights>
Especifica uma lista na qual executar a tarefa chmod do ant. O valor dessa propriedade será transmitido à tarefa chmod do ant como o parâmetro "includes". Isso significa que os padrões curinga podem ser usados.
Exemplos:
  • root.permissions.755=eclipse: Configure o arquivo 'eclipse' para que tenha permissões executáveis.
  • root.linux.gtk.x86.permissions.755=lib/**: configure todos os arquivos no diretório lib para que sejam executáveis

A parte <rights> da propriedade é realmente transmitida para a tarefa chmod do ant como parâmetro "perm". Se o formato de archive final para a configuração for antTar, o formato <rights> também será transmitido para um conjunto de arquivos tar do ant como parâmetro "filemode". Da mesma maneira, para um antZip e conjunto de arquivos zip. Embora a tarefa chmod do ant suporte permissões como "og-rwx" (não permite que não proprietários acessem o arquivo), os conjuntos de arquivos tar e zip só suportam cadeias octais de 3 dígitos.
root.link

root.<config>.link
Lista por pares (separados por vírgula) os arquivos e as pastas que precisam ser vinculados simbolicamente. A primeira entrada do par é o destino e a segunda entrada é o nome do link.
Exemplo:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: Na configuração macosx.carbon.ppc, crie um softlink na raiz nomeado"eclipse" que aponta para o arquivo"Eclipse.app/Contents/MacOS/eclipse".

Isso resulta em uma tarefa exec do ant que executa um comando "ln -sf". Dado um valor "targetA, nameA, targetB, nameB, targetC, nameC", um conjunto de comandos "ln" será executado na pasta em que os arquivos raiz do eclipse serão coletados:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

Incluindo Arquivos Raiz em um Build de Produto

Ao utilizar um arquivo .product com base em recursos, os arquivos raiz poderão ser incluídos no produto simplesmente especificando as propriedades do arquivo raiz acima, em qualquer um dos recursos incluídos.

É possível incluir um recurso exclusivamente com o propósito de contribuir com arquivos raiz. Se esse recurso "rootfile" não especificar uma propriedade "bin.includes" em seu arquivo build.properties, ele não será incluído nos resultados do build final, mas seus arquivos raiz contribuídos, sim.

Quando um arquivo .product se baseia nos plug-ins e não nos recursos, os arquivos raiz podem ser incluídos no build. E um build de produto, o PDE/Build gera automaticamente um recurso de contêiner que inclui todos os plug-ins especificados no arquivo .product (Consulte a tarefa eclipse.generateFeature). Há duas maneiras de incluir arquivos raiz nesse build de produto: