このタスクは、バイナリー・バンドル内の API ツールが必要とするすべてのファイルの生成を実行します。このタスクは、Eclipse のビルド中、または API ツール・ネーチャーを持つすべてのプロジェクトのためのバンドル・エクスポート中に実行されます。
現時点では、.api_description という名前のファイルのみが作成されます。
Ant タスクの名前は、apitooling.apigeneration です。使用するには、jar ファイル apitooling-ant.jar が Ant クラスパス上になければなりません。
<apitooling.apigeneration
projectname="..."
project="..."
binary="..."
target="..."
debug="..."
/>
| 属性 | 説明 | 必須 |
| projectname | プロジェクト名を設定します。 | はい |
| プロジェクト |
プロジェクトのロケーションを設定します。 これは、指定されたプロジェクトのすべてのソース・ファイルを含むフォルダーです。 ロケーションは、絶対パスを使用して設定します。 |
はい |
| バイナリー |
バイナリーのロケーションを設定します。 これは、指定されたプロジェクトのすべての .class ファイルを含むフォルダーまたは JAR ファイルのリストです。プラットフォームのパス・セパレーターで区切られます。各エントリーが存在しなければなりません。 それらは、絶対パスを使用して指定します。 |
はい |
| target |
ターゲットのロケーションを設定します。 これは、生成ファイルが生成されるフォルダーです。 ロケーションは、絶対パスを使用して設定します。 |
はい |
| デバッグ |
デバッグ値を設定します。
指定可能な値は、 true、false です。デフォルトは false です。
|
いいえ |
| extraManifests |
追加のマニフェスト・ファイルのロケーションを設定します。 これは、スキャン対象の API パッケージをより多く提供するように設定できる、追加の MANIFEST.MF ファイルのロケーションのリストです。プラットフォームのパス・セパレーターで区切られます。各エントリーが存在しなければなりません。 パスが絶対パスではない場合、現行作業ディレクトリーに対する相対パスとして解決されます。 JAR ファイルを MANIFEST.MF ファイルの代わりに指定できます。 JAR ファイルが指定される場合、その MANIFEST.MF ファイル が存在するなら読み取られます。 |
いいえ |
| extraSourceLocations |
追加のソース・ロケーションを設定します。 これは、スキャンされるソース・ファイルのロケーションのリストになります。プラットフォームのパス・セパレーターで区切られます。各エントリーが存在しなければなりません。 それらは、絶対パスを使用して指定します。 |
いいえ |
| allowNonapiproject |
API ツールが使用可能になっていないプロジェクトで、タスクを実行できるようにします。 このタスクが API ツール・ネーチャーを持たないプロジェクトで実行される場合、そのプロジェクトは API ツールをサポートしないと見なされるので api_description ファイルは生成されません。場合によっては、ネーチャーの無いプロジェクトで記述ファイルを生成する必要があります。このパラメーターを true に設定すると、タスクはネーチャーをチェックしません。 |
いいえ |
<apitooling.apigeneration
projectname="org.eclipse.jdt.core_3.5.0.v_927"
project="d:¥eclipse¥org.eclipse.jdt.core"
binary="d:¥eclipse¥org.eclipse.jdt.core¥bin;d:¥eclipse¥org.eclipse.jdt.core¥antbin"
target="d:¥plugins¥org.eclipse.jdt.core"
debug="true"
/>
これは、d:¥eclipse¥org.eclipse.jdt.core に含まれているソースおよび d:¥eclipse¥org.eclipse.jdt.core¥bin に含まれている .class ファイルに基づいて、フォルダー d:¥plugins¥org.eclipse.jdt.core 内に .api_description という名前のファイルを作成します。
分析の Ant タスク
API フリーズの Ant タスク
API 使用の Ant タスク
分析レポート変換の Ant タスク
API フリーズ・レポート変換の Ant タスク
API 非推奨の Ant タスク
API 非推奨レポート変換の Ant タスク
API 使用レポート変換の Ant タスク