Installationsguide

Systemkrav

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) till Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 eller senare (för Free Pascal)
• Windows XP eller senare (Win32 / Win64)
• Minst 50 MB ledigt diskutrymme

Installationssteg

1. Kör installationsprogrammet: Kör PDFiumPas-FULL.exe eller PDFiumPas-TRIAL.exe som administratör
2. Välj IDE-integration: På sidan RAD Studio Integration listas identifierade Delphi-personalities först med den nyaste versionen förbockad; C++Builder-personalities listas separat och är avstängda som standard
3. Välj valfritt innehåll: Bockar bara i C++Builder eller Lazarus när de paketfiler och demoprojekt ska installeras
4. Välj installationssökväg: Välj katalogen där komponenterna ska installeras
5. Slutför installationen: Följ instruktionerna på skärmen
6. Verifiera installationen: Följande komponenter läggs till i paletten losLab:
   • TPdf - Kärnkomponent för PDF-manipulation
   • TPdfView - Komponent för PDF-visning och interaktion

Lokaliserad hjälp och demobyggen

• Installationsprogrammet installerar alltid de delade Docs-resurserna och kopierar sedan bara de hjälpmappar som valts av Windows locale name och UI language LCID
• Engelsk hjälp använder en-GB för stödda brittiska, Commonwealth- och karibiska English locales; en-US används för andra English locales och som fallback när ingen regional hjälpuppsättning matchar
• Spansk hjälp är uppdelad mellan es för Spanien-liknande locales och es-419 för latinamerikanska locales; kinesisk hjälp är uppdelad mellan zh-cn och zh-tw
• Matchande lokaliserade hjälpuppsättningar läggs till när de finns för arabiska, tyska, franska, italienska, japanska, koreanska, nederländska, polska, portugisiska, ryska, svenska, turkiska och kinesiska UI-språk eller locale names
• Demobyggen för Delphi och C++Builder efter installationen använder den senaste valda RAD Studio-roten och kräver matchande Delphi- eller C++Builder-personality samt den begärda Win32 / Win64-kompilatorn

Manuell installation (avancerat)

Om den automatiska installationen misslyckas kan du installera komponenterna manuellt:

1. Kopiera komponentfilerna till IDE:ns bibliotekssökväg
2. Lägg till bibliotekssökvägen i IDE:ns sökkataloger
3. Installera design-time-paketet via IDE:ns Package Manager
4. Bygg om IDE:n för att registrera komponenterna

Nativa Free Pascal- och LCL-plattformar

Nativa wrapperbyggen använder en Free Pascal-kompilator som matchar operativsystem och CPU, Lazarus/LCL och ett delat PDFium-bibliotek. De kvalificerade konfigurationerna använder FPC 3.3.1 med LCL 4.99, Qt6 på Linux x86_64 och Cocoa på macOS arm64

Bygg nativa binärer och enheter i separata målkataloger med den valda widgetuppsättningen. Ange motsvarande enhetssökvägar för LCL och lazutils och använd kompilatorns faktiska målkonfiguration; Windows DCU/PPU-filer och Windows-DLL:er kan inte återanvändas som Unix-utdata

Sätt LibraryName till den avsedda sökvägen libpdfium.so eller libpdfium.dylib före inläsning. En vanlig eller V8-runtime måste matcha målet och exponera de begärda funktionerna. Saknade V8/XFA-funktioner förblir otillgängliga; ett biblioteksfilnamn fastställer dem inte

Systemtypsnittsåtkomst använder fontconfig på Linux och CoreText på macOS; valfri CID-typsnittssubsetting använder HarfBuzz med bevarade glyph-ID:n. LCL-bitmappar använder sin faktiska byteordning och kanalbeskrivning, med konvertering när den nativa buffertlayouten inte kan användas direkt

Tests/PlatformAcceptance/run_native.py och NativeWrapper.lpr tillhandahåller källbunden nativ acceptans för inläsning, rendering, text, formulär, sparning, avbrott och livscykelkontroller. Kör målbinären på sin faktiska värd och behåll rapporten; en beredskapsinventering eller en lyckad korskompilering räcker inte

Windows-installatörer och VCL/C++Builder-projekt förblir Windows-vägen för installation. Native Delphi macOS-krypto- och tidsstämplingshjälpare kvalificeras separat från FPC/LCL-komponenten

Redistribuering

När du distribuerar applikationer som använder PDFium VCL:

• Inkludera det matchande trädet DLLs\Win32\pdfium.dll eller DLLs\Win64\pdfium.dll bredvid applikationen eller i en överordnad applikationsmapp
• För V8/XFA-formulärstöd, inkludera matchande DLLs\Win32\pdfium.v8.dll eller DLLs\Win64\pdfium.v8.dll i samma DLL-träd och sätt EnableV8Engine före inläsning
• Inga ytterligare runtime-licenser krävs
• Royaltyfri distribution för kompilerade applikationer

Felsökning

Avinstallation

För att ta bort PDFium VCL-komponenterna:

1. Använd Windows Lägg till/ta bort program
2. Eller kör avinstallationsprogrammet från installationskatalogen
3. Ta manuellt bort eventuella kvarvarande filer om det behövs