安裝指南

系統需求

Delphi XE5 / C++Builder XE5（RAD Studio XE5）至 Delphi/C++Builder 13.1 Florence（RAD Studio 13.1）
Lazarus 1.0 或更新版本（適用於 Free Pascal）
Windows XP 或更新版本（Win32 / Win64）
至少 50 MB 可用磁碟空間

執行安裝程式：以系統管理員身分執行 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，且在沒有任何區域說明集符合時以 en-US 作為後備
西班牙文說明分為 Spain-style locales 的 es 與 Latin American locales 的 es-419；中文說明分為 zh-cn 與 zh-tw
Arabic、German、French、Italian、Japanese、Korean、Dutch、Polish、Portuguese、Russian、Swedish、Turkish 與 Chinese UI 語言或 locale name，會在存在相符的本地化說明集時一併加入
安裝後的 Delphi 與 C++Builder 範例建置使用最新選取的 RAD Studio root，並需要相符的 Delphi 或 C++Builder personality，以及所要求的 Win32 / Win64 編譯器

若自動安裝失敗，可以手動安裝元件：

原生包裝元件建置需要作業系統與 CPU 相符的 Free Pascal 編譯器、Lazarus/LCL 及 PDFium 共用程式庫。通過驗收的設定使用 FPC 3.3.1 搭配 LCL 4.99、Linux x86_64 上的 Qt6，以及 macOS arm64 上的 Cocoa

請使用選定的 Widget Set，在各自的目標目錄建置原生執行檔與單元。提供對應的 LCL 與 lazutils 單元路徑，並使用編譯器實際的目標設定；Windows DCU/PPU 檔案與 Windows DLL 無法重用為 Unix 輸出

載入前，將 LibraryName 設為預定的 libpdfium.so 或 libpdfium.dylib 路徑。一般或 V8 執行環境必須符合目標平台，並提供所要求的功能。缺少的 V8/XFA 功能仍不可用；僅靠程式庫檔名無法確認這些功能

系統字型在 Linux 透過 fontconfig 存取，在 macOS 則使用 CoreText；可選的 CID 字型子集化使用保留字形 ID 的 HarfBuzz。LCL 點陣圖依其實際位元組順序與通道描述處理，無法直接使用原生緩衝區配置時會進行轉換

Tests/PlatformAcceptance/run_native.py 與 NativeWrapper.lpr 提供與來源綁定的原生驗收，涵蓋載入、繪製、文字、表單、儲存、取消與生命週期檢查。請在實際主機執行目標執行檔並保留報告；僅有準備狀態清單或交叉編譯成功仍不足以完成驗收

Windows 安裝程式與 VCL/C++Builder 專案仍是 Windows 的設定路徑。原生 Delphi macOS 加密與時間戳記輔助功能，和 FPC/LCL 視覺元件分開驗收

散發使用 PDFium VCL 的應用程式時：

在應用程式旁或上層應用程式資料夾中，包含相符的 DLLs\Win32\pdfium.dll 或 DLLs\Win64\pdfium.dll 目錄
若要支援 V8/XFA 表單，請在同一 DLLs 目錄中包含相符的 DLLs\Win32\pdfium.v8.dll 或 DLLs\Win64\pdfium.v8.dll，並在載入前設定 EnableV8Engine
不需要額外的執行階段授權
編譯後的應用程式可免權利金散發

移除 PDFium VCL 元件：