Installationsanleitung
Systemvoraussetzungen
- Delphi XE5 / C++Builder XE5 (RAD Studio XE5) bis Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
- Lazarus 1.0 oder höher (für Free Pascal)
- Windows XP oder höher (Win32 / Win64)
- Mindestens 50 MB freier Festplattenspeicher
Installationsschritte
- Installer ausführen:
PDFiumPas-FULL.exe oder PDFiumPas-TRIAL.exe als Administrator starten
- IDE-Integration wählen: Auf der Seite RAD Studio Integration werden die erkannten Delphi-Personalities zuerst aufgelistet, mit der neuesten Version vorangewählt; C++Builder-Personalities werden separat aufgelistet und sind standardmäßig deaktiviert
- Optionale Inhalte wählen: C++Builder oder Lazarus nur ankreuzen, wenn deren Paketdateien und Demoprojekte mitinstalliert werden sollen
- Installationspfad wählen: Das Verzeichnis auswählen, in dem die Komponenten installiert werden
- Installation abschließen: Den Bildschirmanweisungen folgen
- Installation prüfen: Der Palette losLab werden die folgenden Komponenten hinzugefügt:
- TPdf - Zentrale Komponente zur PDF-Bearbeitung
- TPdfView - Komponente zur PDF-Anzeige und Interaktion
Lokalisierte Hilfe und Demo-Builds
- Der Installer installiert immer die gemeinsamen
Docs-Ressourcen und kopiert anschließend nur die Hilfesprachenordner, die über den Windows-Gebietsschemanamen und die LCID der UI-Sprache ausgewählt wurden
- Die englische Hilfe verwendet
en-GB für unterstützte britische, Commonwealth- und karibische englische Gebietsschemata; en-US wird für andere englische Gebietsschemata sowie als Fallback verwendet, wenn kein regionaler Hilfesatz passt
- Die spanische Hilfe ist aufgeteilt in
es für Gebietsschemata im Stil Spaniens und es-419 für lateinamerikanische Gebietsschemata; die chinesische Hilfe ist aufgeteilt in zh-cn und zh-tw
- Passende lokalisierte Hilfesätze werden – sofern verfügbar – für arabische, deutsche, französische, italienische, japanische, koreanische, niederländische, polnische, portugiesische, russische, schwedische, türkische und chinesische UI-Sprachen bzw. Gebietsschemanamen ergänzt
- Demo-Builds für Delphi und C++Builder nach der Installation verwenden das zuletzt ausgewählte RAD Studio-Stammverzeichnis und erfordern die passende Delphi- oder C++Builder-Personality sowie den angeforderten Win32-/Win64-Compiler
Manuelle Installation (fortgeschritten)
Wenn die automatische Installation fehlschlägt, können Sie die Komponenten manuell installieren:
- Kopieren Sie die Komponentendateien in den Bibliothekspfad Ihrer IDE
- Fügen Sie den Bibliothekspfad zu den Suchverzeichnissen Ihrer IDE hinzu
- Installieren Sie das Design-Time-Paket über den Paketmanager Ihrer IDE
- Erstellen Sie Ihre IDE neu, um die Komponenten zu registrieren
Native Wrapperbuilds benötigen zu OS/CPU passenden Free-Pascal-Compiler, Lazarus/LCL und PDFium-Bibliothek; qualifiziert sind FPC 3.3.1 mit LCL 4.99, Qt6 unter Linux x86_64 und Cocoa unter macOS arm64
Bauen Sie native Programme und Units mit gewähltem Widgetset in getrennten Zielverzeichnissen; geben Sie passende LCL-/lazutils-Unitpfade und die tatsächliche Zielkonfiguration an; Windows-DCU/PPU und DLLs lassen sich nicht als Unix-Ausgaben wiederverwenden
Setzen Sie vor dem Laden LibraryName auf das gewünschte libpdfium.so oder libpdfium.dylib; normale oder V8-Laufzeit muss zum Ziel passen und Funktionen exportieren; fehlendes V8/XFA bleibt unverfügbar, der Dateiname beweist keine Fähigkeit
Systemschriften verwenden fontconfig unter Linux und CoreText unter macOS; optionale CID-Subsets nutzen HarfBuzz mit erhaltenen Glyphen-IDs; LCL-Bitmaps verwenden reale Byte-/Kanalbeschreibung und werden bei inkompatiblem Direktpuffer konvertiert
Tests/PlatformAcceptance/run_native.py und NativeWrapper.lpr liefern quellgebundene native Abnahme für Laden, Rendering, Text, Formulare, Speichern, Abbruch und Lebenszyklus; führen Sie das Ziel auf seinem echten Host aus und behalten Sie den Bericht; Readinessinventar oder erfolgreiche Cross-Kompilierung genügt nicht
Windows-Installer und VCL/C++Builder-Projekte bleiben der Windows-Einrichtungsweg; native Delphi-macOS-Crypto-/Zeitstempelhelper sind unabhängig vom FPC/LCL-Sichtcontrol qualifiziert
Weiterverteilung
Beim Verteilen von Anwendungen, die PDFium VCL verwenden:
- Binden Sie den passenden
DLLs\Win32\pdfium.dll- oder DLLs\Win64\pdfium.dll-Baum neben Ihrer Anwendung oder in einem übergeordneten Anwendungsordner ein
- Für V8/XFA-Formularunterstützung binden Sie die passende
DLLs\Win32\pdfium.v8.dll oder DLLs\Win64\pdfium.v8.dll in denselben DLLs-Baum ein und setzen EnableV8Engine, bevor Sie laden
- Keine zusätzlichen Laufzeitlizenzen erforderlich
- Lizenzgebührenfreie Weiterverteilung für kompilierte Anwendungen
Problembehandlung
Häufige Probleme:
- Komponenten nicht sichtbar: Stellen Sie sicher, dass die IDE nach der Installation neu gestartet wurde
- Laufzeitfehler: Prüfen Sie, ob sich die richtige PDFium-DLL in
DLLs\Win32 oder DLLs\Win64 bzw. direkt im Anwendungspfad befindet
- Zugriffsverletzungen: Prüfen Sie, ob alle erforderlichen Abhängigkeiten installiert sind und die DLL-Architektur zur Anwendung passt (32-Bit oder 64-Bit)
- Design-Time-Fehler: Pakete neu erstellen und die IDE neu starten
- XFA-Formulare funktionieren nicht: Stellen Sie sicher, dass die passende
pdfium.v8.dll im Plattform-DLLs-Ordner verfügbar ist und EnableV8Engine gesetzt ist, bevor Sie laden
Deinstallation
So entfernen Sie die PDFium VCL-Komponenten:
- Verwenden Sie „Programme hinzufügen/entfernen“ in Windows
- Oder starten Sie das Deinstallationsprogramm aus dem Installationsverzeichnis
- Entfernen Sie verbleibende Dateien bei Bedarf manuell