Guide d'installation

Configuration système requise

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) jusqu'à Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 ou version ultérieure (pour Free Pascal)
• Windows XP ou version ultérieure (Win32 / Win64)
• 50 Mo d'espace disque libre minimum

Étapes d'installation

1. Lancer l'installateur : Exécutez PDFiumPas-FULL.exe ou PDFiumPas-TRIAL.exe en tant qu'administrateur
2. Sélectionner l'intégration IDE : Sur la page RAD Studio Integration, les personnalités Delphi détectées sont listées en premier, la version la plus récente étant présélectionnée ; les personnalités C++Builder sont listées séparément et sont désactivées par défaut
3. Sélectionner le contenu optionnel : Cochez C++Builder ou Lazarus uniquement si les fichiers de paquet et les projets de démonstration correspondants doivent être installés
4. Choisir le chemin d'installation : Sélectionnez le répertoire dans lequel les composants seront installés
5. Terminer l'installation : Suivez les instructions affichées à l'écran
6. Vérifier l'installation : Les composants suivants seront ajoutés à la palette losLab :
   • TPdf - Composant de manipulation PDF principal
   • TPdfView - Composant de visualisation et d'interaction PDF

Aide localisée et builds de démonstration

• L'installateur installe toujours les ressources Docs partagées, puis copie uniquement les dossiers d'aide de langue sélectionnés d'après le nom de paramètres régionaux Windows et le LCID de la langue d'interface
• L'aide anglaise utilise en-GB pour les paramètres régionaux anglais de Grande-Bretagne, du Commonwealth et des Caraïbes pris en charge ; en-US est utilisé pour les autres paramètres régionaux anglais et comme solution de repli lorsqu'aucun jeu d'aide régional ne correspond
• L'aide espagnole est répartie entre es pour les paramètres régionaux de type Espagne et es-419 pour les paramètres régionaux d'Amérique latine ; l'aide chinoise est répartie entre zh-cn et zh-tw
• Des jeux d'aide localisés correspondants sont ajoutés, lorsqu'ils sont disponibles, pour les langues d'interface ou les noms de paramètres régionaux arabe, allemand, français, italien, japonais, coréen, néerlandais, polonais, portugais, russe, suédois, turc et chinois
• Les builds de démonstration Delphi et C++Builder réalisés après l'installation utilisent la racine RAD Studio sélectionnée la plus récente et exigent la personnalité Delphi ou C++Builder correspondante ainsi que le compilateur Win32 / Win64 demandé

Installation manuelle (avancé)

Si l'installation automatique échoue, vous pouvez installer les composants manuellement :

1. Copiez les fichiers des composants vers le chemin de bibliothèque de votre IDE
2. Ajoutez le chemin de bibliothèque aux répertoires de recherche de votre IDE
3. Installez le paquet en mode conception via le gestionnaire de paquets de l'IDE
4. Reconstruisez votre IDE pour enregistrer les composants

Plateformes Free Pascal et LCL natives

Les builds natifs du wrapper exigent un compilateur Free Pascal, Lazarus/LCL et une bibliothèque PDFium adaptés au système et au CPU ; les configurations validées utilisent FPC 3.3.1 avec LCL 4.99, Qt6 sous Linux x86_64 et Cocoa sous macOS arm64

Construisez les exécutables et unités natifs dans des répertoires distincts par cible avec le widget set choisi ; fournissez les chemins d’unités LCL et lazutils correspondants et la véritable configuration cible du compilateur ; les DCU/PPU et DLL Windows ne se réutilisent pas comme sorties Unix

Définissez LibraryName sur le chemin voulu de libpdfium.so ou libpdfium.dylib avant chargement ; le runtime ordinaire ou V8 doit correspondre à la cible et exposer les fonctions demandées ; V8/XFA absents restent indisponibles, le nom de bibliothèque ne les garantit pas

Les polices système sont résolues avec fontconfig sous Linux et CoreText sous macOS ; le sous-ensemble CID facultatif utilise HarfBuzz avec conservation des identifiants de glyphe ; les bitmaps LCL utilisent leur ordre d’octets et description de canaux réels, avec conversion si le tampon natif n’est pas directement compatible

Tests/PlatformAcceptance/run_native.py et NativeWrapper.lpr fournissent une validation native liée aux sources pour chargement, rendu, texte, formulaires, enregistrement, annulation et cycle de vie ; exécutez la cible sur son hôte réel et conservez le rapport ; un inventaire de préparation ou une compilation croisée réussie ne suffit pas

Les installateurs Windows et projets VCL/C++Builder restent la voie d’installation Windows ; les helpers crypto et horodatage Delphi macOS sont validés séparément du composant visuel FPC/LCL

Redistribution

Lorsque vous distribuez des applications qui utilisent PDFium VCL :

• Incluez l'arborescence DLLs\Win32\pdfium.dll ou DLLs\Win64\pdfium.dll correspondante à côté de votre application ou dans un dossier d'application parent
• Pour la prise en charge des formulaires V8/XFA, incluez le fichier DLLs\Win32\pdfium.v8.dll ou DLLs\Win64\pdfium.v8.dll correspondant dans la même arborescence DLLs et définissez EnableV8Engine avant le chargement
• Aucune licence d'exécution supplémentaire n'est requise
• Distribution sans redevance pour les applications compilées

Dépannage

Désinstallation

Pour supprimer les composants PDFium VCL :

1. Utilisez Ajout/Suppression de programmes de Windows
2. Ou exécutez le programme de désinstallation depuis le répertoire d'installation
3. Supprimez manuellement les fichiers restants si nécessaire