Οδηγός εγκατάστασης
Απαιτήσεις συστήματος
- 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 - βασικό component χειρισμού PDF
- TPdfView - component προβολής και αλληλεπίδρασης PDF
Τοπικοποιημένη βοήθεια και demo builds
- Το πρόγραμμα εγκατάστασης εγκαθιστά πάντα τα κοινόχρηστα assets
Docs και στη συνέχεια αντιγράφει μόνο τους φακέλους βοήθειας που επιλέγονται από το όνομα locale των Windows και το LCID της γλώσσας UI
- Η αγγλική βοήθεια χρησιμοποιεί το
en-GB για τις υποστηριζόμενες βρετανικές, κοινοπολιτειακές και καριβικές αγγλικές τοπικές ρυθμίσεις· το en-US χρησιμοποιείται για τις υπόλοιπες αγγλικές τοπικές ρυθμίσεις και ως fallback όταν δεν ταιριάζει κανένα regional help set
- Η ισπανική βοήθεια χωρίζεται σε
es για locales τύπου Ισπανίας και es-419 για λατινοαμερικανικά locales· η κινεζική βοήθεια χωρίζεται σε zh-cn και zh-tw
- Αντίστοιχα τοπικοποιημένα help sets προστίθενται όταν υπάρχουν για τις γλώσσες UI αραβικών, γερμανικών, γαλλικών, ιταλικών, ιαπωνικών, κορεατικών, ολλανδικών, πολωνικών, πορτογαλικών, ρωσικών, σουηδικών, τουρκικών και κινεζικών ή για τα αντίστοιχα 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
Αναδιανομή
Όταν διανέμετε εφαρμογές που χρησιμοποιούν 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
- Διανομή χωρίς δικαιώματα για μεταγλωττισμένες εφαρμογές
Αντιμετώπιση προβλημάτων
Συνήθη ζητήματα:
- Τα 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 από τον κατάλογο εγκατάστασης
- Αφαιρέστε χειροκίνητα τυχόν αρχεία που απομένουν αν χρειάζεται