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

native-imageコマンドの構文は

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

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を初めて使用する場合、または使用経験が少ない場合は、ネイティブイメージの基礎を参照して、さらに進む前に重要な側面を理解してください。

native-imageツールを適切に設定する方法の詳細については、ビルド設定を参照してください。

ネイティブイメージは、ネイティブバイナリをビルドするときに、進行状況とさまざまな統計を出力します。出力とさまざまなビルドフェーズの詳細については、ビルド出力を参照してください。

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