IRONSOFTWAREHOME

Solución de problemas de dependencias de Chrome en IronPDF

Curtis Chau
Curtis Chau
Updated: 22 de abril de 2026

El renderizador HTML de Google Chromium es una parte esencial del proceso de renderizado de "Html To PDF" de IronPDF. El binario esencial para este renderizador debería encontrarse fácilmente dentro del paquete NuGet de IronPDF. La ausencia de este binario en la carpeta del proyecto generará el siguiente error:

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.
Text

Si IronPDF no puede implementar automáticamente las dependencias de Chrome, es posible que deban agregarse al proyecto manualmente a través de NuGet. Se pueden agregar múltiples dependencias:

Por favor nota: En versiones posteriores de IronPDF, los binarios requeridos se descargarán automáticamente desde la fuente NuGet según el sistema operativo utilizado durante la ejecución, si están ausentes de la carpeta del proyecto. Esto tendrá éxito siempre que el proyecto esté conectado a Internet y tenga permisos de Lectura, Escritura y Ejecución en la carpeta del proyecto.

En Windows, es una buena idea asegurarse de que el sistema operativo objetivo tenga instalados los Runtimes de Visual C++. Muchas aplicaciones modernas no pueden ejecutarse sin este componente esencial del sistema operativo.

También disponemos de guías de compatibilidad para Linux y Docker.

Linux

  • Asegúrese de que se utilice el archivo Docker correcto.

  • Use el paquete NuGet IronPdf.Linux en lugar de IronPDF.

  • Configure el modo GPU de Chrome como deshabilitado.

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
  • Desactive la configuración automática de las dependencias de Linux y Docker:

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;

Sistema operativo Mac

  • Verifique que el tiempo de ejecución de .NET esté configurado en la arquitectura correcta - x64 o arm64.

¿Qué hacer si no se soluciona?

Si eso no soluciona el problema, estamos aquí para ayudarle. La compatibilidad es una alta prioridad para nuestro equipo de ingeniería. Por favor, envíe un informe de error por correo electrónico a support@ironsoftware.com. Todos los problemas de compatibilidad serán revisados seriamente por un ingeniero senior.

Asegúrese de informarnos sobre el sistema operativo/plataforma en la que se implementa, especialmente si es una plataforma en la nube como AWS o Azure.

Cómo activar el registro nativo en IronPDF

Adjuntar archivos de registro a un informe de error más que duplica la probabilidad de que podamos aislar el problema y resolverlo rápidamente.

Coloque esto en la parte superior de su código antes de ejecutar cualquier método de IronPDF (todas las versiones posteriores a 2021.3.1):

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

Los archivos de registro creados por IronPDF se encuentran en el directorio /bin de su proyecto donde se implementan sus DLLs:

  • default.log (Proceso de implementación)
  • cef.log (Renderizado)
  • IronSoftwareCefSubprocess.log (Renderizado y Subprocesos)
  • IronSoftwareEngine.log (Útil para depurar excepciones comenzando con 'Error generando PDF desde...')

Los servidores en la nube tienen ubicaciones específicas para registros. Tenemos guías para generar archivos de registro en Azure y AWS.

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 estructurados y visualmente atractivos.

...
Leer más

¿Listo para empezar?

Nuget Downloads 20,990,528Versión:2026.9recién publicada

Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999