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.
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:
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.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.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:
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:
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 |
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:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*