1. IronPDF
  2. Comenzar
  3. Usar IronPDFEngine

Cómo usar IronPdfEngine

Curtis Chau
Curtis Chau
Actualizado:
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 gama de tareas de IronPDF, que abarca la creación, edición y lectura de documentos PDF.

Cómo utilizar IronPdfEngine en Node.js

  1. Instale la biblioteca Node.js para utilizar IronPdfEngine.
  2. Incluya la biblioteca instalándola mediante npm.
  3. Consigue el binario de Chrome a través de la misma instalación.
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. Usa IronPdfEngine para renderizar HTML a PDF con un renderizador idéntico a Chrome.

IronPDF for Node.js y IronPdfEngine

IronPdf for Node.js requiere IronPdfEngine para funcionar. El código de Node.js es solo una máscara de API sobre el gRPC de IronPdfEngine. Así que cuando llamas a cualquier método en IronPdf for Node.js, ¡la magia sucede dentro de IronPdfEngine!

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

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

IronPDF for Node.js con IronPdfEngine local

Opción 1: Descargar IronPdfEngine en tiempo de ejecución

Por defecto, después de instalar IronPdf en tu proyecto JavaScript, en la primera ejecución, IronPdf detectará tu plataforma (por ejemplo, Windows x64) y descargará los binarios correctos de IronPdfEngine desde internet.

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

Pros:

  • El paquete de tu aplicación será pequeño.
  • Puede desplegarse en muchas plataformas.

Contras:

  • Se necesita acceso a internet en las primeras ejecuciones.
  • Tiempo de inicio lento.

Opción 2 (recomendada): Instalar IronPdfEngine como dependencia

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

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

Nota: Las versiones de dependencia ironpdf y ironpdf-engine-xxx-xxx deben ser las mismas. La versión de la dependencia ironpdf-engine-xxx-xxx no hace referencia a la versión de IronPdfEngine interna.

Instalación específica por plataforma:

  • 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:

  • Tiempo de inicio más rápido.
  • No se necesita acceso a internet después de instalar la dependencia.

Contras:

  • El paquete de tu aplicación será grande.
  • Necesitas especificar las plataformas de destino.

IronPDF for Node.js con IronPdfEngine remoto

Para usar un IronPdfEngine remoto, se necesita una versión específica de IronPdfEngine. Por ejemplo, si IronPDF for Node.js versión 2024.2.2 requiere IronPdfEngine versión 2024.2.2, no use IronPdfEngine versión 2024.2.1. Acceda a la propiedad ironPdfEngineVersion para comprobar la versión necesaria.

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

Cómo conectarse

Supongamos que IronPdfEngine se ejecuta de forma remota en 123.456.7.8:33350.

Consulta "Cómo Obtener y Ejecutar IronPdfEngine".

Para conectar, solo necesitas especificar dónde se encuentra IronPdfEngine (asegúrate de que la dirección sea accesible, no bloqueada por un firewall). Agrega este código al inicio de tu aplicación, o justo antes de llamar a cualquier método de IronPdf.

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

¡Simple como eso! ¡Después de esto, tu aplicación estará conectada a un IronPdfEngine Remoto!

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

Preguntas Frecuentes

¿Para qué se utiliza IronPDFEngine en Node.js?

IronPDFEngine es un servidor gRPC utilizado en Node.js para gestionar tareas PDF como creación, edición y renderización, ofreciendo una experiencia fluida en el manejo de PDF.

¿Cómo puedo instalar IronPDF for Node.js?

Puede instalar IronPDF for Node.js usando npm con el comando npm install @Iron Software/ironpdf.

¿Cuáles son las diferencias entre configuraciones locales y remotas para IronPDFEngine?

Una configuración local implica descargar IronPDFEngine en tiempo de ejecución o instalarlo como dependencia, ofreciendo tiempos de inicio más rápidos. Una configuración remota se conecta a un IronPDFEngine alojado de forma remota, eliminando la necesidad de instalaciones locales.

¿Cómo aseguro la compatibilidad entre las versiones de IronPDF e IronPDFEngine?

Cada versión de IronPDF for Node.js requiere una versión específica de IronPDFEngine. Use la propiedad ironPdfEngineVersion para verificar la versión requerida y garantizar que ambas versiones coincidan.

¿Cuáles son los beneficios de instalar IronPDFEngine como una dependencia?

Instalar IronPDFEngine como una dependencia resulta en tiempos de inicio más rápidos y elimina la necesidad de acceso a internet después de la instalación, aunque aumenta el tamaño del paquete de la aplicación.

¿Cómo me conecto a un IronPDFEngine remoto?

Para conectarse a un IronPDFEngine remoto, use IronPDFGlobalConfig.setConfig para especificar la dirección del servidor, asegurándose de que sea accesible y no esté bloqueada por un firewall.

¿Se requiere acceso a internet para descargas en tiempo de ejecución de IronPDFEngine?

Sí, se requiere acceso a internet en las primeras ejecuciones al descargar IronPDFEngine en tiempo de ejecución, lo que también resulta en tiempos de inicio más lentos.

¿Necesito instalar IronPDFEngine para su uso remoto?

No, cuando utiliza un IronPDFEngine remoto, no necesita instalarlo localmente como una dependencia.

¿Puede IronPDFEngine ser utilizado en diferentes plataformas?

Sí, IronPDFEngine puede ser desplegado en múltiples plataformas. Los comandos npm específicos para la plataforma están disponibles para instalaciones en Windows, Linux y macOS.

¿IronPDF es compatible con .NET 10 y qué entornos admite?

Sí, IronPDF es totalmente compatible con .NET 10 (junto con .NET 9, 8, 7, etc.). Es compatible con C#, VB.NET y F#, y funciona en plataformas como Windows, Linux y macOS, incluyendo Docker y entornos en la nube, lo que lo hace ideal para proyectos web, de escritorio, de consola o en la nube de .NET 10.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Versión: 2026.3 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida?
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.