Skip to content

iOS

Use GraalVM for JDK 25.0.2, and exactly that update. The static libraries come from labs-openjdk 25.0.2, and JDK 25.0.3 renamed a native the image links against, so a newer GraalVM builds an image that fails to link. Install the full GraalVM JDK; the build downloads its matching static libraries and CAP cache as one bundle from ios-graal-native-image.

  1. Prepare the macOS/Xcode toolchain described in Godot's iOS export documentation.
  2. Set GRAALVM_HOME to your GraalVM installation. Apply the dependency configuration from GraalVM native image.
  3. Select Build iOS Release in Godot's toolbar and click Run Gradle (buildIOSRelease in IntelliJ). Use Build iOS before an export with debug.
  4. Export with an iOS preset, build the exported Xcode project with the configuration matching the export type, and run it on your device.

The JVM build produces jvm/release/game.a (or jvm/debug/game.a) and the shared jvm/ios/ios-jdk/libjava-release.a and libjvm-release.a. The export links the archive of its variant and the JDK libraries with the Godot-JVM iOS extension into the application.

Details: Reference.

Next: run the exported game on your device.