Depuración local de Azure Functions con IronPDF

Curtis Chau

Updated: 24 de abril de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Depuración local de Azure Functions con IronPDF ## Cuestiones al ejecutar Azure localmente Una excepción común vista al encontrar este problema es "Error al localizar el archivo de configuración de despliegue IronPdf.Native.Chrome.deployment.json." **Recomendado:** Ejecute aplicaciones de función de Azure alojadas en Windows que apunten a .NET Core 3.1 `<TargetFramework>netcoreapp3.1</TargetFramework>` **Requerido:** Use la configuración predeterminada **"in-process"** al crear una Azure Function en Visual Studio. La última versión de IronPDF soporta Azure Functions ejecutándose 'fuera de proceso' o en un 'proceso aislado', como se describe en la "[Guía para ejecutar C# Azure Functions en el modelo de trabajador aislado](https://docs.microsoft.com/en-us/azure/azure-functions/dotnet-isolated-process-guide#differences-with-net-class-library-functions)." Sin embargo, las versiones más antiguas pueden no soportar estos tipos de Azure Functions.  ## Problema con las dependencias al ejecutar Azure Functions localmente Al ejecutar Azure localmente, usando Azurite (VS2022) o el Emulador de Almacenamiento de Azure (VS2019), se crea un directorio bin adicional que el Emulador de Almacenamiento utiliza para el despliegue. Solo los archivos DLL se copian en este directorio, por lo que el software que requiere archivos adicionales no funcionará y puede lanzar la excepción mencionada anteriormente. Puede resolver este problema copiando el directorio de runtimes en el directorio bin separado utilizado por el Emulador de Almacenamiento. Recomendamos hacer esto como un **evento posterior a la compilación** (ver instrucciones a continuación) cuando se ejecute localmente (ya que recompilar/construir devolverá el directorio bin a su estado original). No encontrará este problema al implementar en la nube. - **Problema:** Al ejecutar un proyecto de Azure Function localmente, crea una carpeta _bin_ adicional desde la cual ejecuta la función. Sin embargo, no copia todos los archivos necesarios en dicha carpeta _bin_. - **Ejemplo:** Un proyecto en _C:\code\azure-functions-test_ que se compila en _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1_ - **Solución:** Copie el directorio _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes_ para que también exista dentro de _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin_ - Sobrescriba cualquier archivo existente si se le solicita  ## Evento posterior a la creación Para automatizar el proceso de copiar los archivos necesarios en el directorio bin local de Azure Function, siga estas instrucciones para configurar un *evento posterior a la construcción* en Visual Studio: 1. Haga clic derecho en el proyecto de Azure Functions, seleccione **Propiedades**. 2. Desplácese hacia abajo hasta la sección de **Eventos**. 3. Introduzca un **Evento posterior a la construcción** como se muestra a continuación: ```shell XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D ``` Este comando hará: - Copiar el contenido del directorio _runtimes_ en el directorio _bin/runtimes_. - Los interruptores `/S` y `/E` aseguran que todos los subdirectorios y directorios vacíos estén incluidos. - El interruptor `/Y` suprime las solicitudes de confirmación para sobrescribir un archivo de destino existente. - El interruptor `/I` asume que el destino es un directorio si no existe. - El interruptor `/R` sobrescribe archivos de solo lectura. - El interruptor `/D` copia archivos modificados en o después de la fecha especificada. 

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Cuestiones al ejecutar Azure localmente

Una excepción común vista al encontrar este problema es "Error al localizar el archivo de configuración de despliegue IronPdf.Native.Chrome.deployment.json."

Recomendado: Ejecute aplicaciones de función de Azure alojadas en Windows que apunten a .NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>

Requerido: Use la configuración predeterminada "in-process" al crear una Azure Function en Visual Studio. La última versión de IronPDF soporta Azure Functions ejecutándose 'fuera de proceso' o en un 'proceso aislado', como se describe en la "Guía para ejecutar C# Azure Functions en el modelo de trabajador aislado." Sin embargo, las versiones más antiguas pueden no soportar estos tipos de Azure Functions.

Problema con las dependencias al ejecutar Azure Functions localmente

Al ejecutar Azure localmente, usando Azurite (VS2022) o el Emulador de Almacenamiento de Azure (VS2019), se crea un directorio bin adicional que el Emulador de Almacenamiento utiliza para el despliegue. Solo los archivos DLL se copian en este directorio, por lo que el software que requiere archivos adicionales no funcionará y puede lanzar la excepción mencionada anteriormente.

Puede resolver este problema copiando el directorio de runtimes en el directorio bin separado utilizado por el Emulador de Almacenamiento. Recomendamos hacer esto como un evento posterior a la compilación (ver instrucciones a continuación) cuando se ejecute localmente (ya que recompilar/construir devolverá el directorio bin a su estado original). No encontrará este problema al implementar en la nube.

• Problema: Al ejecutar un proyecto de Azure Function localmente, crea una carpeta bin adicional desde la cual ejecuta la función. Sin embargo, no copia todos los archivos necesarios en dicha carpeta bin.
• Ejemplo: Un proyecto en C:\code\azure-functions-test que se compila en C:\code\azure-functions-test\bin\Debug\netcoreapp3.1
• Solución: Copie el directorio C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes para que también exista dentro de C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin
• Sobrescriba cualquier archivo existente si se le solicita

Evento posterior a la creación

Para automatizar el proceso de copiar los archivos necesarios en el directorio bin local de Azure Function, siga estas instrucciones para configurar un evento posterior a la construcción en Visual Studio:

1. Haga clic derecho en el proyecto de Azure Functions, seleccione Propiedades.
2. Desplácese hacia abajo hasta la sección de Eventos.
3. Introduzca un Evento posterior a la construcción como se muestra a continuación:

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

Este comando hará:

• Copiar el contenido del directorio runtimes en el directorio bin/runtimes.
• Los interruptores /S y /E aseguran que todos los subdirectorios y directorios vacíos estén incluidos.
• El interruptor /Y suprime las solicitudes de confirmación para sobrescribir un archivo de destino existente.
• El interruptor /I asume que el destino es un directorio si no existe.
• El interruptor /R sobrescribe archivos de solo lectura.
• El interruptor /D copia archivos modificados en o después de la fecha especificada.

Curtis Chau

Chatea con el equipo de ingeniería ahora

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