インストール - PDFium Delphi Component

インストール手順

インストーラーの実行: PDFiumPas-FULL.exe または PDFiumPas-TRIAL.exe を管理者として実行します

IDE 統合の選択: RAD Studio Integration ページでは、検出された Delphi personality が最新バージョンを事前チェックした状態で先頭に一覧表示され、C++Builder personality は別個に一覧表示され、既定ではオフになります

オプションコンテンツの選択: C++Builder または Lazarus のパッケージファイルとデモプロジェクトをインストールする場合にだけチェックします

インストールパスの選択: コンポーネントをインストールするディレクトリを選択します

インストールの完了: 画面の指示に従います

インストールの確認: 次のコンポーネントが losLab パレットに追加されます:

TPdf - 中核となる PDF 操作コンポーネント
TPdfView - PDF 表示と操作のコンポーネント

ローカライズ済みヘルプとデモビルド

インストーラーは共有の Docs リソースを常にインストールし、その後で Windows locale name と UI language LCID によって選択されたヘルプ言語フォルダーだけをコピーします

英語ヘルプは、対応する British、Commonwealth、Caribbean English locales に対しては en-GB を使用します。その他の English locales では en-US が使われ、一致する地域ヘルプセットがない場合のフォールバックにもなります

スペイン語ヘルプは、スペイン式 locales 向けの es とラテンアメリカ系 locales 向けの es-419 に分かれています。中国語ヘルプは zh-cn と zh-tw に分かれています

Arabic、German、French、Italian、Japanese、Korean、Dutch、Polish、Portuguese、Russian、Swedish、Turkish、Chinese の各 UI language や locale name に対しては、利用可能な場合に一致するローカライズ済みヘルプセットが追加されます

インストール後の Delphi と C++Builder のデモビルドは、選択された最新の RAD Studio root を使用し、対応する Delphi または C++Builder personality と要求された Win32 / Win64 コンパイラを必要とします

手動インストール（上級者向け）

自動インストールが失敗した場合は、コンポーネントを手動でインストールできます:

コンポーネントファイルを IDE のライブラリパスへコピーします

IDE の検索ディレクトリにライブラリパスを追加します

IDE の Package Manager からデザインタイムパッケージをインストールします

IDE を再構築してコンポーネントを登録します

ネイティブ Free Pascal と LCL 環境

ネイティブのラッパーをビルドするには、OS と CPU に合う Free Pascal コンパイラ、Lazarus/LCL、PDFium 共有ライブラリを使います。検証済み構成は FPC 3.3.1 と LCL 4.99、Linux x86_64 の Qt6、macOS arm64 の Cocoa です

選択した widget set で、target ごとに分けたディレクトリへネイティブの実行ファイルと unit をビルドしてください。対応する LCL／lazutils の unit path と、コンパイラの実際の target 設定が必要です。Windows の DCU/PPU や DLL は Unix の出力に再利用できません

読み込み前に LibraryName を対象の libpdfium.so または libpdfium.dylib のパスに設定します。通常版／V8 runtime は target と一致し、要求する機能を公開する必要があります。不足する V8/XFA 機能は利用不可のままで、ファイル名だけでは機能の存在を判断できません

システムフォントは Linux の fontconfig、macOS の CoreText で取得します。オプションの CID フォントの subset は HarfBuzz を使い、glyph ID を保持します。LCL のビットマップは実際の byte order と channel 定義を使い、ネイティブのバッファ配置を直接使えない場合は変換します

Tests/PlatformAcceptance/run_native.py と NativeWrapper.lpr はソースに結び付いたネイティブの受け入れ検証を提供し、読み込み、描画、テキスト、フォーム、保存、キャンセル、ライフサイクルを確認します。実際の host で対象の実行ファイルを動かし、報告を保存してください。準備状況の一覧や cross-compile の成功だけでは不十分です

Windows installer と VCL/C++Builder プロジェクトは引き続き Windows のセットアップ経路です。ネイティブ Delphi macOS の暗号／タイムスタンプヘルパーは、FPC/LCL の表示コンポーネントと別に検証します

再頒布

トラブルシューティング

よくある問題:

コンポーネントが表示されない: インストール後に IDE を再起動したことを確認します
実行時エラー: 正しい PDFium DLL が DLLs\Win32 または DLLs\Win64、あるいはアプリケーションのパス直下に存在することを確認します
アクセス違反: 必要な依存関係がすべてインストールされており、DLL のアーキテクチャがアプリケーション (32-bit と 64-bit) と一致していることを確認します
デザインタイムエラー: パッケージを再構築し、IDE を再起動します
XFA フォームが動作しない: 対応する pdfium.v8.dll がプラットフォームの DLLs フォルダーに存在し、読み込み前に EnableV8Engine が設定されていることを確認します

アンインストール

PDFium VCL コンポーネントを削除するには:

Windows のプログラムの追加と削除を使用します

または、インストールディレクトリからアンインストーラーを実行します

必要に応じて、残っているファイルを手動で削除します

インストールガイド

システム要件