Débogage des Azure Functions sur une machine locale avec IronOCR

Curtis Chau

Updated: 29 juin 2026

Download IronOCR

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Débogage des Azure Functions sur une machine locale avec IronOCR ## Problèmes lors de l'exécution locale d'Azure Les exceptions courantes rencontrées lors de ce problème sont les suivantes : - Erreur lors du déploiement de Tesseract pour IronOCR - Impossible de localiser 'libtesseract-5' - Impossible de localiser 'libtesseract-5' - Impossible de localiser Tesseract-5 - Erreur lors de la localisation du fichier de configuration de déploiement à l'emplacement \bin\runtimes\win-x64\native\IronOcr.Native.deployment.json - IronOCR : fichier .traineddata manquant pour 'EnglishBest' qui devrait se trouver à ## Problème de Dépendances lors de l'Exécution d'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 d'effectuer cette opération après la compilation (voir ci-dessous pour les instructions) lors d'une exécution locale (car la recompilation/compilation 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  ## Étapes de l'événement post-construction 1. Cliquez avec le bouton droit sur le projet Azure Functions, puis sélectionnez Propriétés. 2. Faites défiler vers le bas jusqu'à la section Événements. 3. Saisissez une commande d'événement post-compilation qui copiera tous les fichiers requis dans le répertoire approprié : ```shell XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D ``` - **Explication:** - `XCOPY` est utilisé pour copier des fichiers et des arbres de répertoire. - `$(TargetDir)runtimes` est le répertoire source où les fichiers runtime sont initialement compilés. - `$(TargetDir)bin\runtimes` est le répertoire de destination pour les fichiers runtime lorsque l'application est exécutée localement. - Options : - `/S` copie les répertoires et sous-répertoires sauf ceux vides. - `/E` copie tous les sous-répertoires, y compris ceux vides. - `/Y` supprime la confirmation pour écraser les fichiers existants. - `/I` si la destination n'existe pas et que plus d'un fichier est copié, suppose que la destination doit être un répertoire. - `/R` écrase les fichiers en lecture seule. - `/D` copie uniquement les fichiers qui sont plus récents ou manquants à la destination. 

• ---

• 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 locale d'Azure

Les exceptions courantes rencontrées lors de ce problème sont les suivantes :

• Erreur lors du déploiement de Tesseract pour IronOCR
• Impossible de localiser 'libtesseract-5'
• Impossible de localiser 'libtesseract-5'
• Impossible de localiser Tesseract-5
• Erreur lors de la localisation du fichier de configuration de déploiement à l'emplacement \bin\runtimes\win-x64\native\IronOcr.Native.deployment.json
• IronOCR : fichier .traineddata manquant pour 'EnglishBest' qui devrait se trouver à

Problème de Dépendances lors de l'Exécution d'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 d'effectuer cette opération après la compilation (voir ci-dessous pour les instructions) lors d'une exécution locale (car la recompilation/compilation 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

Étapes de l'événement post-construction

1. Cliquez avec le bouton droit sur le projet Azure Functions, puis sélectionnez Propriétés.

2. Faites défiler vers le bas jusqu'à la section Événements.

3. Saisissez une commande d'événement post-compilation qui copiera tous les fichiers requis dans le répertoire approprié :

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

   SHELL
   • Explication:
     • XCOPY est utilisé pour copier des fichiers et des arbres de répertoire.
     • $(TargetDir)runtimes est le répertoire source où les fichiers runtime sont initialement compilés.
     • $(TargetDir)bin\runtimes est le répertoire de destination pour les fichiers runtime lorsque l'application est exécutée localement.
     • Options :
       • /S copie les répertoires et sous-répertoires sauf ceux vides.
       • /E copie tous les sous-répertoires, y compris ceux vides.
       • /Y supprime la confirmation pour écraser les fichiers existants.
       • /I si la destination n'existe pas et que plus d'un fichier est copié, suppose que la destination doit être un répertoire.
       • /R écrase les fichiers en lecture seule.
       • /D copie uniquement les fichiers qui sont plus récents ou manquants à la destination.

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