ネイティブ・イメージのホスト型オプションと実行時オプション

ネイティブ・イメージでは、オプション・ガイドにリストされているすべてのオプションに加えて、ホスト型オプションと実行時オプションも区別されています。

• ホスト型オプション: ネイティブ・イメージ・ビルドを構成します。つまり、イメージに配置される内容とイメージのビルド方法に影響します。これらは、コマンドラインで接頭辞-H:を使用して設定します。

• 実行時オプション: イメージの生成時に、ネイティブ・イメージ・ビルダーのコマンドラインで接頭辞-R:を使用して初期値を取得します。実行時のデフォルトの接頭辞は-XX:です(ただし、これはアプリケーション固有であり、ネイティブ・イメージでは必須ではありません)。

オプションの定義方法および使用方法に関する開発者向けドキュメントは、com.oracle.svm.core.optionパッケージのドキュメントを参照してください。

有用なオプションのリスト

グラフのダンプ

ネイティブ・イメージでは、GraalVMデバッグ環境におけるグラフのダンプ、ロギング、カウンタおよびその他すべてにGraalVMオプションが再利用されています。これらのGraalVMオプションは、ホスト型オプションとて使用することも(ネイティブ・イメージ・ビルダーのグラフをダンプする場合)、実行時オプションとして使用することもできます(実行時の動的コンパイル時にグラフをダンプする場合)。

想定どおりに動作するGraalコンパイラ・オプションとしては、Dump、DumpOnError、Log、MethodFilter、およびダンプ・ハンドラのファイル名とポートを指定するオプションがあります。

たとえば:

• ネイティブ・イメージ・ビルダーのコンパイラ・グラフをダンプするには、-H:Dump= -H:MethodFilter=ClassName.MethodNameのように指定します。

• 実行時にコンパイル・グラフをダンプするには、実行時に-XX:Dump= -XX:MethodFilter=ClassName.MethodNameのようにダンプ・フラグを指定します。

デバッグ・オプション

これらのオプションを使用すると、生成された実行可能ファイルの追加チェックが有効になり、デバッグに役立ちます:

• -H:[+|-]HostedAssertionsを使用すると、ネイティブ・イメージ・ビルダーでJavaアサート文が有効または無効になります。このフラグは、HotSpot VMの-ea -esaまたは-da -dsaに変換されます。
• -H:[+|-]RuntimeAssertionsを使用すると、実行時にJavaアサート文が有効または無効になります。
• -H:TempDirectory=FileSystemPathを使用すると、ネイティブ・イメージの生成時に一時ファイルのディレクトリが生成されます。このオプションを指定した場合は、ネイティブ・イメージの生成後に検査できるように一時ファイルは削除されません。

メイン・エントリ・ポイントの制御

• -H:Kind=[EXECUTABLE | SHARED_LIBRARY]: メイン・エントリ・ポイントを含む実行可能ファイルを生成するか、@CEntryPointでマークされたすべてのエントリ・ポイントを含む共有ライブラリを生成します。
• -H:Class=ClassName: デフォルトのエントリ・ポイント・メソッドを含むクラスです。Kind == SHARED_LIBRARYの場合は無視されます。
• -H:Projects=Project1,Project2: アプリケーションを含むプロジェクト(および一時的にそれが依存するすべてのプロジェクト)です。
• -H:Name=FileName: 生成される実行可能ファイルの名前です。
• -H:Path=FileSystemPath: 生成された実行可能ファイルが配置されるディレクトリです。