Installatiehandleiding

Systeemvereisten

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) tot Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 of nieuwer (voor Free Pascal)
• Windows XP of nieuwer (Win32 / Win64)
• Minimaal 50 MB vrije schijfruimte

Installatiestappen

1. Voer het installatieprogramma uit: Start PDFiumPas-FULL.exe of PDFiumPas-TRIAL.exe als beheerder
2. Selecteer IDE-integratie: Op de pagina RAD Studio Integration worden gedetecteerde Delphi-personalities als eerste vermeld met de nieuwste versie vooraf aangevinkt; C++Builder-personalities worden apart vermeld en staan standaard uit
3. Selecteer optionele inhoud: Vink C++Builder of Lazarus alleen aan wanneer die pakketbestanden en demoprojecten moeten worden geïnstalleerd
4. Kies het installatiepad: Selecteer de map waarin de componenten worden geïnstalleerd
5. Voltooi de installatie: Volg de instructies op het scherm
6. Verifieer de installatie: De volgende componenten worden toegevoegd aan het palet losLab:
   • TPdf - Component voor PDF-basisbewerkingen
   • TPdfView - Component voor PDF-weergave en -interactie

Gelokaliseerde help en demobuilds

• Het installatieprogramma installeert altijd de gedeelde Docs-assets en kopieert daarna alleen de help-taalmappen die op basis van de Windows-locale-naam en de LCID van de UI-taal worden geselecteerd
• Engelse help gebruikt en-GB voor ondersteunde Britse, Commonwealth- en Caraïbische Engelse locales; en-US wordt gebruikt voor andere Engelstalige locales en als fallback wanneer er geen regionale helpset overeenkomt
• Spaanse help is opgesplitst in es voor Spanje-stijl locales en es-419 voor Latijns-Amerikaanse locales; Chinese help is opgesplitst in zh-cn en zh-tw
• Bijpassende gelokaliseerde helpsets worden toegevoegd indien beschikbaar voor Arabische, Duitse, Franse, Italiaanse, Japanse, Koreaanse, Nederlandse, Poolse, Portugese, Russische, Zweedse, Turkse en Chinese UI-talen of locale-namen
• Delphi- en C++Builder-demobuilds na installatie gebruiken de laatst geselecteerde RAD Studio-hoofdmap en vereisen de bijpassende Delphi- of C++Builder-personality plus de gevraagde Win32-/Win64-compiler

Handmatige installatie (geavanceerd)

Als de automatische installatie mislukt, kunt u de componenten handmatig installeren:

1. Kopieer de componentbestanden naar het bibliotheekpad van uw IDE
2. Voeg het bibliotheekpad toe aan de zoekmappen van uw IDE
3. Installeer het ontwerptijdpakket via de Package Manager van de IDE
4. Bouw uw IDE opnieuw op om de componenten te registreren

Native Free Pascal- en LCL-platforms

Native wrapper-builds gebruiken een op OS en CPU afgestemde Free Pascal-compiler, Lazarus/LCL en de PDFium-shared library. De gekwalificeerde configuraties gebruiken FPC 3.3.1 met LCL 4.99, Qt6 op Linux x86_64 en Cocoa op macOS arm64

Bouw native uitvoerbare bestanden en units in aparte doelmappen met de gekozen widgetset. Geef de bijbehorende LCL- en lazutils-unitpaden mee en gebruik de werkelijke doelconfiguratie van de compiler; Windows DCU/PPU-bestanden en Windows-DLL's kunnen niet als Unix-uitvoer worden hergebruikt

Stel LibraryName in op het bedoelde pad libpdfium.so of libpdfium.dylib voordat u laadt. Een gewone of V8-runtime moet bij dat doel passen en de gevraagde features bieden. Ontbrekende V8/XFA-capabilities blijven ontbrekende features; een bibliotheekbestandsnaam stelt ze niet vast

Toegang tot systeemfonts gebruikt fontconfig op Linux en CoreText op macOS; optionele CID-fontsubsetting gebruikt HarfBuzz met behouden glyph-ID's. LCL-bitmaps gebruiken hun werkelijke bytevolgorde en kanaalbeschrijving, met conversie wanneer de native bufferindeling niet rechtstreeks kan worden gebruikt

Tests/PlatformAcceptance/run_native.py en NativeWrapper.lpr bieden source-gebonden native acceptatie voor laden, renderen, tekst, formulieren, opslaan, annulering en lifecycle-controles. Draai het doelprogramma op zijn werkelijke host en bewaar het rapport; een readiness-inventaris of een geslaagde cross-compile alleen is onvoldoende

Windows-installers en VCL/C++Builder-projecten blijven de Windows-setuproute. Native Delphi macOS-crypto- en timestamphulpmiddelen worden apart gekwalificeerd van de FPC/LCL-visuele component

Herdistributie

Bij het distribueren van toepassingen die PDFium VCL gebruiken:

• Neem de bijpassende DLLs\Win32\pdfium.dll- of DLLs\Win64\pdfium.dll-structuur op naast uw toepassing of in een bovenliggende toepassingsmap
• Voor V8/XFA-formulierondersteuning neemt u de bijpassende DLLs\Win32\pdfium.v8.dll of DLLs\Win64\pdfium.v8.dll op in dezelfde DLLs-structuur en stelt u EnableV8Engine in vóór het laden
• Geen aanvullende runtime-licenties vereist
• Royalty-vrije distributie voor gecompileerde toepassingen

Probleemoplossing

Verwijderen

Om PDFium VCL-componenten te verwijderen:

1. Gebruik Software van Windows
2. Of voer het verwijderprogramma uit vanuit de installatiemap
3. Verwijder indien nodig handmatig eventueel resterende bestanden