Troubleshooting Chrome Dependencies in IronPDF

This article was translated from English: Does it need improvement?
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を介して手動でプロジェクトに追加する必要があります。 複数の依存関係を追加できます:

[{i:(後のバージョンのIronPDFでは、必要なバイナリは実行時に使用されるOSに基づいて、プロジェクトフォルダに存在しない場合、NuGetソースから自動的にダウンロードされます。 プロジェクトがインターネットに接続されており、プロジェクトフォルダにRead、Write、Executeの権限があれば成功します。)]

Windowsでは、ターゲットオペレーティングシステムにVisual C++ランタイムがインストールされていることを確認すると良いです。 多くの現代的なアプリケーションはこの重要なオペレーティングシステムのコンポーネントがないと実行できません。

We also have compatibility guides for Linux and Docker.

Linux

  • 正しいDockerファイルが使用されていることを確認します。
  • IronPdfの代わりにIronPdf.Linux NuGetパッケージを使用します。
  • ChromeレンダリングのGPUモードを無効に設定:

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
    $vbLabelText   $csharpLabel
  • LinuxとDockerの依存関係の自動設定を無効にします:

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;
    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;
    csharp Installation.LinuxAndDockerDependenciesAutoConfig = False
    $vbLabelText   $csharpLabel

MacOS

  • .NETランタイムが正しいアーキテクチャに設定されていることを確認します - x64またはarm64。

これで解決しない場合はどうすればよいでしょうか?

これで問題が解決しない場合、私たちはお手伝いします。互換性は私たちのエンジニアリングチームにとって最優先です。 バグレポートはsupport@ironsoftware.comまでメールで送信してください。 すべての互換性問題は、熟練したエンジニアによって徹底的にレビューされます。

特にAWSやAzureのようなクラウドプラットフォームを使っている場合、デプロイするオペレーティングシステム/プラットフォームを必ずお知らせください。

IronPDFでネイティブロギングを有効にする方法

ログファイルをバグ報告に添付することで、問題を特定して迅速に解決できる可能性が倍増します。

次のコードを実行する前に、コードの一番上にこれを置いてください(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
$vbLabelText   $csharpLabel

IronPDFによって作成されたログファイルは、DLLがデプロイされたプロジェクトの/binディレクトリにあります:

  • default.log(デプロイメントプロセス)
  • cef.log(レンダリング)
  • IronSoftwareCefSubprocess.log(レンダリング & スレッディング)
  • IronSoftwareEngine.log (「PDFの生成中にエラーが...」で始まる例外のデバッグに役立ちます)

クラウドサーバーにはしばしばログファイルのための特定の場所があります。 We have guides for generating log files in Azure and AWS.

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はいいですか?
Nuget ダウンロード 16,154,058 | バージョン: 2025.11 ただ今リリースされました