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)
• Mínimo 50 MB 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 listan primero con la versión más nueva preseleccionada; las personalidades de C++Builder se listan por separado y están desactivadas de forma predeterminada
3. Seleccione el contenido opcional: Marque C++Builder o Lazarus solo cuando deban instalarse esos archivos de paquete y proyectos de demostración
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 agregarán a la paleta losLab:
   • TPdf - Componente central 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 luego copia solo las carpetas de ayuda seleccionadas por el nombre de locale de Windows y el LCID del idioma de la interfaz
• La ayuda en inglés usa en-GB para los locales británicos, de la Commonwealth y caribeños compatibles; en-US se usa para los demás locales en inglés y como reserva cuando no coincide ninguna ayuda regional
• La ayuda en español se divide entre es para locales de España y es-419 para locales de América Latina; la ayuda en chino se divide entre zh-cn y zh-tw
• Cuando están disponibles, se agregan ayudas localizadas coincidentes para los idiomas o nombres de locale en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, portugués, ruso, sueco, turco y chino
• Las compilaciones de demostración posteriores a la instalación para Delphi y C++Builder usan la raíz de RAD Studio más reciente seleccionada y requieren la personalidad correspondiente de Delphi o C++Builder 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 biblioteca de su IDE
2. Agregue la ruta de biblioteca a los directorios de búsqueda de su IDE
3. Instale el paquete de tiempo de diseño mediante el administrador de paquetes del IDE
4. Reconstruya su IDE para registrar los componentes

Plataformas nativas Free Pascal y LCL

Las compilaciones nativas del wrapper requieren un compilador Free Pascal, Lazarus/LCL y una biblioteca compartida de 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 los ejecutables y las unidades nativas en directorios separados por destino, con el widget set seleccionado. Proporcione las rutas correspondientes de unidades LCL y lazutils y use la configuración real de destino del compilador; los archivos DCU/PPU y DLL de Windows no se pueden reutilizar como salidas Unix

Establezca LibraryName con la ruta prevista de libpdfium.so o libpdfium.dylib antes de cargar. Un runtime común 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 demuestra que las incluya

El acceso a fuentes del sistema usa fontconfig en Linux y CoreText en macOS; la creación opcional de subconjuntos de fuentes CID usa HarfBuzz conservando los IDs de glifos. Los bitmaps LCL usan su orden real de bytes y descripción de canales, con conversión cuando no se puede usar directamente la disposición del búfer nativo

Tests/PlatformAcceptance/run_native.py y NativeWrapper.lpr proporcionan aceptación nativa vinculada al código fuente para carga, renderizado, texto, formularios, guardado, cancelación y ciclo de vida. Ejecute el programa de destino en su host real y conserve el informe; un inventario de preparación o una compilación cruzada exitosa por sí solos no bastan

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

Redistribución

Al distribuir aplicaciones que usan PDFium VCL:

• Incluya el árbol DLLs\Win32\pdfium.dll o DLLs\Win64\pdfium.dll correspondiente junto a su aplicación o en una carpeta de aplicación superior
• Para el soporte de 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 tiempo de ejecución adicionales
• Distribución libre de regalías para las aplicaciones compiladas

Solución de problemas

Desinstalación

Para quitar 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. Quite manualmente los archivos restantes si es necesario