安装指南

系统要求

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 区域名称和 UI 语言 LCID 选中的帮助语言目录
英文帮助对受支持的英式、英联邦和加勒比地区英语区域使用 en-GB；其他英语区域使用 en-US，并在没有匹配的区域帮助集时作为回退
西班牙语帮助分为面向西班牙式区域的 es 和面向拉丁美洲区域的 es-419；中文帮助分为 zh-cn 和 zh-tw
当阿拉伯语、德语、法语、意大利语、日语、韩语、荷兰语、波兰语、葡萄牙语、俄语、瑞典语、土耳其语和中文 UI 语言或区域名称存在匹配的本地化帮助集时，会加入对应帮助集
安装后阶段的 Delphi 和 C++Builder 示例编译使用最新选定的 RAD Studio 根目录，并要求对应的 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 字体子集使用 HarfBuzz 并保留 glyph ID。LCL 位图按实际字节序和通道描述处理，原生缓冲区布局无法直接使用时执行转换

Tests/PlatformAcceptance/run_native.py 与 NativeWrapper.lpr 提供与源码对应的原生验收，覆盖加载、渲染、文本、表单、保存、取消和生命周期检查。须在真实目标主机运行可执行程序并保留报告；仅有就绪清单或交叉编译成功并不足够

Windows 安装程序和 VCL/C++Builder 项目仍是 Windows 的配置路径。原生 Delphi macOS 加密与时间戳 helper 的验收独立于 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 组件：