Dépannage des dépendances Chrome dans IronPDF
Le moteur de rendu HTML de Google Chromium est un élément essentiel du processus de rendu "Html To PDF" d'IronPDF. Le binaire essentiel pour ce moteur de rendu devrait être facilement trouvé dans le paquet NuGet IronPDF. L'absence de ce binaire dans le dossier du projet entraînera l'erreur suivante :
Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'
Si IronPDF n'est pas en mesure de déployer automatiquement les dépendances Chrome, il peut être nécessaire de les ajouter manuellement à un projet via NuGet. Plusieurs dépendances peuvent être ajoutées :
- IronPdf.Native.Chrome.Windows
- IronPdf.Native.Chrome.Linux
[{i:(Dans les versions ultérieures de IronPDF, les binaires requis seront automatiquement téléchargés depuis la source NuGet en fonction du système d'exploitation utilisé lors de l'exécution, s'ils sont absents du dossier du projet. Cela réussira tant que le projet est connecté à Internet et dispose des autorisations de lecture, d'écriture et d'exécution pour le dossier du projet.
Sur Windows, il est conseillé de s'assurer que le système d'exploitation cible dispose des runtimes Visual C++ installés. De nombreuses applications modernes ne peuvent fonctionner sans ce composant essentiel du système d'exploitation.
Nous avons également des guides de compatibilité pour Linux et Docker
Linux
- S'assurer que le bon fichier Docker est utilisé
- Utilisez le paquet NuGet IronPdf.Linux, au lieu d'IronPdf
- Définir
IronPdf.Installation.ChromeGpuMode=IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
- Définir
Installation.LinuxAndDockerDependenciesAutoConfig=false;
MacOs
* Vérifiez que le runtime Dotnet est configuré correctement - x64 ou arm64
Que faire si cela ne résout pas le problème ?
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énieurs. Veuillez envoyer un rapport de bogue par courrier électronique à support@ironsoftware.com . Tous les problèmes de compatibilité seront sérieusement examinés par un ingénieur expérimenté.
N'oubliez pas de nous indiquer le système d'exploitation/la plateforme sur lequel/laquelle le déploiement est effectué, en particulier s'il s'agit d'une plateforme en nuage comme AWS ou Azure.
Comment activer la journalisation native dans IronPDF ?
Le fait de joindre des fichiers journaux à un rapport de bogue fait plus que doubler la probabilité que nous puissions isoler le problème et le résoudre rapidement
Placez ceci en haut de votre code, avant d'exécuter toute méthode IronPDF (toutes les versions après 2021.3.1).
IronPdf.Logging.Logger.LogFilePath = "Default.log"; //May be set to a directory name or full file
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. (Rendu & Threading)
IronSoftwareEngine.log (Utile pour le débogage des exceptions commençant par "Erreur lors de la génération du PDF depuis...")
Les serveurs en nuage ont souvent des emplacements spécifiques pour les fichiers journaux. Nous avons des guides pour générer des fichiers journaux dans Azure et AWS.