Installation Guide

System Requirements

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) to Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 or later (for Free Pascal)
• Windows XP or later (Win32 / Win64)
• Minimum 50 MB free disk space

Installation Steps

1. Run the installer: Execute PDFiumPas-FULL.exe or PDFiumPas-TRIAL.exe as Administrator
2. Select IDE integration: On the RAD Studio Integration page, detected Delphi personalities are listed first with the newest version pre-ticked; C++Builder personalities are listed separately and are off by default
3. Select optional content: Tick C++Builder or Lazarus only when those package files and demo projects should be installed
4. Choose installation path: Select the directory where components will be installed
5. Complete installation: Follow the on-screen instructions
6. Verify installation: The following components will be added to the losLab palette:
   • TPdf - Core PDF manipulation component
   • TPdfView - PDF viewing and interaction component

Localised Help and Demo Builds

• The installer always installs the shared Docs assets and then copies only the help language folders selected by the Windows locale name and UI language LCID
• English help uses en-GB for supported British, Commonwealth, and Caribbean English locales; en-US is used for other English locales and as the fallback when no regional help set matches
• Spanish help is split between es for Spain-style locales and es-419 for Latin American locales; Chinese help is split between zh-cn and zh-tw
• Matching localised help sets are added when available for Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Swedish, Turkish, and Chinese UI languages or locale names
• Post-install Delphi and C++Builder demo builds use the latest selected RAD Studio root and require the matching Delphi or C++Builder personality plus the requested Win32 / Win64 compiler

Manual Installation (Advanced)

If automatic installation fails, you can manually install the components:

1. Copy the component files to your IDE's library path
2. Add the library path to your IDE's search directories
3. Install the design-time package through IDE's Package Manager
4. Rebuild your IDE to register the components

Native Free Pascal and LCL targets

Native wrapper builds require Free Pascal, Lazarus/LCL and a PDFium shared library matching the host OS and CPU. Qualified configurations use FPC 3.3.1 and LCL 4.99, with Qt6 on Linux x86_64 or Cocoa on macOS arm64

Build each target's executables and units in its own directory using the chosen widget set. Provide matching LCL and lazutils unit paths and the compiler's real target configuration; Windows DCU/PPU files or DLLs cannot serve as Unix output

Before loading, set LibraryName to the intended libpdfium.so or libpdfium.dylib. Both ordinary and V8 runtimes must match the target and export the requested features; absent V8/XFA capabilities stay unavailable, regardless of the library's filename

Linux system fonts are accessed through fontconfig and macOS fonts through CoreText; optional CID subsetting uses HarfBuzz whilst retaining glyph IDs. LCL bitmap handling follows actual byte order and channel descriptions, converting when a native buffer cannot be used directly

Tests/PlatformAcceptance/run_native.py and NativeWrapper.lpr provide source-bound native acceptance for loading, rendering, text, forms, saving, cancellation and lifecycle checks. Execute the target binary on its actual host and keep its report; an inventory of readiness or a successful cross-compile is not sufficient

Windows installers and VCL/C++Builder projects remain the Windows installation route. Native Delphi macOS crypto and timestamp helper qualification is separate from the FPC/LCL visual component

Redistribution

When distributing applications that use PDFium VCL:

• Include the matching DLLs\Win32\pdfium.dll or DLLs\Win64\pdfium.dll tree beside your application or in a parent application folder
• For V8/XFA form support, include the matching DLLs\Win32\pdfium.v8.dll or DLLs\Win64\pdfium.v8.dll in the same DLLs tree and set EnableV8Engine before loading
• No additional runtime licences required
• Royalty-free distribution for compiled applications

Troubleshooting

Uninstallation

To remove PDFium VCL components:

1. Use Windows Add/Remove Programs
2. Or run the uninstaller from the installation directory
3. Manually remove any remaining files if necessary