IronPDFにおけるChrome依存のトラブルシューティング

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を介して手動でプロジェクトに追加する必要があります。 複数の依存関係を追加できます:

BRACKET-i-OPEN--@IronPdfの後のバージョンでは、必要なバイナリがプロジェクトフォルダにない場合、実行時に使用されるOSに基づいてNuGetソースから自動的にダウンロードされます。 プロジェクトがインターネットに接続され、プロジェクトフォルダへの読み取り、書き込み、実行権限がある限り、これは成功します。

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

LinuxDockerの互換性ガイドもあります。

Linux

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

    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;
    $vbLabelText   $csharpLabel

MacOS

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

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

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

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

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

Attaching log files to a bug report more than doubles the probability that we can isolate the issue and solve it rapidly.

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

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

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

クラウドサーバーにはしばしばログファイルのための特定の場所があります。 私たちは、AzureおよびAWSでのログファイル生成のガイドを持っています。

カーティス・チャウ
テクニカルライター

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

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

準備はできましたか?
Nuget ダウンロード 17,012,929 | バージョン: 2025.12 リリース