ビルドのルートへのファイルの追加

ルート・ファイルは、Eclipse インストールと共にパッケージされていなければならないファイルですが、フィーチャーやプラグインではありません。一般的な例としては、eclipse 実行可能ファイル、ini ファイル、およびライセンス交付ファイルがあります。
ルート・ファイルは、 該当するルート・プロパティーを含むフィーチャーによって、ビルドにコントリビュートされます。

ルート・ファイル・プロパティー

root
ビルドされているすべての構成にインクルードされるファイルまたはフォルダーの、コンマ区切りのリストを指定します。
相対パスは、収容するフィーチャーを起点とします。ファイルを指定する場合は「file:」を、 絶対パスを使用する場合は「absolute:」を使用します。
例:
  • root=rootfiles: フォルダーへの相対パス。フォルダーのコンテンツがインクルードされます。
  • root=file:license.html,licenses: 「license.html」ファイルへの相対パスと、「 licenses」フォルダーへの相対パス。
  • root=absolute:/eclipse/rootfiles: フォルダーへの絶対パス。フォルダーのコンテンツがインクルードされます。
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: 「about.html」をインクルードする絶対パスと、lib フォルダー下のすべて の *.so* ファイルをインクルードする相対パス。

コンマで区切られた各エントリーは、Ant ファイル・セットになります。エントリーがフォルダーを参照する場合、そのフォルダーがファイル・セットの「dir」パラメーターとなり、「**」が 「includes」パラメーターとして使用されます。エントリーがファイルの場合、 そのファイルを含んでいるディレクトリーが「dir」パラメーターとなり、ファイルは 「includes」パラメーターで指定されます。

すべての相対ファイルについて、${baseDir} プロパティーがディレクトリーで使用されます。この ${baseDir} プロパティーはフィーチャーのルート・ディレクトリーとなり、そこに成された build.xml ファイルが配置されます。

root.<config>
特定の構成についてインクルードされるファイルまたはフォルダーのリストを指定します。ここで指定される構成は、ビルドの configs プロパティーの構成に対応している必要があります。 相対パスは、収容するフィーチャーを起点とします。「root」 プロパティーで使用される「file:」および「absolute:」接頭部が、ここでも適用されます。
例:
  • root.win32.win32.x86=rootfiles: フォルダーへの相対パス。 フォルダーのコンテンツが win32.win32.x86 構成にインクルードされます。
  • root.linux.gtk.x86=absolute:file:about.html: linux.gtk.x86 構成にインクルードするファイルへの絶対パス。
root.folder.<subfolder>

root.<config>.folder.<subfolder>
「root」プロパティーおよび「root.<config>」プロパティーと同様です。 ただし、ファイルおよびフォルダーが、Eclipse インストールのルートにコピーされるのではなく、特定のサブフォルダーにコピーされる点が異なります。
相対パスは、収容するフィーチャーを起点とします。「root」プロパティーで使用 される「file:」および「absolute:」接頭部が、ここでも適用されます。
例:
  • root.folder.docs/html=html_files: フィーチャーの 「html_files」フォルダーのコンテンツが、Eclipse インストールの docs/html フォルダーにコピーされます。
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: 絶対パス。/build/jres/linux フォルダーのコンテンツが、Eclipse インストールの JRE フォルダーにコピーされます。
エクスポートの際に JRE が .product ファイルで指定された場合、これらのプロパティーが PDE/UI によって使用されます。現在 PDE/ビルドは、.product ファイルを使用 した JRE のインクルードをサポートしていません。また、ヘッドレス製品ビルドに JRE をインクルードするには、これらのプロパティーをフィーチャーで指定する必要があります。
root.permissions.<rights>

root.<config>.permissions.<rights>
Ant Chmod タスクを実行するファイルのリストを指定します。このプロパティー の値は、「includes」パラメーターとして Ant Chmod タスクに渡されます。つまり 、Ant ワイルドカード・パターンを使用することができます。
例:
  • root.permissions.755=eclipse: 実行可能許可を持つ ように「eclipse」ファイルを設定します。
  • root.linux.gtk.x86.permissions.755=lib/**: lib ディレクトリー下のすべてのファイルを実行可能に設定します。

プロパティーの <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 番目のエントリーがリンクの名前です。
例:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: macosx.carbon.ppc 構成で、「eclipse」という名前のルートに、 「Eclipse.app/Contents/MacOS/eclipse」ファイルを指すソフト・リンクを作成します。

これは、「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 つの方法があります。