Débogage local des Azure Functions avec IronPDF

Curtis Chau

Updated: 24 avril 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Débogage local des Azure Functions avec IronPDF ## Problèmes lors de l'exécution d'Azure localement Une exception courante rencontrée lors de ce problème est "Erreur lors de la localisation du fichier de configuration de déploiement IronPdf.Native.Chrome.deployment.json." **Recommandé :** Exécutez des Azure Function Apps hébergées sous Windows ciblant .NET Core 3.1 `<TargetFramework>netcoreapp3.1</TargetFramework>` **Requis :** Utilisez la configuration par défaut **"in-process"** lors de la création d'une fonction Azure dans Visual Studio. La dernière version de IronPDF prend en charge les Azure Functions s'exécutant 'en dehors du processus' ou dans un 'processus isolé', comme décrit dans le "[Guide pour exécuter les Azure Functions C# dans le modèle de travailleur isolé](https://docs.microsoft.com/en-us/azure/azure-functions/dotnet-isolated-process-guide#differences-with-net-class-library-functions)." Cependant, les versions plus anciennes pourraient ne pas prendre en charge ces types de Azure Functions.  ## Problème de dépendances lors de l'exécution des Azure Functions localement Lors de l'exécution d'Azure localement, en utilisant Azurite (VS2022) ou l'émulateur de stockage Azure (VS2019), un répertoire bin supplémentaire est créé que l'émulateur de stockage utilise pour le déploiement. Seuls les fichiers DLL sont copiés dans ce répertoire, donc les logiciels qui nécessitent des fichiers supplémentaires ne fonctionnent pas et peuvent générer l'exception ci-dessus. Vous pouvez résoudre ce problème en copiant le répertoire runtimes dans le répertoire bin séparé utilisé par l'émulateur de stockage. Nous recommandons de faire cela comme un **événement post-construction** (voir ci-dessous pour les instructions) lors de l'exécution locale (car la recompilation/construction ramènera le répertoire bin à son état d'origine). Vous ne rencontrerez pas ce problème lors du déploiement dans le cloud. - **Problème :** Lorsque vous exécutez un projet de fonction Azure localement, il crée un dossier _bin_ supplémentaire à partir duquel il exécute la fonction. Cependant, il ne copie pas tous les fichiers nécessaires dans ce dossier _bin_. - **Exemple :** Un projet à _C:\code\azure-functions-test_ qui se construit à _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1_ - **Solution :** Copiez le répertoire _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes_ afin qu'il existe également dans _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin_ - Remplacez tous les fichiers existants si on vous le demande  ## Événement post-construction Pour automatiser le processus de copie des fichiers nécessaires dans le répertoire bin local de la fonction Azure, suivez ces instructions pour configurer un *événement post-construction* dans Visual Studio : 1. Faites un clic droit sur le projet de Azure Functions, sélectionnez **Propriétés**. 2. Faites défiler jusqu'à la section **Événements**. 3. Entrez un **événement post-construction** comme indiqué ci-dessous : ```shell XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D ``` Cette commande va : - Copier le contenu du répertoire _runtimes_ dans le répertoire _bin/runtimes_. - Les commutateurs `/S` et `/E` garantissent que tous les sous-répertoires et répertoires vides sont inclus. - Le commutateur `/Y` supprime la demande de confirmation pour écraser un fichier de destination existant. - Le commutateur `/I` suppose que la destination est un répertoire si elle n'existe pas. - Le commutateur `/R` écrase les fichiers en lecture seule. - Le commutateur `/D` copie les fichiers modifiés à la date spécifiée ou après. 

• ---

• 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

Problèmes lors de l'exécution d'Azure localement

Une exception courante rencontrée lors de ce problème est "Erreur lors de la localisation du fichier de configuration de déploiement IronPdf.Native.Chrome.deployment.json."

Recommandé : Exécutez des Azure Function Apps hébergées sous Windows ciblant .NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>

Requis : Utilisez la configuration par défaut "in-process" lors de la création d'une fonction Azure dans Visual Studio. La dernière version de IronPDF prend en charge les Azure Functions s'exécutant 'en dehors du processus' ou dans un 'processus isolé', comme décrit dans le "Guide pour exécuter les Azure Functions C# dans le modèle de travailleur isolé." Cependant, les versions plus anciennes pourraient ne pas prendre en charge ces types de Azure Functions.

Problème de dépendances lors de l'exécution des Azure Functions localement

Lors de l'exécution d'Azure localement, en utilisant Azurite (VS2022) ou l'émulateur de stockage Azure (VS2019), un répertoire bin supplémentaire est créé que l'émulateur de stockage utilise pour le déploiement. Seuls les fichiers DLL sont copiés dans ce répertoire, donc les logiciels qui nécessitent des fichiers supplémentaires ne fonctionnent pas et peuvent générer l'exception ci-dessus.

Vous pouvez résoudre ce problème en copiant le répertoire runtimes dans le répertoire bin séparé utilisé par l'émulateur de stockage. Nous recommandons de faire cela comme un événement post-construction (voir ci-dessous pour les instructions) lors de l'exécution locale (car la recompilation/construction ramènera le répertoire bin à son état d'origine). Vous ne rencontrerez pas ce problème lors du déploiement dans le cloud.

• Problème : Lorsque vous exécutez un projet de fonction Azure localement, il crée un dossier bin supplémentaire à partir duquel il exécute la fonction. Cependant, il ne copie pas tous les fichiers nécessaires dans ce dossier bin.
• Exemple : Un projet à C:\code\azure-functions-test qui se construit à C:\code\azure-functions-test\bin\Debug\netcoreapp3.1
• Solution : Copiez le répertoire C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes afin qu'il existe également dans C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin
• Remplacez tous les fichiers existants si on vous le demande

Événement post-construction

Pour automatiser le processus de copie des fichiers nécessaires dans le répertoire bin local de la fonction Azure, suivez ces instructions pour configurer un événement post-construction dans Visual Studio :

1. Faites un clic droit sur le projet de Azure Functions, sélectionnez Propriétés.
2. Faites défiler jusqu'à la section Événements.
3. Entrez un événement post-construction comme indiqué ci-dessous :

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

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

Cette commande va :

• Copier le contenu du répertoire runtimes dans le répertoire bin/runtimes.
• Les commutateurs /S et /E garantissent que tous les sous-répertoires et répertoires vides sont inclus.
• Le commutateur /Y supprime la demande de confirmation pour écraser un fichier de destination existant.
• Le commutateur /I suppose que la destination est un répertoire si elle n'existe pas.
• Le commutateur /R écrase les fichiers en lecture seule.
• Le commutateur /D copie les fichiers modifiés à la date spécifiée ou après.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

...

Lire la suite