Guida all'installazione
Requisiti di sistema
- Da Delphi XE5 / C++Builder XE5 (RAD Studio XE5) a Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
- Lazarus 1.0 o successivo (per Free Pascal)
- Windows XP o successivo (Win32 / Win64)
- Minimo 50 MB di spazio libero su disco
Procedura di installazione
- Esecuzione dell'installer: avviare
PDFiumPas-FULL.exe o PDFiumPas-TRIAL.exe come Administrator
- Selezione dell'integrazione con l'IDE: nella pagina RAD Studio Integration le personality Delphi rilevate sono elencate per prime con la versione più recente già spuntata; le personality C++Builder sono elencate separatamente e sono disattivate per impostazione predefinita
- Selezione del contenuto opzionale: spuntare C++Builder o Lazarus solo quando i file di pacchetto e i progetti demo corrispondenti devono essere installati
- Scelta del percorso di installazione: selezionare la directory in cui verranno installati i componenti
- Completamento dell'installazione: seguire le istruzioni visualizzate sullo schermo
- Verifica dell'installazione: i componenti seguenti verranno aggiunti alla tavolozza losLab:
- TPdf - Componente principale per la manipolazione dei documenti PDF
- TPdfView - Componente per la visualizzazione e l'interazione con i documenti PDF
Guida localizzata e build demo
- L'installer installa sempre le risorse condivise
Docs, poi copia solo le directory delle lingue della guida selezionate dal nome locale Windows e dall'LCID della lingua dell'interfaccia
- La guida inglese usa
en-GB per le impostazioni locali supportate del Regno Unito, Commonwealth e Caraibi; usa en-US per le altre varianti inglesi e come fallback quando nessuna guida regionale corrisponde
- La guida spagnola distingue
es per le impostazioni locali di stile spagnolo e es-419 per quelle latinoamericane; quella cinese distingue zh-cn e zh-tw
- Quando disponibili, vengono aggiunte guide localizzate corrispondenti a nomi locali o lingue dell'interfaccia araba, tedesca, francese, italiana, giapponese, coreana, olandese, polacca, portoghese, russa, svedese, turca e cinese
- Le compilazioni post-installazione dei demo Delphi e C++Builder usano l'ultima radice RAD Studio selezionata e richiedono la corrispondente personality Delphi o C++Builder e il compilatore Win32 / Win64 richiesto
Installazione manuale (avanzata)
Se l'installazione automatica non riesce, è possibile installare i componenti manualmente:
- Copiare i file dei componenti nel percorso di libreria dell'IDE
- Aggiungere il percorso di libreria alle directory di ricerca dell'IDE
- Installare il pacchetto in fase di progettazione tramite il Package Manager dell'IDE
- Ricompilare l'IDE per registrare i componenti
Le build native del wrapper richiedono compilatore Free Pascal, Lazarus/LCL e libreria condivisa PDFium compatibili con OS e CPU. Le configurazioni qualificate usano FPC 3.3.1 con LCL 4.99, Qt6 su Linux x86_64 e Cocoa su macOS arm64
Compilare eseguibili e unit native in directory di destinazione separate con il widget set selezionato. Fornire i percorsi delle unit LCL e lazutils corrispondenti e usare la vera configurazione target del compilatore; DCU/PPU Windows e DLL Windows non sono riutilizzabili come output Unix
Prima del caricamento impostare LibraryName al percorso desiderato di libpdfium.so o libpdfium.dylib. Un runtime ordinario o V8 deve corrispondere al target ed esportare le funzionalità richieste. Capacità V8/XFA mancanti restano indisponibili; il nome della libreria non ne dimostra la presenza
L'accesso ai font di sistema usa fontconfig su Linux e CoreText su macOS; il subsetting opzionale dei font CID usa HarfBuzz mantenendo gli ID dei glifi. I bitmap LCL usano ordine dei byte e descrizione dei canali reali, con conversione quando il layout nativo non è utilizzabile direttamente
Tests/PlatformAcceptance/run_native.py e NativeWrapper.lpr forniscono l'accettazione nativa legata ai sorgenti per caricamento, rendering, testo, form, salvataggio, annullamento e ciclo di vita. Eseguire il binario sul vero host target e conservarne il report; un inventario di predisposizione o una cross-compilazione riuscita da soli non bastano
Installer Windows e progetti VCL/C++Builder restano il percorso di configurazione Windows. Gli helper nativi Delphi macOS per crittografia e timestamp sono qualificati separatamente dal componente visuale FPC/LCL
Ridistribuzione
Quando si distribuiscono applicazioni che usano PDFium VCL:
- Includere l'albero corrispondente
DLLs\Win32\pdfium.dll o DLLs\Win64\pdfium.dll accanto all'applicazione o in una cartella padre dell'applicazione
- Per il supporto dei moduli V8/XFA, includere il corrispondente
DLLs\Win32\pdfium.v8.dll o DLLs\Win64\pdfium.v8.dll nello stesso albero di DLL e impostare EnableV8Engine prima del caricamento
- Non sono richieste licenze di runtime aggiuntive
- Distribuzione senza royalty per le applicazioni compilate
Risoluzione dei problemi
Problemi comuni:
- Componenti non visibili: verificare che l'IDE sia stato riavviato dopo l'installazione
- Errori di runtime: verificare che la DLL PDFium corretta si trovi in
DLLs\Win32 o DLLs\Win64 o direttamente nel percorso dell'applicazione
- Violazioni di accesso: controllare che tutte le dipendenze richieste siano installate e che l'architettura della DLL corrisponda all'applicazione (32 bit rispetto a 64 bit)
- Errori in fase di progettazione: ricompilare i pacchetti e riavviare l'IDE
- Moduli XFA non funzionanti: verificare che il corrispondente
pdfium.v8.dll sia disponibile nella cartella delle DLL della piattaforma e che EnableV8Engine sia impostato prima del caricamento
Disinstallazione
Per rimuovere i componenti PDFium VCL:
- Usare Installazione/Rimozione programmi di Windows
- In alternativa, eseguire il programma di disinstallazione dalla directory di installazione
- Se necessario, rimuovere manualmente gli eventuali file residui