graal について
Maven、Gradle、コマンドラインを使った GraalVM Native Image アプリケーションのビルド、設定、トラブルシューティング向けスキル集です。ビルドツール、メタデータ設定、問題調査を個別の資料にまとめています。
主な機能
- 01Native Image CLI のビルドガイド
- 02Maven と Gradle の統合
- 03到達可能性メタデータのガイド
- 04ビルドと実行時のトラブルシューティング
活用シーン
- 01Java クラスをネイティブイメージとしてビルドする
- 02Maven または Gradle プロジェクトで Native Image を設定する
- 03リフレクションやリソースのメタデータ不足を解決する
- 04ビルドまたは実行時の障害を調べる
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ oracle/ skills --skill graalインストール後、Claude Code で/graalを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
native-image/build-native-image.mdnative-build-tools.mdreachability-metadata.mdtroubleshooting.md詳細
Oracle Graal Skills
このドメインでは、Maven、Gradle、または CLI を使用して、GraalVM Native Image アプリケーションをビルド、設定、トラブルシューティングできます。
このドメインの使用方法
- まず、以下のルーティングテーブルを確認します。
- タスクに必要な Native Image ファイルだけを読みます。
- Maven または Gradle プロジェクトでは、Native Build Tools を優先してください。シンプルな Java ファイルや CLI を直接使う場合は、
native-imageワークフローを使用します。
ディレクトリ構造
graal/
|-- SKILL.md
`-- native-image/
|-- build-native-image.md
|-- native-build-tools.md
|-- reachability-metadata.md
`-- troubleshooting.md
カテゴリ別ルーティング
| トピック | ファイル |
|---|---|
native-image CLI ビルド、オプション、クラスパス、モジュール、出力名、バイナリタイプ、最適化、URL プロトコル、モニタリング、セキュリティ | graal/native-image/build-native-image.md |
Maven native-maven-plugin、Gradle org.graalvm.buildtools.native、ビルドツールのタスク、プラグインのオプション、ネイティブテストのルーティング | graal/native-image/native-build-tools.md |
リフレクション、JNI、リソース、リソースバンドル、シリアライズ、動的プロキシ、条件付きメタデータの不足、および reachability-metadata.json の構成 | graal/native-image/reachability-metadata.md |
| ビルド失敗、実行時の失敗、メタデータ不足の症状、クラス初期化の問題、メモリの問題、診断、Maven の有効化に関する問題、および修正の振り分け先 | graal/native-image/troubleshooting.md |
主な参照先
graal/native-image/build-native-image.mdgraal/native-image/native-build-tools.mdgraal/native-image/reachability-metadata.mdgraal/native-image/troubleshooting.md
一般的な複数ステップの手順
| タスク | 推奨される手順 |
|---|---|
| Native Image で Java クラスをビルドする | native-image/build-native-image.md |
| Native Image 用に Maven または Gradle プロジェクトを設定する | native-image/native-build-tools.md -> フラグについては native-image/build-native-image.md |
| リフレクション、JNI、プロキシ、リソース、バンドル、またはシリアライズのメタデータ不足を修正する | native-image/reachability-metadata.md |
| ビルド失敗や実行時の動作の違いを診断する | native-image/troubleshooting.md -> native-image/build-native-image.md -> メタデータが関係する場合は native-image/reachability-metadata.md |
ソース
- https://github.com/oracle/graal/tree/master/substratevm/skills/building-native-image
- https://github.com/oracle/graal/tree/master/substratevm/skills/building-native-image-maven
- https://github.com/oracle/graal/tree/master/substratevm/skills/building-native-image-gradle
- https://www.graalvm.org/latest/reference-manual/native-image/
コメント
Markdown 対応