Use IronPDF with in-Engine Mode

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 usar la configuración de Motor, recomendamos instalar IronPdf.Slim en lugar del paquete completo IronPdf desde NuGet, ya que el Motor gestiona todo el peso adicional incluido en el paquete Nativo.

Install-Package IronPdf.Slim

Después de instalar IronPdf.Slim, configura los ajustes de conexión apuntando IronPDF a tu 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 adicional de código de configuración para agregar a su código C

Asumiendo que IronPdfEngine opera remotamente 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 autónoma de C# .NET, IronPdfEngine opera de manera independiente, eliminando la necesidad del entorno de ejecución .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 para IronPdfEngine

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

Por favor notaCada versión de IronPdf para .NET requiere una versión específica de IronPdfEngine. No está disponible el soporte entre versiones. Para IronPdf para .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 para .NET con IronPdfEngine Remoto.

Por favor notaSi estás usando IronPdf o IronPdf.Linux, puedes usar IronPdf.slim en su lugar para reducir el tamaño de tu aplicación.

Asumiendo que IronPdfEngine opera remotamente en 123.456.7.8:33350.

Instala IronPdf usando NuGet:

Install-Package IronPdf.Slim

Después de instalar IronPdf.slim, solo necesitas decirle a IronPdf dónde está IronPdfEngine (asegúrate de que esa dirección sea accesible y no esté bloqueada por un 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 un contenedor de Linux (selecciona Cambiar a Contenedores de Linux si estás 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,012,929 | Versión: 2025.12 recién lanzado