ネイティブ・イメージ・ビルドの概要

native-imageコマンドの構文は次のとおりです:

• native-image [options] <mainclass> [imagename] [options]: 現在の作業ディレクトリのメイン・クラスからネイティブ・バイナリをビルドします。クラス・パスは、必要に応じて-cp <classpath>オプションで指定でき、この<classpath>は、ディレクトリとJARファイルへのパスをコロン(Windowsではセミコロン)で区切ったリストです。
• native-image [options] -jar jarfile [imagename] [options]: JARファイルからネイティブ・バイナリをビルドします。
• native-image [options] -m <module>/<mainClass> [imagename] [options]: Javaモジュールからネイティブ・バイナリをビルドします。

native-imageに渡されるオプションは、左から右に評価されます。native-imageに渡すことができるオプションの概要は、ここを参照してください。

ビルド・プロセスの完了時の通知の受信

アプリケーションのサイズおよびビルド・マシンで使用可能なリソースによっては、Javaアプリケーションをネイティブ実行可能ファイルにコンパイルするのに数分かかる場合があります。アプリケーションをバックグラウンドでビルドする場合は、ビルド・プロセスの完了時に通知するコマンドを使用することを検討してください。次に、オペレーティング・システムごとにコマンドの例を示します:

Linux

# Ring the terminal bell
native-image -jar App.jar ... ; printf '\a'

# Use libnotify to create a desktop notification
native-image -jar App.jar ... ; notify-send "GraalVM Native Image build completed with exit code $?"

# Use Zenity to open an info dialog box with text
native-image -jar App.jar ... ; zenity --info --text="GraalVM Native Image build completed with exit code $?"

macOS

# Ring the terminal bell
native-image -jar App.jar ... ; printf '\a'

# Use Speech Synthesis
native-image -jar App.jar ... ; say "GraalVM Native Image build completed"

Windows

# Ring the terminal bell (press Ctrl+G to enter ^G)
native-image.exe -jar App.jar & echo ^G

# Open an info dialog box with text
native-image.exe -jar App.jar & msg "%username%" GraalVM Native Image build completed

その他の情報

GraalVMネイティブ・イメージを初めて使用する場合や、使用経験がほとんどない場合は、ネイティブ・イメージの基本を参照して、いくつかの重要な側面をよく理解してから先に進んでください。

その他の微調整およびnative-imageツールを適切に構成する方法は、ビルド構成を参照してください。

ネイティブ・イメージでは、ネイティブ・バイナリのビルド時に、進行状況および様々な統計が出力されます。出力および様々なビルド・フェーズについてさらに学習するには、ビルド出力を参照してください。

ビルド・プロセス、そのフェーズおよび生成されたネイティブ・バイナリの内容の詳細は、ビルド・レポートを参照してください。