راهنمای نصب
نیازمندیهای سیستم
- 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 را بهصورت Administrator اجرا کنید
- انتخاب یکپارچهسازی IDE: در صفحهٔ RAD Studio Integration، شخصیتهای Delphi شناساییشده با جدیدترین نسخه از پیش تیکخورده اول فهرست میشوند؛ شخصیتهای C++Builder جدا فهرست شده و بهصورت پیشفرض خاموشاند
- انتخاب محتوای اختیاری: فقط وقتی آن فایلهای بسته و پروژههای دمو باید نصب شوند C++Builder یا Lazarus را تیک کنید
- انتخاب مسیر نصب: پوشهای را که کامپوننتها در آن نصب میشوند انتخاب کنید
- نصب کامل: دستورالعملهای روی صفحه را دنبال کنید
- تأیید نصب: کامپوننتهای زیر به پالت losLab اضافه میشوند:
- TPdf - کامپوننت اصلی کار با PDF
- TPdfView - کامپوننت نمایش و تعامل PDF
راهنمای محلیسازیشده و بیلدهای دمو
- نصبکننده همیشه assets مشترک
Docs را نصب کرده و سپس فقط پوشههای زبان راهنما را که با نام locale Windows و LCID زبان UI انتخاب شدهاند کپی میکند
- راهنمای انگلیسی از
en-GB برای locale های انگلیسی بریتانیایی، مشترکالمنافع و کارائیبی پشتیبانیشده استفاده میکند؛ en-US برای دیگر locale های انگلیسی و بهعنوان بازگشت وقتی هیچ مجموعهٔ راهنمای منطقهای منطبق نباشد به کار میرود
- راهنمای اسپانیایی میان
es برای locale های سبک اسپانیا و es-419 برای locale های آمریکای لاتین تقسیم شده؛ راهنمای چینی نیز میان zh-cn و zh-tw تقسیم شده است
- مجموعههای راهنمای محلیسازیشدهٔ منطبق وقتی در دسترس باشند برای زبانهای UI یا نامهای locale عربی، آلمانی، فرانسوی، ایتالیایی، ژاپنی، کرهای، هلندی، لهستانی، پرتغالی، روسی، سوئدی، ترکی و چینی اضافه میشوند
- بیلدهای دموی پس از نصب Delphi و C++Builder از جدیدترین ریشهٔ RAD Studio انتخابشده استفاده میکنند و به شخصیت منطبق Delphi یا C++Builder بههمراه کامپایلر درخواستی Win32 / Win64 نیاز دارند
نصب دستی (پیشرفته)
اگر نصب خودکار شکست خورد، میتوانید کامپوننتها را دستی نصب کنید:
- فایلهای کامپوننت را به مسیر کتابخانهٔ IDE خود کپی کنید
- مسیر کتابخانه را به پوشههای جستوجوی IDE خود اضافه کنید
- بستهٔ زمان طراحی را از طریق Package Manager IDE نصب کنید
- IDE خود را برای ثبت کامپوننتها بازسازی کنید
توزیع مجدد
هنگام توزیع برنامههایی که از VCL PDFium استفاده میکنند:
- درخت
DLLs\Win32\pdfium.dll یا DLLs\Win64\pdfium.dll منطبق را کنار برنامه یا در پوشهٔ برنامهٔ والد قرار دهید
- برای پشتیبانی فرم V8/XFA،
DLLs\Win32\pdfium.v8.dll یا DLLs\Win64\pdfium.v8.dll منطبق را در همان درخت DLLs قرار دهید و پیش از بارگذاری EnableV8Engine را تنظیم کنید
- بدون نیاز مجوز زمان اجرای اضافی
- توزیع بدون حق امتیاز برای برنامههای کامپایلشده
عیبیابی
مشکلات رایج:
- کامپوننتها قابل مشاهده نیستند: مطمئن شوید IDE پس از نصب راهاندازی مجدد شده است
- خطاهای زمان اجرا: بررسی کنید DLL PDFium درست در
DLLs\Win32 یا DLLs\Win64، یا مستقیماً در مسیر برنامه است
- نقض دسترسی: بررسی کنید همهٔ وابستگیهای لازم نصب شده و معماری DLL با برنامه هماهنگ باشد (32 بیتی در برابر 64 بیتی)
- خطاهای زمان طراحی: بستهها را بازسازی کرده و IDE را راهاندازی مجدد کنید
- فرمهای XFA کار نمیکنند: مطمئن شوید
pdfium.v8.dll منطبق در پوشهٔ DLLs پلتفرم در دسترس است و EnableV8Engine پیش از بارگذاری تنظیم شده
حذف نصب
برای حذف کامپوننتهای VCL PDFium:
- از Add/Remove Programs ویندوز استفاده کنید
- یا uninstaller را از پوشهٔ نصب اجرا کنید
- در صورت نیاز هر فایل باقیمانده را دستی حذف کنید