Cómo utilizar IronPdfEngine
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.
Cómo utilizar IronPdfEngine en Node.js
- Instala la librería Node.js para utilizar IronPdfEngine
- Incluya la biblioteca instalándola con npm
- Obtener el binario de Chrome mediante la misma instalación
- Compruebe la versión necesaria accediendo a la propiedad ironPdfEngineVersion
- Utiliza IronPdfEngine para convertir HTML a PDF con un renderizador idéntico al de Chrome.
![Biblioteca Node.js para PDF](/img/icons/n-large.png)
Instalar con npm
npm i @ironsoftware/ironpdf
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
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
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
Professionales
- Arranque más rápido.
- El acceso a Internet no es necesario una vez instalada 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;
Cómo conectarse
Supongamos que IronPdfEngine se ejecuta remotamente en 123.456.7.8:33350
.
Atención
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"
});
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."