Verwendung von IronPdfEngine

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine ist ein gRPC-Server, der für eine Reihe von IronPDF-Aufgaben entwickelt wurde, die die Erstellung, Bearbeitung und das Lesen von PDF-Dokumenten umfassen.

Node.js-Bibliothek für PDF

Installieren mit npm

 npm i @ironsoftware/ironpdf

IronPDF Node.js und IronPdfEngine

IronPDF for Node.js erfordert IronPdfEngine zur Ausführung. Der Node.js-Code ist nur eine API-Maske über IronPdfEngine gRPC. Wenn Sie also eine beliebige Methode in IronPDF for Node.js aufrufen, geschieht die Magie innerhalb der IronPdfEngine!

Standardmäßig startet IronPDF for Node.js die IronPdfEngine als Unterprozess und kommuniziert mit ihr, bis Ihre Anwendung heruntergefahren wurde.

Bitte beachten Sie
Jede Version von IronPDF for Node.js benötigt eine bestimmte Version von IronPdfEngine. Versionsübergreifende Versionen werden nicht unterstützt.

IronPDF for Node.js mit lokaler IronPdfEngine

Option 1: IronPdfEngine in der Laufzeitumgebung herunterladen

Nachdem Sie IronPDF in Ihrem Java-Projekt installiert haben, erkennt IronPdf beim ersten Start standardmäßig Ihre Plattform(z.B., Windows x64) und laden Sie die richtigen IronPdfEngine-Binärdateien aus dem Internet herunter.

npm i @ironsoftware/ironpdf

Profis

  • Ihr Bewerbungspaket wird klein sein.
  • Kann auf vielen Plattformen eingesetzt werden

Nachteile

  • Für die ersten Fahrten ist ein Internetzugang erforderlich
  • Langsame Startzeit

Option 2(empfohlen) IronPdfEngine als Abhängigkeit installieren

IronPDF for Node.js ermöglicht es Ihnen, IronPdfEngine als Abhängigkeit hinzuzufügen. Diese IronPdfEngine-Abhängigkeiten bündeln IronPdfEngine in einer .zip-Datei und werden automatisch entpackt und verwendet.

Sie können wählen, ob Sie eine oder mehrere dieser IronPdfEngine-Abhängigkeiten installieren möchten.

Bitte beachten Sie
die Versionen der IronPDF- und IronPDF-Engine-xxx-xxx-Abhängigkeiten müssen identisch sein.

die Version der Abhängigkeit ironpdf-engine-xxx-xxx bezieht sich nicht auf die Version von IronPdfEngine.

Für Windows x64

npm install @ironsoftware/ironpdf-engine-windows-x64

Für Windows x86

npm install @ironsoftware/ironpdf-engine-windows-x86

Für Linux x64

npm install @ironsoftware/ironpdf-engine-linux-x64

Für macOS x64

npm install @ironsoftware/ironpdf-engine-macos-x64

Für macOS arm

npm install @ironsoftware/ironpdf-engine-macos-arm64

Bitte beachten Sie
Jede dieser Abhängigkeiten ist ziemlich umfangreich, es ist keine gute Idee, sie alle zu installieren.

Profis

  • Schnellere Startzeit.
  • Nach der Installation der Abhängigkeit ist kein Internetzugang mehr erforderlich.

Nachteile

  • Ihr Bewerbungspaket wird umfangreich sein.
  • Die Zielplattformen müssen spezifiziert werden.

IronPDF for Node.js mit entfernter IronPdfEngine

Für die Verwendung von Remote IronPdfEngine ist eine bestimmte Version von IronPdfEngine erforderlich. Zum Beispiel, wenn IronPDF for Node.js Version 2024.2.2 die IronPdfEngine Version 2024.2.2 benötigt. Verwenden Sie nicht IronPdfEngine Version 2024.2.1. Greifen Sie auf die Eigenschaft ironPdfEngineVersion zu, um die benötigte Version zu überprüfen.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Wie man verbindet

Angenommen, IronPdfEngine wird per Fernzugriff unter "123.456.7.8:33350" ausgeführt

Bitte beachten Sie
Um IronPdfEngine aus der Ferne auszuführen, lesen Sie bitte "Wie man IronPdfEngine abruft und ausführt."

Sie müssen IronPdf nur mitteilen, wo sich IronPdfEngine befindet(vergewissern Sie sich, dass die Adresse zugänglich ist und nicht durch eine Firewall blockiert wird). Fügen Sie diesen Code in der Anfangsphase Ihrer Anwendung ein(oder kurz vor dem Aufruf einer IronPDF-Methode).

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress:"123.456.7.8:33350"
});
JAVASCRIPT

So einfach ist das! Danach wird Ihre Anwendung mit der Remote IronPdfEngine verbunden!

Für Remote IronPdfEngine ist die Installation von IronPdfEngine als Abhängigkeit nicht erforderlich. Sie können den Abschnitt mit der Überschrift "Option 2(empfohlen) IronPdfEngine als Abhängigkeit installieren."