Dépannage des dépendances Chrome dans IronPDF

Curtis Chau

Updated: 17 septembre 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épannage des dépendances Chrome dans IronPDF Le rendu HTML de Google Chromium est une partie essentielle du processus de rendu "Html to PDF" d'IronPDF. Le binaire essentiel pour ce rendu devrait être facilement trouvé dans le package NuGet d'IronPDF. L'absence de ce binaire du dossier du projet entraînera l'erreur suivante : ```txt Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'. ``` Si IronPDF est incapable de déployer automatiquement les dépendances Chrome, elles devront peut-être être ajoutées à un projet manuellement via NuGet. Plusieurs dépendances peuvent être ajoutées : - [`IronPdf.Native.Chrome.Windows`](https://www.nuget.org/packages/IronPdf.Native.Chrome.Windows/) - [`IronPdf.Native.Chrome.Linux`](https://www.nuget.org/packages/IronPdf.Native.Chrome.Linux/) - [`IronPdf.Native.Chrome.MacOS`](https://www.nuget.org/packages/IronPdf.MacOs) [[i :Dans les versions ultérieures d'IronPDF, les binaires requis seront automatiquement téléchargés à partir de la source NuGet en fonction du système d'exploitation utilisé pendant l'exécution, s'ils sont absents du dossier du projet. Cela réussira tant que le projet est connecté à Internet et qu'il dispose des autorisations de lecture, d'écriture et d'exécution sur le dossier du projet.)]] Sous Windows, il est bon de s'assurer que le système d'exploitation cible a installé les [runtimes Visual C++](/troubleshooting/visual-c-redistributable-for-visual-studio-ironpdf/). De nombreuses applications modernes ne peuvent pas fonctionner sans ce composant essentiel du système d'exploitation. Nous avons également des guides de compatibilité pour [Linux](/get-started/linux/) et [Docker](/get-started/ironpdf-docker/). ## Linux - Assurez-vous que le bon fichier Docker est utilisé. - Utilisez le paquet NuGet IronPdf.Linux au lieu d'IronPDF. - Désactivez le mode GPU pour le rendu Chrome : ```csharp IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled; ``` - Désactivez la configuration automatique pour les dépendances Linux et Docker : ```csharp csharp Installation.LinuxAndDockerDependenciesAutoConfig = false; ``` ## MacOS - Vérifiez que l'environnement d'exécution .NET est réglé sur la bonne architecture : x64 ou arm64. ### Que faire si cela ne le résout pas ? Si cela ne résout pas le problème, nous sommes là pour vous aider. La compatibilité est une priorité pour notre équipe d'ingénierie. Veuillez envoyer un rapport de bug par email à [support@ironsoftware.com](mailto:support@ironsoftware.com). Tous les problèmes de compatibilité seront sérieusement examinés par un ingénieur senior. Assurez-vous de nous informer du système d'exploitation/plateforme déployé, surtout s'il s'agit d'une plateforme cloud comme AWS ou Azure. #### Comment activer la journalisation native dans IronPDF Joindre des fichiers journaux à un rapport de bug plus que *double la probabilité que nous puissions isoler le problème et le résoudre rapidement.* Placez cela en haut de votre code avant d'exécuter les méthodes d'IronPDF (toutes les versions après 2021.3.1) : ```csharp // 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; ``` Les fichiers journaux créés par IronPDF se trouvent dans le répertoire /bin de votre projet où vos DLL sont déployées : - default.log (processus de déploiement) - cef.log (Rendu) - IronSoftwareCefSubprocess.log (rendue & threading) - [IronSoftwareEngine.log](/troubleshooting/timeout-while-rendering-pdf/) (Utile pour déboguer les exceptions débutant par "Erreur lors de la génération du PDF à partir de...") Les serveurs cloud ont souvent des emplacements spécifiques pour les fichiers journaux. Nous avons des guides pour générer des fichiers journaux sur [Azure](/troubleshooting/azure-log-files/) et [AWS](/troubleshooting/aws-log-files/).

• ---

• 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

Le rendu HTML de Google Chromium est une partie essentielle du processus de rendu "Html to PDF" d'IronPDF. Le binaire essentiel pour ce rendu devrait être facilement trouvé dans le package NuGet d'IronPDF. L'absence de ce binaire du dossier du projet entraînera l'erreur suivante :

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

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

Si IronPDF est incapable de déployer automatiquement les dépendances Chrome, elles devront peut-être être ajoutées à un projet manuellement via NuGet. Plusieurs dépendances peuvent être ajoutées :

• IronPdf.Native.Chrome.Windows
• IronPdf.Native.Chrome.Linux
• IronPdf.Native.Chrome.MacOS

[[i :Dans les versions ultérieures d'IronPDF, les binaires requis seront automatiquement téléchargés à partir de la source NuGet en fonction du système d'exploitation utilisé pendant l'exécution, s'ils sont absents du dossier du projet. Cela réussira tant que le projet est connecté à Internet et qu'il dispose des autorisations de lecture, d'écriture et d'exécution sur le dossier du projet.)]]

Sous Windows, il est bon de s'assurer que le système d'exploitation cible a installé les runtimes Visual C++. De nombreuses applications modernes ne peuvent pas fonctionner sans ce composant essentiel du système d'exploitation.

Nous avons également des guides de compatibilité pour Linux et Docker.

Linux

• Assurez-vous que le bon fichier Docker est utilisé.

• Utilisez le paquet NuGet IronPdf.Linux au lieu d'IronPDF.

• Désactivez le mode GPU pour le rendu Chrome :

  IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

  IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

  C#VB

• Désactivez la configuration automatique pour les dépendances Linux et Docker :

  csharp
  Installation.LinuxAndDockerDependenciesAutoConfig = false;

  csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

  C#VB

MacOS

• Vérifiez que l'environnement d'exécution .NET est réglé sur la bonne architecture : x64 ou arm64.

Que faire si cela ne le résout pas ?

Si cela ne résout pas le problème, nous sommes là pour vous aider. La compatibilité est une priorité pour notre équipe d'ingénierie. Veuillez envoyer un rapport de bug par email à support@ironsoftware.com. Tous les problèmes de compatibilité seront sérieusement examinés par un ingénieur senior.

Assurez-vous de nous informer du système d'exploitation/plateforme déployé, surtout s'il s'agit d'une plateforme cloud comme AWS ou Azure.

Comment activer la journalisation native dans IronPDF

Joindre des fichiers journaux à un rapport de bug plus que double la probabilité que nous puissions isoler le problème et le résoudre rapidement.

Placez cela en haut de votre code avant d'exécuter les méthodes d'IronPDF (toutes les versions après 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;

// 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;

' 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

' 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

Les fichiers journaux créés par IronPDF se trouvent dans le répertoire /bin de votre projet où vos DLL sont déployées :

• default.log (processus de déploiement)
• cef.log (Rendu)
• IronSoftwareCefSubprocess.log (rendue & threading)
• IronSoftwareEngine.log (Utile pour déboguer les exceptions débutant par "Erreur lors de la génération du PDF à partir de...")

Les serveurs cloud ont souvent des emplacements spécifiques pour les fichiers journaux. Nous avons des guides pour générer des fichiers journaux sur Azure et AWS.

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