Wie richtet man das IronPdfEngine ein

Option 1: IronPdfEngine zur Laufzeit herunterladen

Standardmäßig erkennt IronPDF nach dem Hinzufügen der Kern-ironpdf-Abhängigkeit beim ersten Lauf die Host-Plattform (zum Beispiel Windows x64 oder Linux x64) und lädt die passende IronPdfEngine-Binärdatei aus dem Internet herunter.

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

Nach dem ersten Download wird die Binärdatei lokal zwischengespeichert und nachfolgende Läufe starten ohne Netzwerkaufruf.

Option 2: Bündeln von IronPdfEngine als Abhängigkeit (empfohlen)

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

Wie überprüfen Sie die erforderliche IronPdfEngine-Version?

Die Version muss exakt übereinstimmen — IronPDF for Java 2024.2.2 erfordert genau IronPdfEngine 2024.2.2. Verwenden Sie getIronPdfEngineVersion, um die erforderliche Version zu bestätigen, bevor Sie den Server bereitstellen:

:path=/static-assets/ironpdf-java/content-code-examples/get-started/use-ironpdfengine-8.java

// Retrieve the IronPdfEngine version required by this Java library build
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
System.out.println("Required IronPdfEngine version: " + ironPdfEngineVersion);

Stellen Sie das IronPdfEngine-Docker-Image oder die Binärdatei bereit oder ziehen Sie sie, die der zurückgegebenen Versionszeichenfolge entspricht.

Wie konfigurieren Sie die Remote-Verbindung?

Nehmen Sie an, IronPdfEngine läuft bei 123.456.7.8:33350. Stellen Sie den Host und den Port ein, bevor Sie eine IronPDF-Methode aufrufen. Die beste Praxis ist, diese Aufrufe beim Start der Anwendung zu platzieren, bevor eine PDF-Operation ausgeführt wird:

:path=/static-assets/ironpdf-java/content-code-examples/get-started/use-ironpdfengine-9.java

// Configure IronPDF for Java to connect to a remote IronPdfEngine instance
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);

Nach Ausführung dieser beiden Zeilen werden alle nachfolgenden IronPDF-Aufrufe in Ihrer Anwendung auf den Remote-Server geroutet. Kein lokaler IronPdfEngine-Subprozess wird gestartet, und es wird keine plattformspezifische Engine-Abhängigkeit in Ihrem pom.xml benötigt.

Wie sieht ein vollständiger Remote-Einrichtungsvorgang aus?

Das folgende Beispiel verbindet sich mit einer entfernten IronPdfEngine-Instanz und rendert einen HTML-String in eine PDF-Datei — dieselbe API, die im lokalen Modus verwendet wird, wobei sich nur die Konfiguration unterscheidet:

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

Das gerenderte PDF wird über gRPC an den Java-Prozess zurückgegeben und lokal gespeichert. Der Remote-Server verarbeitet alle auf Chrome basierenden Render-, Schriftartenlade- und Ressourcenauflösungsprozesse.