Gestión de la carpeta Runtimes en IronPDF
IronPDF requiere que la carpeta de entornos esté incluida en un proyecto/despliegue.
No incluir esta carpeta provocará las siguientes excepciones:
- Mensaje de Excepción: "No se pudo localizar la biblioteca nativa en la ruta 'C:\ruta-a\tu-app\chrome_elf.dll'"
Para equipos de facturación electrónica española: Este error es habitual al desplegar aplicaciones que generan PDFs para VERI*FACTU o Facturae en servidores de producción Windows Server, especialmente cuando la carpeta
runtimesno se incluye en el perfil de publicación. En pipelines de integración con la AEAT (SII, VERI*FACTU), asegurarse de que la carpeta de runtimes esté correctamente incluida es un paso previo crítico antes de cualquier prueba de conectividad con los servicios de la Agencia Tributaria.
Recomendado:
-
Realice el despliegue utilizando el Asistente de Publicación dentro de Visual Studio. Una vez que el proceso de publicación esté completado, revise el perfil de publicación y asegúrese de que el entorno de destino sea Portable. Esto debería ser así, ya que Visual Studio creará un perfil de publicación con Dependiente del framework como modo de Despliegue y Portable como entorno de destino por defecto. (Todo en la carpeta de entornos se incluirá automáticamente en el perfil de publicación).
Aprenda más sobre el modo de Despliegue de Visual Studio aquí. - Si no puede usar Visual Studio para gestionar su despliegue, copie manualmente las carpetas de entornos desde una máquina de desarrollo hasta la carpeta bin en su máquina de producción.
Para usuarios con múltiples proyectos que deseen evitar requerir múltiples carpetas de entornos:
- Utilice el instalador de Windows para instalar un único IronPDF.dll que puede referenciar para todos sus proyectos.
- Considere instalar IronPDF en un microservicio separado de renderización de PDF y llame desde proyectos individuales.
Arquitecturas de microservicio para Facturae y VERI*FACTU
Para proyectos de facturación electrónica española que integran múltiples componentes — generador de XML Facturae, firmador de documentos, y generador de PDFs representativos VERI*FACTU — la arquitectura de microservicio de renderizado de PDF centralizado es una solución recomendada:
- Un único servicio de renderizado con IronPDF gestiona la carpeta
runtimesen un solo lugar. - Los demás componentes del pipeline (firma TicketBAI para Bizkaia, Gipuzkoa y Araba; validador AEAT SII; generador Facturae) llaman al microservicio de PDF vía API interna.
- Esta arquitectura facilita el cumplimiento de LOPDGDD al centralizar el procesamiento de documentos con datos fiscales en un único servicio con políticas de acceso auditables.
En entornos con clasificación ENS para el sector público español, esta arquitectura también facilita la gestión de permisos de ejecución de la carpeta runtimes según las políticas de seguridad del servidor.
Preguntas frecuentes sobre la carpeta runtimes en España
*¿La falta de la carpeta runtimes puede impedir el envío de PDFs representativos VERIFACTU?*
Sí. Si tu aplicación de software certificado VERI\FACTU genera el PDF representativo usando IronPDF y no incluye la carpeta runtimes en el despliegue de producción, la aplicación lanzará la excepción chrome_elf.dll antes de poder renderizar ningún PDF. Asegúrate de incluir la carpeta en el perfil de publicación antes del despliegue.
¿Puedo compartir la carpeta runtimes entre la generación de Facturae y el pipeline SII AEAT?
Si ambos proyectos usan la misma versión de IronPDF, puedes usar el instalador de Windows para instalar una única instancia del runtime, o crear un microservicio de renderizado compartido. La segunda opción es más recomendable en entornos de producción bajo LOPDGDD porque centraliza el control de acceso a los datos fiscales procesados por IronPDF.
¿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.
Comience gratis
Comience gratis
Reserve demostración en vivo gratis
No se requiere tarjeta de crédito ni creación de cuenta
