Utilice IronPDF con el modo in-Engine

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

Diferencia entre nativo y motor

IronPDF tiene algunas funciones con gran demanda de rendimiento que puedes elegir ejecutar de manera remota. Aunque IronPDF no requiere IronPdfEngine para funcionar, configurar IronPdfEngine como un servicio remoto es una forma opcional de evitar problemas de compatibilidad con Chrome específicos de la plataforma en sistemas operativos más antiguos y entornos móviles.

Comienza con IronPDF

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

Primer Paso:
green arrow pointer


Cómo el uso de Engine cambia la forma de codificar con IronPDF

Al utilizar la configuración del motor, recomendamos instalar IronPdf.Slim en lugar del paquete completo IronPdf de NuGet, ya que el motor administra todo el volumen adicional incluido en el paquete nativo.

Install-Package IronPdf.Slim

Después de instalar IronPdf.Slim, configure los ajustes de conexión apuntando IronPDF a su instancia de IronPdfEngine. Agrega el siguiente código al inicio de tu aplicación (o antes de llamar a cualquier método de IronPDF):

Línea extra de código de configuración para añadir a su código C

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

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
$vbLabelText   $csharpLabel

¿Cómo funciona IronPdfEngine?

IronPdfEngine es un servidor contenedor diseñado para gestionar diversas operaciones de IronPDF, incluyendo crear, escribir, editar y leer PDFs, todo utilizando el protocolo gRPC. Construido como una aplicación C# .NET autónoma, IronPdfEngine opera independientemente, eliminando la necesidad del runtime de .NET durante la ejecución. ¡Nos encargamos de la conexión gRPC para que puedas concentrarte en la codificación!

Para un tutorial de inicio rápido sobre cómo ejecutar IronPDF como su propio contenedor, por favor consulta este tutorial.

Otras aclaraciones sobre IronPdfEngine

IronPDF for .NET no requiere IronPdfEngine para funcionar. IronPdfEngine es solo una forma opcional de usar IronPdf. Por defecto, IronPdf for .NET no utilizará IronPdfEngine.

Por favor notaCada versión de IronPdf for .NET requiere una versión específica de IronPdfEngine. No está disponible el soporte entre versiones. Para IronPdf for .NET, la versión requerida de IronPdfEngine siempre coincidirá. Por ejemplo, IronPdf 2024.2.2 usará IronPdfEngine 2024.2.2

IronPdf .NET con IronPdfEngine remoto

El paquete NuGet IronPdf.slim es el único paquete necesario para usar IronPdf for .NET con IronPdfEngine Remoto.

Por favor notaSi está utilizando IronPdf o IronPdf.Linux, puede utilizar IronPdf.slim en su lugar para reducir el tamaño de su aplicación.

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

Instala IronPdf usando NuGet:

Install-Package IronPdf.Slim

Después de instalar IronPdf.slim, solo necesita indicarle a IronPDF dónde se encuentra IronPdfEngine (asegúrese de que la dirección sea accesible, no esté bloqueada por el firewall). Usa la clase IronPdfConnectionConfiguration para configurar los ajustes de conexión. Agrega el siguiente código a la etapa inicial de tu aplicación (o justo antes de llamar a cualquier método de IronPdf).

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
$vbLabelText   $csharpLabel

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


Limitaciones de IronPdfEngine

  • Actualmente, IronPdfEngine aún no admite el escalamiento horizontal (balanceo de carga con múltiples instancias) porque almacenamos los binarios del archivo PDF en proceso dentro de la memoria del servidor y usamos PdfDocumentId para la comunicación entre el servidor y el cliente. Esto también minimiza el uso de ancho de banda y aumenta la velocidad de procesamiento.
  • Para ejecutar IronPdfEngine Docker remotamente, necesitas asegurarte de que el puerto de IronPdfEngine sea accesible.
  • IronPdfEngine Docker ejecutándose en Linux x64 (Debian) usando imágenes oficiales basadas en ubuntu:22.04 puede producir una salida PDF que es ligeramente diferente de la que obtendrías ejecutando IronPdf localmente debido a un comportamiento diferente del sistema operativo.
  • Dado que IronPdfEngine Docker está basado en Linux, requiere el demonio Linux Containers (seleccione Switch to Linux Containers si está usando Windows).
  • Los binarios de IronPdfEngine no son multiplataforma, por lo que los construimos específicamente para cada plataforma.
  • No está disponible el soporte entre versiones.

Preguntas Frecuentes

¿Cómo puedo configurar IronPDFEngine para la generación remota de PDF?

Para configurar IronPdfEngine para la generación remota de PDF, instala el paquete IronPdf.Slim desde NuGet y configura las configuraciones de conexión usando la clase IronPdfConnectionConfiguration. Esta configuración te permite conectar tu aplicación a la instancia de IronPdfEngine remotamente.

¿Cuáles son los principales beneficios de usar IronPDFEngine con mi aplicación?

Usar IronPDFEngine con tu aplicación permite la ejecución remota de tareas PDF, ayudando a evitar problemas de compatibilidad específicos de la plataforma, especialmente en sistemas más antiguos y plataformas móviles. También elimina la necesidad del tiempo de ejecución de .NET durante la ejecución.

¿Por qué podría elegir usar IronPDFEngine en lugar de la biblioteca PDF nativa?

Podrías elegir IronPDFEngine para ejecutar funciones PDF intensivas en rendimiento de forma remota, reduciendo problemas de compatibilidad con diferentes sistemas operativos y mejorando el rendimiento al aprovechar un renderizador idéntico a Chrome para la conversión de HTML a PDF.

¿Es compatible el escalado horizontal en IronPDFEngine?

No, IronPDFEngine actualmente no admite el escalado horizontal, lo que significa que no puede ser equilibrado en carga entre múltiples instancias debido a la forma en que se manejan los archivos binarios de PDF en la memoria del servidor.

¿Puede ejecutarse IronPDFEngine en diferentes sistemas operativos?

IronPDFEngine está diseñado para ejecutarse en sistemas Linux usando contenedores Docker. Sin embargo, los archivos binarios son específicos de la plataforma, por lo que necesitas asegurarte de usar la versión correcta para tu sistema operativo.

¿Qué debo hacer si mis salidas de PDF son diferentes al usar IronPDFEngine?

Las salidas de PDF pueden variar ligeramente debido a comportamientos diferentes del sistema operativo. Para minimizar diferencias, asegúrate de estar usando la imagen Docker correcta y verifica cualquier configuración específica del sistema operativo que pueda afectar el renderizado.

¿Cómo aseguro que mi aplicación esté usando la versión correcta de IronPDFEngine?

Para asegurar la compatibilidad, cada versión de IronPDF requiere una versión correspondiente de IronPDFEngine. Asegúrate de actualizar ambos componentes simultáneamente para evitar problemas de versiones cruzadas.

¿Cuáles son las limitaciones al usar IronPDFEngine en Windows?

Al usar IronPDFEngine en Windows, necesitas contenedores de Linux para Docker y debes asegurarte de que el puerto del servidor sea accesible. Los binarios son específicos de la plataforma y se requiere cambiar a contenedores de Linux.

¿Cómo configuro IronPDF para conectar a un servidor remoto de IronPDFEngine?

Para configurar IronPDF para un servidor remoto, usa Installation.ConnectToIronPdfHost con el método IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, especificando los detalles de IP y puerto del servidor.

¿Qué paquete debo usar para minimizar el tamaño de la aplicación al usar IronPDFEngine?

Deberías usar el paquete IronPdf.Slim de NuGet, ya que incluye solo los componentes necesarios para ejecutar IronPDF con IronPdfEngine, reduciendo así el tamaño de la aplicación.

Curtis Chau
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?
Nuget Descargas 17,803,474 | Versión: 2026.3 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.