ネイティブ実行可能ファイルへのJavaモジュールのビルド
GraalVMネイティブ・イメージは、Java 9で導入されたJavaプラットフォーム・モジュール・システムをサポートしています。つまり、モジュール化されたJavaアプリケーションをネイティブ実行可能ファイルに変換できます。
native-image
ツールは、--module
(-m
)、--module-path
(-p
)、--add-opens
、--add-exports
などのモジュール関連の引数を受け入れます(java
ランチャの場合と同じ)。そのようなモジュール関連の引数が使用されるとき、native-image
ツール自体もモジュールとして使用されます。
--add-reads
および--add-modules
のサポートに加えて、モジュール・パスをスキャンする前に、すべてのモジュール関連オプションが考慮されます。これにより、クラス・ロード・エラーを防止し、実行時にモジュール・イントロスペクションを改善できます。
Javaモジュールからネイティブ実行可能ファイルをビルドするコマンドは次のとおりです:
native-image [options] --module <module>[/<mainclass>] [options]
デモの実行
次のステップに従って、モジュラJavaアプリケーションをネイティブ実行可能ファイルにビルドします。このデモでは、Mavenで収集された単純なHelloWorld Javaモジュールを使用します:
├── hello
│ └── Main.java
│ > package hello;
│ >
│ > public class Main {
│ > public static void main(String[] args) {
│ > System.out.println("Hello from Java Module: "
│ > + Main.class.getModule().getName());
│ > }
│ > }
│
└── module-info.java
> module HelloModule {
> exports hello;
> }
-
GraalVM JDKがインストール済であることを確認します。最も簡単に始めるには、SDKMAN!を使用します。その他のインストール・オプションについては、「ダウンロード」セクションを参照してください。
- デモ・リポジトリをダウンロードまたはクローニングし、ディレクトリ
native-hello-module
に移動します:git clone https://github.com/graalvm/graalvm-demos cd graalvm-demos/native-hello-module
- Mavenを使用してプロジェクトをコンパイルおよびパッケージ化します:
mvn package
- GraalVMのJDKでの実行をテストします:
$JAVA_HOME/bin/java --module-path target/HelloModule-1.0-SNAPSHOT.jar --module HelloModule
- 次に、このモジュールをネイティブ実行可能ファイルにビルドします:
$JAVA_HOME/bin/native-image --module-path target/HelloModule-1.0-SNAPSHOT.jar --module HelloModule
モジュラJavaアプリケーションを、実行可能なプロジェクト・ルート・ディレクトリ内の
hellomodule
というネイティブ実行可能ファイルにビルドします:./hellomodule
関連ドキュメント
- 実行時にJavaモジュールのリソースにアクセスする方法の詳細。