Руководство по установке

Системные требования

• 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 МБ свободного места на диске

Шаги установки

1. Запустите установщик: выполните PDFiumPas-FULL.exe или PDFiumPas-TRIAL.exe от имени администратора
2. Выберите интеграцию с IDE: на странице RAD Studio Integration обнаруженные personality Delphi перечислены первыми, с заранее отмеченной новейшей версией; personality C++Builder перечислены отдельно и по умолчанию выключены
3. Выберите дополнительное содержимое: отмечайте C++Builder или Lazarus, только если эти файлы пакетов и демо-проекты действительно нужно установить
4. Выберите путь установки: укажите каталог, в который будут установлены компоненты
5. Завершите установку: следуйте инструкциям на экране
6. Проверьте установку: на палитру losLab будут добавлены следующие компоненты:
   • TPdf — основной компонент для работы с PDF
   • TPdfView — компонент просмотра и взаимодействия с PDF

Локализованная справка и демо-сборки

• Установщик всегда устанавливает общие ресурсы Docs, а затем копирует только папки справки для языков, выбранных по имени локали Windows и LCID языка интерфейса
• Английская справка использует en-GB для поддерживаемых британских, стоящих в Содружестве и карибских англоязычных локалей; en-US применяется для остальных английских локалей и как запасной вариант, когда ни один региональный набор справки не совпал
• Испанская справка разделена между es для локалей в стиле Испании и es-419 для латиноамериканских локалей; китайская справка разделена между zh-cn и zh-tw
• Совпадающие локализованные наборы справки добавляются, когда они доступны, для арабского, немецкого, французского, итальянского, японского, корейского, нидерландского, польского, португальского, русского, шведского, турецкого и китайского языков интерфейса или имён локалей
• Демо-сборки Delphi и C++Builder после установки используют последний выбранный корневой каталог RAD Studio и требуют соответствующую personality Delphi или C++Builder плюс запрошенный компилятор Win32 / Win64

Ручная установка (дополнительно)

Если автоматическая установка завершилась неудачей, компоненты можно установить вручную:

1. Скопируйте файлы компонентов в библиотечный путь IDE
2. Добавьте библиотечный путь в каталоги поиска IDE
3. Установите пакет времени проектирования через менеджер пакетов IDE
4. Пересоберите IDE, чтобы зарегистрировать компоненты

Нативные платформы Free Pascal и LCL

Нативные сборки обёртки используют согласованный с ОС и CPU компилятор Free Pascal, Lazarus/LCL и разделяемую библиотеку PDFium. Квалифицированные конфигурации используют FPC 3.3.1 с LCL 4.99, Qt6 в Linux x86_64 и Cocoa в macOS arm64

Собирайте нативные исполняемые файлы и модули в отдельных целевых каталогах с выбранным набором виджетов. Укажите соответствующие пути модулей LCL и lazutils и используйте фактическую целевую конфигурацию компилятора; файлы DCU/PPU Windows и DLL Windows нельзя переиспользовать как вывод Unix

Установите LibraryName в предполагаемый путь libpdfium.so или libpdfium.dylib перед загрузкой. Обычный runtime или runtime V8 должен соответствовать этой цели и предоставлять запрошенные возможности. Отсутствующие возможности V8/XFA остаются недоступными возможностями; имя файла библиотеки их не устанавливает

Доступ к системным шрифтам использует fontconfig в Linux и CoreText в macOS; необязательное построение подмножества CID-шрифтов использует 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\Win32\pdfium.v8.dll или DLLs\Win64\pdfium.v8.dll в то же дерево DLLs и установите EnableV8Engine перед загрузкой
• Дополнительные лицензии времени выполнения не требуются
• Распространение скомпилированных приложений без отчислений

Устранение неполадок

Удаление

Чтобы удалить компоненты PDFium VCL:

1. Используйте средство Windows «Установка и удаление программ»
2. Или запустите деинсталлятор из каталога установки
3. При необходимости вручную удалите оставшиеся файлы