Cómo utilizar IronPdfEngine

Darrius Serrant
Darrius Serrant
25 de febrero, 2024
Actualizado 10 de diciembre, 2024
Compartir:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine es un servidor gRPC diseñado para supervisar una serie de tareas de IronPDF, que abarcan la creación, edición y lectura de documentos PDF.

Comience con IronPDF

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer


IronPdf Node.js y IronPdfEngine

IronPDF for Node.js requiere IronPdfEngine para ejecutarse. El código Node.js es sólo una máscara API sobre IronPdfEngine gRPC. Así que cuando llames a cualquier método en IronPdf for Node.js, ¡la magia sucederá dentro de IronPdfEngine!

Por defecto IronPdf para Node.js generará IronPdfEngine como un subproceso y hablará con él hasta que tu aplicación se cierre.

Atención
Cada versión de IronPdf para Node.js requiere una versión específica de IronPdfEngine. No se admiten versiones cruzadas.

IronPdf para Node.js con IronPdfEngine local

Opción 1 descargar IronPdfEngine en tiempo de ejecución

De forma predeterminada, después de instalar IronPdf en su proyecto de Java, en la primera ejecución, IronPdf detectará su plataforma (por ejemplo, Windows x64) y descargará los binarios correctos de IronPdfEngine desde internet.

npm i @ironsoftware/ironpdf

Pros

  • Su expediente de candidatura será pequeño.
  • Puede implantarse en muchas plataformas

Contras

  • Se necesita acceso a Internet en las primeras carreras
  • Puesta en marcha lenta

Opción 2 (recomendada) instalar IronPdfEngine como dependencia

IronPdf Node.js te permite añadir IronPdfEngine como dependencia. Estas dependencias de IronPdfEngine agrupan IronPdfEngine en un archivo .zip y se extraerán y utilizarán automáticamente.

Puede elegir instalar una o varias de estas dependencias de IronPdfEngine.

Atención
ironpdf y ironpdf-engine-xxx-xxx la versión de la dependencia debe ser la misma.

La versión de dependencia ironpdf-engine-xxx-xxx no se refiere a la versión de IronPdfEngine en su interior.

Para Windows x64

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

Para Windows x86

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

Para Linux x64

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

Para macOS x64

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

Para macOS arm

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

Atención
Cada dependencia es bastante grande, no es buena idea instalarlas todas.

Pros

  • Arranque más rápido.
  • No se necesita acceso a Internet después de instalar la dependencia.

Contras

  • Su expediente de candidatura será voluminoso.
  • Es necesario especificar las plataformas de destino.

IronPdf para Node.js con IronPdfEngine remoto

Para utilizar IronPdfEngine remoto se necesita una versión específica de IronPdfEngine. Por ejemplo, si la versión 2024.2.2 de IronPdf for Node.js requiere la versión 2024.2.2 de IronPdfEngine. No use la versión 2024.2.1 de IronPdfEngine. Acceda a la propiedad ironPdfEngineVersion para verificar la versión necesaria.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Cómo conectarse

Suponga que IronPdfEngine se ejecuta de forma remota en 123.456.7.8:33350

Atención
Para ejecutar IronPdfEngine de forma remota, por favor consulte "Cómo Descargar y Ejecutar IronPdfEngine".

Solo necesitas indicarle a IronPdf dónde está IronPdfEngine (asegúrate de que esa dirección sea accesible y no esté bloqueada por el firewall).

Agregue este código en la etapa inicial de su aplicación (o justo antes de llamar a cualquier método de IronPdf).

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

¡Así de simple! ¡Después de esto, su aplicación estará conectada a Remote IronPdfEngine!

Para IronPdfEngine remoto, no es necesario instalar IronPdfEngine como dependencia. Puede omitir la sección titulada "Opción 2 (recomendada) instalar IronPdfEngine como una dependencia."

Darrius Serrant
Ingeniero de Software Full Stack (WebOps)

Darrius Serrant tiene una licenciatura en Informática de la Universidad de Miami y trabaja como Ingeniero de Marketing WebOps Full Stack en Iron Software. Atraído por la programación desde una edad temprana, veía la computación como algo misterioso y accesible, lo que la convertía en el medio perfecto para la creatividad y la resolución de problemas.

En Iron Software, Darrius disfruta creando cosas nuevas y simplificando conceptos complejos para hacerlos más comprensibles. Como uno de nuestros desarrolladores residentes, también se ha ofrecido como voluntario para enseñar a los estudiantes, compartiendo su experiencia con la próxima generación.

Para Darrius, su trabajo es gratificante porque es valorado y tiene un impacto real.