IronPDF 中 Chrome 浏览器依赖关系的故障排除
2022年一月19日
更新 2024年十月20日
This article was translated from English: Does it need improvement?
TranslatedView the article in English
Google Chromium HTML渲染器是IronPDF的“Html To PDF”渲染过程中的重要组成部分。 此渲染器的必需二进制文件应该可以在IronPDF NuGet包中轻松找到。 项目文件夹中缺少此二进制文件将引发以下错误：
Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop' 如果 IronPDF 无法自动部署 Chrome 依赖项，则可能需要通过 NuGet 手动将它们添加到项目中。 可以添加多个依赖项：
- IronPdf.Native.Chrome.Windows
- IronPdf.Native.Chrome.Linux
在 IronPDF 的后续版本中，如果项目文件夹中缺少所需的二进制文件，将根据运行时使用的操作系统从 NuGet 源自动下载。 只要项目连接到互联网并且对项目文件夹具有读取、写入和执行权限，这将会成功。
在 Windows 上，确保目标操作系统已安装Visual C++ Runtimes是个好主意。 许多现代应用程序离不开这个必要的操作系统组件。
Linux
- 确保使用正确的 Docker 文件
- 使用 IronPdf.Linux NuGet 包，而不是 IronPdf。
- 设置
IronPdf.Installation.ChromeGpuMode=IronPdf.Engines.Chrome.ChromeGpuModes.Disabled; - 设置
Installation.LinuxAndDockerDependenciesAutoConfig=false;
MacOs
* 检查 Dotnet 运行时设置是否正确 - x64 或 arm64
如果那不能解决问题怎么办？
如果这不能解决问题，我们随时愿意提供帮助。兼容性是我们工程团队的重中之重。 请将电子邮件错误报告发送至 support@ironsoftware.com 。 所有兼容性问题都将由高级工程师认真审查。
请务必告诉我们您要部署到的操作系统/平台，尤其是如果它是像AWS或Azure这样的云平台。
如何在IronPDF中启用原生日志记录
将日志文件附加到错误报告中，将使我们隔离问题并迅速解决的可能性增加一倍以上。
在运行任何IronPDF方法之前，将其放置在代码的顶部（所有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;IronPDF 创建的日志文件位于项目的 /bin 目录中，您的 DLLs 部署在这里：
- default.log（部署过程）
- cef.log（渲染）
- IronSoftwareCefSubprocess.log. 渲染与线程
IronSoftwareEngine.log（用于调试以“从...生成PDF出错”开头的异常）
