This is an automated email from the ASF dual-hosted git repository.

jamesnetherton pushed a commit to branch quarkus-main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git

commit 0b2ef3d67f5796fc8b8b90a71ac0c05be5469bc5
Author: James Netherton <[email protected]>
AuthorDate: Mon Jan 12 15:09:51 2026 +0000

    Document FOP JDK version limitations and override native builder image in 
integration tests due to #7936
---
 docs/modules/ROOT/pages/reference/extensions/fop.adoc | 15 +++++++++++++++
 extensions/fop/runtime/src/main/doc/limitations.adoc  | 13 +++++++++++++
 integration-tests/fop/pom.xml                         |  2 ++
 3 files changed, 30 insertions(+)

diff --git a/docs/modules/ROOT/pages/reference/extensions/fop.adoc 
b/docs/modules/ROOT/pages/reference/extensions/fop.adoc
index 533d26a7ba..3c2f3fe523 100644
--- a/docs/modules/ROOT/pages/reference/extensions/fop.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/fop.adoc
@@ -47,6 +47,21 @@ endif::[]
 [id="extensions-fop-camel-quarkus-limitations"]
 == Camel Quarkus limitations
 
+[id="extensions-fop-limitations-supported-jdk-versions"]
+=== Supported JDK versions
+
+Due to an https://issues.apache.org/jira/browse/FOP-3275[issue] with Apache 
FOP encountered with JDK 25, it's advised to build and run your application 
with JDK 21 or JDK 17 when using this extension.
+
+When running in native mode, you'll need to ensure you build with the 
appropriate GraalVM / Mandrel version. When using containerized native image 
builds, you can override the default Quarkus builder image with the following 
configuration.
+
+[source,properties]
+----
+quarkus.native.builder-image=quay.io/quarkus/ubi9-quarkus-mandrel-builder-image:jdk-21
+----
+
+[id="extensions-fop-limitations-supported-output-types"]
+=== Supported Output Types
+
 While you can use any of the available output types in JVM mode, only PDF 
output type is supported
 in native mode.
 
diff --git a/extensions/fop/runtime/src/main/doc/limitations.adoc 
b/extensions/fop/runtime/src/main/doc/limitations.adoc
index 494a225f3f..e333a1aff6 100644
--- a/extensions/fop/runtime/src/main/doc/limitations.adoc
+++ b/extensions/fop/runtime/src/main/doc/limitations.adoc
@@ -1,3 +1,16 @@
+=== Supported JDK versions
+
+Due to an https://issues.apache.org/jira/browse/FOP-3275[issue] with Apache 
FOP encountered with JDK 25, it's advised to build and run your application 
with JDK 21 or JDK 17 when using this extension.
+
+When running in native mode, you'll need to ensure you build with the 
appropriate GraalVM / Mandrel version. When using containerized native image 
builds, you can override the default Quarkus builder image with the following 
configuration.
+
+[source,properties]
+----
+quarkus.native.builder-image=quay.io/quarkus/ubi9-quarkus-mandrel-builder-image:jdk-21
+----
+
+=== Supported Output Types
+
 While you can use any of the available output types in JVM mode, only PDF 
output type is supported
 in native mode.
 
diff --git a/integration-tests/fop/pom.xml b/integration-tests/fop/pom.xml
index 6329be0ca4..92ca574cfe 100644
--- a/integration-tests/fop/pom.xml
+++ b/integration-tests/fop/pom.xml
@@ -79,6 +79,8 @@
             </activation>
             <properties>
                 <quarkus.native.enabled>true</quarkus.native.enabled>
+                <!-- TODO: Remove this - 
https://github.com/apache/camel-quarkus/issues/7936 -->
+                
<quarkus.native.builder-image>quay.io/quarkus/ubi9-quarkus-mandrel-builder-image:jdk-21</quarkus.native.builder-image>
             </properties>
             <build>
                 <plugins>

Reply via email to