graal

Oracle Graal 技能

使用此领域通过 Maven、Gradle 或 CLI 构建、配置和排查 GraalVM Native Image 应用程序。

如何使用此领域

1. 从下方的路由表开始。
2. 只阅读任务所需的特定 Native Image 文件。
3. 对于 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.md
• graal/native-image/native-build-tools.md
• graal/native-image/reachability-metadata.md
• graal/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/