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.
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:
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.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.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:
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:
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 |
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:
${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/*