Cómo utilizar IronPdfEngine

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 para Node.js requiere IronPdfEngine para funcionar. 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 para Node.js la magia ocurrirá 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

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

npm i @ironsoftware/ironpdf

Professionales

  • 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
La versión de dependencia de ironpdf y ironpdf-engine-xxx-xxx debe ser la misma.

La versión de la dependencia ironpdf-engine-xxx-xxx no hace referencia a la versión de IronPdfEngine que contiene.

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.

Professionales

  • 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 el IronPdf para Node.js versión 2024.2.2 requiere IronPdfEngine versión 2024.2.2. No utilice IronPdfEngine versión 2024.2.1. Accede a la propiedad ironPdfEngineVersion para comprobar la versión necesaria.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Cómo conectarse

Supongamos que IronPdfEngine se ejecuta remotamente en 123.456.7.8:33350.

Atención
Para ejecutar IronPdfEngine de forma remota, consulte "Cómo extraer y ejecutar IronPdfEngine."

Sólo tienes que decirle a IronPdf dónde está IronPdfEngine(asegúrese de que la dirección es accesible y no está bloqueada por un cortafuegos).

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

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

Así de sencillo! Después de esto su aplicación se conectará IronPdfEngine remoto!

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