1. IronPDF
  2. Erste Schritte
  3. Verwendung von IronPdfEngine

Wie IronPdfEngine verwendet wird

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

IronPdfEngine ist ein gRPC-Server, der für die Verwaltung einer Reihe von IronPDF-Aufgaben entwickelt wurde, darunter das Erstellen, Bearbeiten und Lesen von PDF-Dokumenten.

Wie IronPdfEngine in Node.js verwendet wird

  1. Installieren Sie die Node.js-Bibliothek, um IronPdfEngine nutzen zu können.
  2. Binden Sie die Bibliothek ein, indem Sie sie mit npm installieren.
  3. Holen Sie sich die Chrome-Binärdatei über die gleiche Installation.
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. Verwenden Sie IronPdfEngine, um HTML in PDF mit einem Chrome-identischen Renderer zu rendern.

Erste Schritte mit IronPDF

IronPdf Node.js und IronPdfEngine

IronPdf für Node.js benötigt IronPdfEngine zum Ausführen. Der Node.js-Code ist lediglich eine API-Maske für die IronPdfEngine gRPC. Wenn Sie also eine beliebige Methode in IronPdf für Node.js aufrufen, geschieht die Magie innerhalb von IronPdfEngine!

Standardmäßig startet IronPdf für Node.js den Prozess IronPdfEngine als Unterprozess und kommuniziert mit diesem, bis Ihre Anwendung beendet wird.

Hinweis: Jede Version von IronPdf für Node.js benötigt eine bestimmte Version von IronPdfEngine. Versionsübergreifende Kompatibilität wird nicht unterstützt.

IronPdf für Node.js mit lokaler IronPdfEngine

Option 1: IronPdfEngine zur Laufzeit herunterladen

Standardmäßig erkennt IronPdf nach der Installation in Ihrem JavaScript-Projekt beim ersten Start Ihre Plattform (z. B. Windows x64) und lädt die passenden IronPdfEngine-Binärdateien aus dem Internet herunter.

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

Pros:

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

Cons:

  • Für die ersten Durchläufe ist ein Internetzugang erforderlich.
  • Langsame Startzeit.

Option 2 (empfohlen): Installieren Sie IronPdfEngine als Abhängigkeit.

IronPdf für 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 extrahiert und verwendet.

Sie können eine oder mehrere dieser IronPdfEngine-Abhängigkeiten installieren.

Hinweis: Die Abhängigkeitsversionen von ironpdf und ironpdf-engine-xxx-xxx müssen übereinstimmen. Die Abhängigkeitsversion ironpdf-engine-xxx-xxx bezieht sich nicht auf die Version von IronPdfEngine im Inneren.

Plattformspezifische Installation:

  • Windows x64:

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

  • Windows x86:

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

  • Linux x64:

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

  • macOS x64:

    npm install @ironsoftware/ironpdf-engine-macos-x64
    npm install @ironsoftware/ironpdf-engine-macos-x64
    SHELL
  • macOS arm: 
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    SHELL

Pros:

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

Cons:

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

IronPdf für Node.js mit Remote IronPdfEngine

Für die Verwendung einer Remote-IronPdfEngine wird eine bestimmte Version der IronPdfEngine benötigt. Wenn beispielsweise IronPdf für Node.js Version 2024.2.2 die IronPdfEngine Version 2024.2.2 benötigt, verwenden Sie nicht die IronPdfEngine Version 2024.2.1. Die benötigte Version kann über die Eigenschaft ironPdfEngineVersion überprüft werden.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Wie man eine Verbindung herstellt

Angenommen, IronPdfEngine läuft remote unter 123.456.7.8:33350 .

Siehe " So laden und starten Sie IronPdfEngine ".

Zum Verbinden müssen Sie lediglich angeben, wo sich IronPdfEngine befindet (stellen Sie sicher, dass die Adresse erreichbar ist und nicht durch eine Firewall blockiert wird). Fügen Sie diesen Code im Anfangsstadium Ihrer Anwendung oder unmittelbar vor dem Aufruf einer beliebigen IronPdf-Methode ein.

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

So einfach ist das! Anschließend wird Ihre Anwendung mit einer Remote IronPdfEngine verbunden!

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

Häufig gestellte Fragen

Wofür wird IronPdfEngine in Node.js verwendet?

IronPdfEngine ist ein gRPC-Server, der in Node.js zur Verwaltung von PDF-Aufgaben wie Erstellung, Bearbeitung und Rendering verwendet wird und ein nahtloses PDF-Handling-Erlebnis bietet.

Wie kann ich IronPDF for Node.js installieren?

Sie können IronPDF for Node.js mit npm und dem Befehl npm install @Iron Software/ironpdf installieren.

Was sind die Unterschiede zwischen lokalen und entfernten Setups für IronPdfEngine?

Ein lokales Setup beinhaltet entweder das Herunterladen von IronPdfEngine zur Laufzeit oder die Installation als Abhängigkeit, was schnellere Startzeiten bietet. Ein entferntes Setup verbindet sich mit einem entfernten IronPdfEngine-Host, wodurch lokale Installationen überflüssig werden.

Wie stelle ich die Kompatibilität zwischen IronPdf- und IronPdfEngine-Versionen sicher?

Jede Version von IronPDF for Node.js erfordert eine spezifische Version von IronPdfEngine. Verwenden Sie die ironPdfEngineVersion-Eigenschaft, um die erforderliche Version zu überprüfen und sicherzustellen, dass beide Versionen übereinstimmen.

Welche Vorteile hat die Installation von IronPdfEngine als Abhängigkeit?

Die Installation von IronPdfEngine als Abhängigkeit führt zu schnelleren Startzeiten und beseitigt die Notwendigkeit eines Internetzugangs nach der Installation, obwohl die Anwendungsgröße zunimmt.

Wie kann ich mich mit einem entfernten IronPdfEngine verbinden?

Um sich mit einem entfernten IronPdfEngine zu verbinden, verwenden Sie IronPdfGlobalConfig.setConfig, um die Serveradresse anzugeben und sicherzustellen, dass sie zugänglich und nicht durch eine Firewall blockiert ist.

Ist für den Laufzeit-Download von IronPdfEngine ein Internetzugang erforderlich?

Ja, für die ersten Ausführungen ist ein Internetzugang erforderlich, wenn IronPdfEngine zur Laufzeit heruntergeladen wird, was auch zu langsameren Startzeiten führt.

Muss ich IronPdfEngine für die Fernnutzung installieren?

Nein, bei Verwendung eines entfernten IronPdfEngine müssen Sie es nicht lokal als Abhängigkeit installieren.

Kann IronPdfEngine auf verschiedenen Plattformen verwendet werden?

Ja, IronPdfEngine kann auf mehreren Plattformen eingesetzt werden. Plattform-spezifische npm-Befehle sind für Installationen auf Windows, Linux und macOS verfügbar.

Ist IronPDF mit .NET 10 kompatibel und welche Umgebungen werden unterstützt?

Ja, IronPDF ist vollständig kompatibel mit .NET 10 (sowie .NET 9, 8, 7 usw.). Es unterstützt C#, VB.NET und F# und funktioniert plattformübergreifend unter Windows, Linux und macOS – einschließlich Docker- und Cloud-Umgebungen – und eignet sich daher für .NET 10-Web-, Desktop-, Konsolen- und Cloud-Projekte.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Version: 2025.12 gerade veröffentlicht