ルート・ファイルは、Eclipse インストールと共にパッケージされていなければならないファイルですが、フィーチャーやプラグインではありません。一般的な例としては、eclipse 実行可能ファイル、ini ファイル、およびライセンス交付ファイルがあります。
ルート・ファイルは、
該当するルート・プロパティーを含むフィーチャーによって、ビルドにコントリビュートされます。
root |
ビルドされているすべての構成にインクルードされるファイルまたはフォルダーの、コンマ区切りのリストを指定します。 相対パスは、収容するフィーチャーを起点とします。ファイルを指定する場合は「file:」を、 絶対パスを使用する場合は「absolute:」を使用します。 例:
コンマで区切られた各エントリーは、Ant ファイル・セットになります。エントリーがフォルダーを参照する場合、そのフォルダーがファイル・セットの「dir」パラメーターとなり、「**」が 「includes」パラメーターとして使用されます。エントリーがファイルの場合、 そのファイルを含んでいるディレクトリーが「dir」パラメーターとなり、ファイルは 「includes」パラメーターで指定されます。 すべての相対ファイルについて、${baseDir} プロパティーがディレクトリーで使用されます。この ${baseDir} プロパティーはフィーチャーのルート・ディレクトリーとなり、そこに成された build.xml ファイルが配置されます。 |
root.<config> |
特定の構成についてインクルードされるファイルまたはフォルダーのリストを指定します。ここで指定される構成は、ビルドの configs プロパティーの構成に対応している必要があります。
相対パスは、収容するフィーチャーを起点とします。「root」
プロパティーで使用される「file:」および「absolute:」接頭部が、ここでも適用されます。 例:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
「root」プロパティーおよび「root.<config>」プロパティーと同様です。
ただし、ファイルおよびフォルダーが、Eclipse インストールのルートにコピーされるのではなく、特定のサブフォルダーにコピーされる点が異なります。
相対パスは、収容するフィーチャーを起点とします。「root」プロパティーで使用 される「file:」および「absolute:」接頭部が、ここでも適用されます。 例:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Ant Chmod タスクを実行するファイルのリストを指定します。このプロパティー
の値は、「includes」パラメーターとして Ant Chmod タスクに渡されます。つまり
、Ant ワイルドカード・パターンを使用することができます。 例:
プロパティーの <rights> の部分は、実際には「perm」パラメーターとして Ant Chmod タスクに渡されます。構成の最終アーカイブ・フォーマット が antTar である場合は、<rights> フォーマットも「filemode」パラメーターとして Ant TAR ファイル・セットに渡されます。antZip および zipfileset の場合も同様です。Ant Chmod タスクが「og-rwx」のようなアクセス権 (非所有者をファイルにアクセスできないようにする) をサポートするのに対し、TAR および ZIP ファイル・セットは、3 桁の 8 進数ストリングのみをサポートします。 |
root.link root.<config>.link |
シンボリックにリンクされる必要のあるファイルとフォルダーのペア
(コンマで区切ります) をリストします。ペアの最初のエントリーがターゲットで、2 番目のエントリーがリンクの名前です。 例:
これは、「ln -sf」コマンドを実行する Ant exec タスクとなります。 「targetA、nameA、targetB、nameB、targetC、nameC」という値を与えると、以下のように、一連の「In」コマンドが、eclipse ルート・ファイルが収集されるフォルダーで実行されます。 ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
フィーチャーに基づいて .product ファイルを使用する場合、インクルードされるフィーチャーのいずれかで上記のルート・ ファイル・プロパティーを指定すること により、簡単にルート・ファイルを製品に追加することができます。
ルート・ファイルをコントリビュートする目的だけのために、フィーチャーをインクルードすることができます。この「rootfile」フィーチャーが その build.properties ファイルで「bin.includes」プロパティーを指定していない場合、フィーチャーはビルドの最終結果にインクルードされませんが、そのコントリビュートされたルート・ファイルはインクルードされます。
.product ファイルがフィーチャーではなくプラグインに基づく場合でも、 ルート・ファイルをビルドに追加することができます。製品ビルドで、PDE/ビルドは 、.product ファイルで指定されたすべてのプラグインをインクルードするコンテナー・フィーチャーを自動的に生成します (『eclipse.generateFeature』タスク を参照してください)。ルート・ファイルをこの製品ビルドに追加するには、以下の 2 つの方法があります。
${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/*