Οδηγός εγκατάστασης
Απαιτήσεις συστήματος
- Delphi XE5 / C++Builder XE5 (RAD Studio XE5) έως Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
- Lazarus 1.0 ή νεότερο (για Free Pascal)
- Windows XP ή νεότερο (Win32 / Win64)
- Τουλάχιστον 50 MB ελεύθερου χώρου στον δίσκο
Βήματα εγκατάστασης
- Εκτελέστε το πρόγραμμα εγκατάστασης: Εκτελέστε το
PDFiumPas-FULL.exe ή το PDFiumPas-TRIAL.exe ως διαχειριστής
- Επιλέξτε ενσωμάτωση IDE: Στη σελίδα RAD Studio Integration, οι εντοπισμένες Delphi personalities εμφανίζονται πρώτες με τη νεότερη έκδοση ήδη επιλεγμένη· οι C++Builder personalities εμφανίζονται χωριστά και είναι απενεργοποιημένες από προεπιλογή
- Επιλέξτε προαιρετικό περιεχόμενο: Ενεργοποιήστε το C++Builder ή το Lazarus μόνο όταν πρέπει να εγκατασταθούν τα package files και τα demo projects τους
- Επιλέξτε διαδρομή εγκατάστασης: Επιλέξτε τον κατάλογο όπου θα εγκατασταθούν τα components
- Ολοκληρώστε την εγκατάσταση: Ακολουθήστε τις οδηγίες στην οθόνη
- Επαληθεύστε την εγκατάσταση: Τα παρακάτω components θα προστεθούν στην παλέτα losLab:
- TPdf - Core PDF manipulation component
- TPdfView - PDF viewing and interaction component
Τοπικοποιημένη βοήθεια και demo builds
- Το πρόγραμμα εγκατάστασης εγκαθιστά πάντα τα κοινόχρηστα assets
Docs και στη συνέχεια αντιγράφει μόνο τους φακέλους βοήθειας που επιλέγονται από το Windows locale name και το UI language LCID
- Η αγγλική βοήθεια χρησιμοποιεί το
en-GB για υποστηριζόμενα British, Commonwealth και Caribbean English locales· το en-US χρησιμοποιείται για άλλα αγγλικά locales και ως fallback όταν δεν ταιριάζει κανένα regional help set
- Η ισπανική βοήθεια χωρίζεται σε
es για locales τύπου Ισπανίας και es-419 για λατινοαμερικανικά locales· η κινεζική βοήθεια χωρίζεται σε zh-cn και zh-tw
- Αντίστοιχα τοπικοποιημένα help sets προστίθενται όταν υπάρχουν για Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Swedish, Turkish και Chinese UI languages ή locale names
- Τα Delphi και C++Builder demo builds μετά την εγκατάσταση χρησιμοποιούν το πιο πρόσφατο επιλεγμένο RAD Studio root και απαιτούν το αντίστοιχο Delphi ή C++Builder personality μαζί με τον ζητούμενο Win32 / Win64 compiler
Χειροκίνητη εγκατάσταση (Advanced)
Αν η αυτόματη εγκατάσταση αποτύχει, μπορείτε να εγκαταστήσετε τα components χειροκίνητα:
- Αντιγράψτε τα αρχεία των components στο library path του IDE σας
- Προσθέστε το library path στα search directories του IDE σας
- Εγκαταστήστε το design-time package μέσω του Package Manager του IDE
- Αναδομήστε το IDE σας για να καταχωριστούν τα components
Redistribution
Όταν διανέμετε εφαρμογές που χρησιμοποιούν PDFium VCL:
- Συμπεριλάβετε το αντίστοιχο δέντρο
DLLs\Win32\pdfium.dll ή DLLs\Win64\pdfium.dll δίπλα στην εφαρμογή σας ή σε γονικό φάκελο της εφαρμογής
- Για υποστήριξη V8/XFA forms, συμπεριλάβετε το αντίστοιχο
DLLs\Win32\pdfium.v8.dll ή DLLs\Win64\pdfium.v8.dll στο ίδιο δέντρο DLLs και ορίστε το EnableV8Engine πριν από τη φόρτωση
- Δεν απαιτούνται πρόσθετες άδειες runtime
- Διανομή χωρίς δικαιώματα για compiled applications
Αντιμετώπιση προβλημάτων
Συνήθη ζητήματα:
- Τα components δεν εμφανίζονται: Βεβαιωθείτε ότι το IDE επανεκκινήθηκε μετά την εγκατάσταση
- Σφάλματα runtime: Επαληθεύστε ότι το σωστό PDFium DLL βρίσκεται στο
DLLs\Win32 ή στο DLLs\Win64, ή απευθείας στη διαδρομή της εφαρμογής
- Παραβιάσεις πρόσβασης: Ελέγξτε ότι όλες οι απαιτούμενες εξαρτήσεις είναι εγκατεστημένες και ότι η αρχιτεκτονική του DLL ταιριάζει με την εφαρμογή (32-bit έναντι 64-bit)
- Σφάλματα design-time: Αναδομήστε τα packages και επανεκκινήστε το IDE
- Τα XFA forms δεν λειτουργούν: Βεβαιωθείτε ότι το αντίστοιχο
pdfium.v8.dll είναι διαθέσιμο στον φάκελο DLLs της πλατφόρμας και ότι το EnableV8Engine έχει οριστεί πριν από τη φόρτωση
Κατάργηση εγκατάστασης
Για να αφαιρέσετε τα components PDFium VCL:
- Χρησιμοποιήστε το Windows Add/Remove Programs
- Ή εκτελέστε το uninstaller από τον κατάλογο εγκατάστασης
- Αφαιρέστε χειροκίνητα τυχόν αρχεία που απομένουν αν χρειάζεται