部署 Chrome 依赖时出错

Translated

View 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中，所需的二進制文件將根據運行時使用的操作系統自動從NuGet來源下載，如果它們在專案資料夾中不存在。只要專案連接到互聯網並且對專案資料夾具有讀取、寫入和執行的權限，這將會成功。

在 Windows 上，確保目標操作系統具備 Visual C++ 執行階段程式庫已安裝。許多現代應用程式無法在沒有這個基本操作系統元件的情況下運行。

我們也有相容性指南可供參考。 Linux 和 Docker

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 目錄中，您的 DLL 部署在該目錄中：

default.log (部署過程)
cef.log (渲染)
IronSoftwareCefSubprocess.log. (渲染與執行緒)
IronSoftwareEngine.log (有助於調試以「Error generating PDF from...」開頭的異常。 )

雲伺服器通常具有特定位置的日誌文件。我們有生成日誌文件的指南在 Azure 和 AWS.

部署 Chrome 依赖时出错

請注意

Linux