コンパイラー・オプション
PDE/ビルドは、個々のプラグインのコンパイラーを制御するいくつかのオプションをサポートしています。ソースとターゲット・レベルおよび bootclasspath に関連した設定に関しては、コンパイル環境の設定 を参照してください。
警告およびエラー
PDE/ビルドでは、build.properties ファイルにカスタム・コンパイル警告およびエラーを指定できます。これらは、ライブラリー・ベース (単一のプラグインに複数の jar ライブラリーを含めることが可能) でそれぞれに、javacWarnings.<library> および javacErrors.<library> オプションにより設定できます。
これらのプロパティーの値は、「バッチ・コンパイラーの使用」 ページ (「Java 開発ユーザー・ガイド」からアクセスする) の『-warn:...』セクションに記載されています。
例:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
プロジェクト設定からの警告およびエラー
JDT プロジェクト設定も PDE/ビルドで使用できるようになりました。PDE/ビルド自体は、設定ファイルを読み取ることはできませんが、それらのファイルを理解できる JDT コンパイラーに渡すことはできます。
これを使用するには、プラグインが javacProjectSettings プロパティーを自分の build.properties ファイルで指定しておく必要があります。その値は、以下のとおりです。
- javacProjectSettings=true : デフォルトの .settings/org.eclipse.jdt.core.prefs 設定ファイルで指定されているプロジェクト設定を使用。
- javacProjectSettings=path/to/jdt.prefs : 指定された設定ファイルを使用。
プロジェクトによっては、releng ビルドと比べて異なる警告とエラーの設定をワークスペースで使用できます。この方法は、"javacWarnings.<library>" プロパティーに比べて、これらの設定値を指定するための便利な設定方法と言えます。
ファイル・エンコード
PDE/ビルドは、ライブラリー、フォルダーまたはファイル・ベースで、それぞれにカスタム・ファイル・エンコードを受け入れられます。
- javacDefaultEncoding.<library>
- 所定のライブラリーをコンパイルする際に使用するデフォルト・エンコードを設定します。
- javacCustomEncodings.<library>
- 所定のライブラリーをコンパイルする際に使用するパスおよびエンコードのコンマ区切りのリストです。
フォルダーを指定すると、そのフォルダーに含まれているすべてのものに関してこのエンコードが使用されます。ファイルを指定すると、そのファイルに関してだけこのエンコードが使用されます。 例:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
カスタム・コンパイラー引数
カスタム・コンパイラー引数を、バンドルの build.properties ファイルの compilerArg プロパティーを使用して、バンドルごとに指定できるようになりました。このプロパティーは、すべてのプラグインではなく単一のプラグインだけに影響することを除けば、ビルダー構成の compilerArg プロパティーと同じです。具体的な引数は、使用するコンパイラーによって異なります。
JDT コンパイラー引数のリストは、ここにあります。
コンパイラー・オプションの優先順位
異なるコンパイラー・オプションを指定する多くの方法があります。一般的な規則として、オプションの優先順位は次のようなものです。
- javacDefaultEncoding.<library> は、カスタム -encoding コマンド行オプションよりも優先されます。
- 汎用オプションについては、コンパイラー・コマンド行で後ろに出てくるオプションは前で指定されたオプションをオーバーライドします。オプションは、次の順序で JDT に提供されます。
- ビルダー構成からの compilerArg プロパティー。(すべてのバンドルに影響)。
- このプラグインの build.properties からの compilerArg プロパティー。
- javacProjectSettings で指定されているコンパイラー設定ファイル。
- ファイル・エンコード、javacWarnings、javacErrors およびアクセス規則を含む、生成されるコンパイラー引数ファイル (javaCompiler.<library>.args)。
カスタム・コンパイラーの使用
バンドルは、compilerAdapter プロパティーを設定することにより、カスタム・コンパイラーを使用できるようになりました。指定されたコンパイラー・アダプターが、Ant 環境で使用可能になっていなければなりません。デフォルトで使用される JDT コンパイラー・アダプターは、org.eclipse.jdt.core.JDTCompilerAdapter です。代替コンパイラーを指定する特別の理由の 1 つに、Aspect J または Groovy バンドル用であるということがあります。
カスタム・コンパイラー・アダプターを指定するバンドルは、次のプロパティーのいくつかも指定しなければならない可能性があります。
- sourceFileExtensions : 考慮するべきソースの拡張子のリスト。(例えば、*.java、*.aj、*.groovy)。
- compilerAdapter.useLog : "-log" 引数をコンパイラーに渡すかどうか
- compilerAdapter.useArgFile : 生成される javaCompiler.<library>.args 引数ファイルをコンパイラーに渡すかどうか。(そのファイルには、アクセス規則、ファイル・エンコードおよび警告/エラー・レベルが含まれます)。