התקנה

שלבי ההתקנה

הפעל את המתקין: הפעל את PDFiumPas-FULL.exe או את PDFiumPas-TRIAL.exe כמנהל

בחר שילוב IDE: בדף RAD Studio Integration, פרסונות Delphi שזוהו מופיעות תחילה כשהגרסה החדשה ביותר כבר מסומנת; פרסונות C++Builder מופיעות בנפרד וכבויות כברירת מחדל

בחר תוכן אופציונלי: סמן C++Builder או Lazarus רק כאשר יש להתקין גם את קובצי החבילות האלה ואת פרויקטי ההדגמה

בחר נתיב התקנה: בחר את הספרייה שבה יותקנו הרכיבים

השלם את ההתקנה: פעל לפי ההוראות שמוצגות על המסך

אמת את ההתקנה: הרכיבים הבאים יתווספו ללוח losLab:

TPdf - רכיב ליבה לטיפול ב-PDF
TPdfView - רכיב לצפייה ב-PDF ולאינטראקציה

עזרה מקומית ובניית דגימות

המתקין מתקין תמיד את המשאבים המשותפים של Docs ואז מעתיק רק את תיקיות שפת העזרה שנבחרו לפי שם locale של Windows ו-LCID של שפת הממשק

עזרה באנגלית משתמשת ב-en-GB עבור locales נתמכים של British, Commonwealth ו-Caribbean English; en-US משמש עבור locales אנגליים אחרים וגם כ-fallback כאשר אין התאמה לסט עזרה אזורי

עזרה בספרדית מחולקת בין es עבור locales בסגנון Spain ובין es-419 עבור locales לטינו-אמריקאיים; עזרה בסינית מחולקת בין zh-cn ו-zh-tw

סטי עזרה מקומיים תואמים מתווספים כאשר הם זמינים עבור Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Swedish, Turkish ו-Chinese UI languages או locale names

בניית דגימות Delphi ו-C++Builder לאחר ההתקנה משתמשות ב-RAD Studio root האחרון שנבחר ודורשות את אישיות Delphi או C++Builder המתאימה יחד עם ה-compiler המבוקש של Win32 / Win64

התקנה ידנית (מתקדם)

אם ההתקנה האוטומטית נכשלת, אפשר להתקין את הרכיבים ידנית:

העתק את קובצי הרכיב לנתיב הספריות של ה-IDE שלך

הוסף את נתיב הספרייה לספריות החיפוש של ה-IDE שלך

התקן את חבילת זמן העיצוב דרך Package Manager של ה-IDE

בנה מחדש את ה-IDE כדי לרשום את הרכיבים

הפצה מחדש

בעת הפצת יישומים המשתמשים ב-PDFium VCL:

כלול את עץ DLLs\Win32\pdfium.dll או DLLs\Win64\pdfium.dll המתאים לצד היישום שלך או בתיקייה עליונה של היישום

עבור תמיכה בטפסי V8/XFA, כלול את DLLs\Win32\pdfium.v8.dll או DLLs\Win64\pdfium.v8.dll המתאים באותו עץ DLLs והגדר EnableV8Engine לפני הטעינה

אין צורך ברישיונות runtime נוספים

הפצה ללא תמלוגים עבור יישומים מקומפלים

פתרון בעיות

בעיות נפוצות:

הרכיבים אינם גלויים: ודא שה-IDE הופעל מחדש לאחר ההתקנה
שגיאות runtime: ודא ש-DLL של PDFium הנכון נמצא ב-DLLs\Win32 או ב-DLLs\Win64, או ישירות בנתיב היישום
Access violations: בדוק שכל התלויות הנדרשות מותקנות ושהארכיטקטורה של ה-DLL תואמת ליישום (32-bit מול 64-bit)
שגיאות בזמן העיצוב: בנה מחדש את החבילות והפעל מחדש את ה-IDE
טפסי XFA אינם פועלים: ודא ש-pdfium.v8.dll התואם זמין בתיקיית ה-DLLs של הפלטפורמה ושה-EnableV8Engine מוגדר לפני הטעינה