Guía de instalación

Requisitos del sistema

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) hasta Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 o posterior (para Free Pascal)
• Windows XP o posterior (Win32 / Win64)
• 50 MB mínimos de espacio libre en disco

Pasos de instalación

1. Ejecute el instalador: Ejecute PDFiumPas-FULL.exe o PDFiumPas-TRIAL.exe como administrador
2. Seleccione la integración con el IDE: En la página RAD Studio Integration, las personalidades de Delphi detectadas se enumeran primero con la versión más reciente preseleccionada; las personalidades de C++Builder se enumeran por separado y están desmarcadas de forma predeterminada
3. Seleccione el contenido opcional: Marque C++Builder o Lazarus solo cuando deban instalarse esos archivos de paquete y proyectos de demo
4. Elija la ruta de instalación: Seleccione el directorio donde se instalarán los componentes
5. Complete la instalación: Siga las instrucciones en pantalla
6. Verifique la instalación: Los siguientes componentes se añadirán a la paleta losLab:
   • TPdf - Componente principal de manipulación de PDF
   • TPdfView - Componente de visualización e interacción con PDF

Ayuda localizada y compilaciones de demos

• El instalador siempre instala los recursos compartidos de Docs y después copia solo las carpetas de ayuda de idiomas seleccionadas por el nombre de configuración regional de Windows y el LCID del idioma de interfaz de usuario
• La ayuda en inglés usa en-GB para las configuraciones regionales de inglés británico, de la Commonwealth y del Caribe compatibles; en-US se usa para las demás configuraciones regionales de inglés y como alternativa cuando no coincide ningún conjunto de ayuda regional
• La ayuda en español se divide entre es para las configuraciones regionales de España y es-419 para las configuraciones regionales de América Latina; la ayuda en chino se divide entre zh-cn y zh-tw
• Cuando están disponibles, se añaden conjuntos de ayuda localizada coincidentes para los idiomas de interfaz o nombres de configuración regional en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, portugués, ruso, sueco, turco y chino
• Las compilaciones de demos de Delphi y C++Builder posteriores a la instalación usan la raíz de RAD Studio seleccionada más reciente y requieren la personalidad de Delphi o C++Builder correspondiente más el compilador Win32 / Win64 solicitado

Instalación manual (avanzada)

Si la instalación automática falla, puede instalar los componentes manualmente:

1. Copie los archivos de componentes a la ruta de librería de su IDE
2. Añada la ruta de librería a los directorios de búsqueda de su IDE
3. Instale el paquete en tiempo de diseño mediante el gestor de paquetes del IDE
4. Reconstruya su IDE para registrar los componentes

Plataformas nativas Free Pascal y LCL

Las compilaciones del wrapper nativo usan un compilador Free Pascal, Lazarus/LCL y una biblioteca compartida PDFium que coincidan con el sistema operativo y la CPU. Las configuraciones validadas usan FPC 3.3.1 con LCL 4.99, Qt6 en Linux x86_64 y Cocoa en macOS arm64

Compile ejecutables y unidades nativos en directorios de destino separados con el widget set seleccionado. Proporcione las rutas de unidades LCL y lazutils correspondientes y use la configuración de destino real del compilador; los ficheros DCU/PPU y las DLL de Windows no se pueden reutilizar como salidas Unix

Establezca LibraryName en la ruta elegida de libpdfium.so o libpdfium.dylib antes de cargar. El runtime ordinario o V8 debe coincidir con el destino y exponer las funciones solicitadas. Las capacidades V8/XFA ausentes siguen sin estar disponibles; el nombre de la biblioteca no las demuestra

El acceso a fuentes del sistema usa fontconfig en Linux y CoreText en macOS; los subconjuntos opcionales de fuentes CID usan HarfBuzz conservando IDs de glifo. Los bitmaps LCL usan su orden de bytes y descripción de canales reales, con conversión si el layout del búfer nativo no se puede usar directamente

Tests/PlatformAcceptance/run_native.py y NativeWrapper.lpr ofrecen aceptación nativa ligada al código fuente para carga, renderizado, texto, formularios, guardado, cancelación y ciclo de vida. Ejecute el binario de destino en su host real y conserve el informe; un inventario de preparación o una compilación cruzada correcta no bastan

Los instaladores de Windows y los proyectos VCL/C++Builder siguen siendo la vía de instalación para Windows. Los helpers nativos Delphi de criptografía y timestamp en macOS se validan por separado del componente visual FPC/LCL

Redistribución

Al distribuir aplicaciones que usan PDFium VCL:

• Incluya el árbol correspondiente de DLLs\Win32\pdfium.dll o DLLs\Win64\pdfium.dll junto a su aplicación o en una carpeta padre de la aplicación
• Para compatibilidad con formularios V8/XFA, incluya el DLLs\Win32\pdfium.v8.dll o DLLs\Win64\pdfium.v8.dll correspondiente en el mismo árbol de DLLs y establezca EnableV8Engine antes de cargar
• No se requieren licencias de runtime adicionales
• Distribución libre de regalías para aplicaciones compiladas

Solución de problemas

Desinstalación

Para eliminar los componentes de PDFium VCL:

1. Use Agregar o quitar programas de Windows
2. O ejecute el desinstalador desde el directorio de instalación
3. Elimine manualmente los archivos restantes si es necesario