راهنمای نصب
نیازمندیهای سیستم
- 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، personalityهای Delphi که شناسایی شدهاند ابتدا فهرست میشوند و جدیدترین نسخه از قبل انتخاب شده است؛ personalityهای C++Builder جداگانه فهرست میشوند و بهطور پیشفرض خاموش هستند
- انتخاب محتوای اختیاری: فقط وقتی بستههای مربوط و پروژههای نمونه باید نصب شوند، C++Builder یا Lazarus را علامت بزنید
- انتخاب مسیر نصب: پوشهای را انتخاب کنید که کامپوننتها در آن نصب شوند
- تکمیل نصب: دستورالعملهای روی صفحه را دنبال کنید
- بررسی نصب: کامپوننتهای زیر به پالت losLab افزوده میشوند:
- TPdf - کامپوننت اصلی دستکاری PDF
- TPdfView - کامپوننت مشاهده و تعامل با PDF
راهنمای محلیسازیشده و ساخت نمونهها
- نصبکننده همیشه داراییهای مشترک
Docs را نصب میکند و سپس فقط پوشههای زبان راهنما را که با نام locale ویندوز و LCID زبان رابط کاربر انتخاب شدهاند کپی میکند
- راهنمای انگلیسی از
en-GB برای localeهای پشتیبانیشدهٔ بریتانیایی، Commonwealth و کارائیب استفاده میکند؛ en-US برای سایر localeهای انگلیسی و بهعنوان fallback وقتی هیچ مجموعهٔ راهنمای منطقهای منطبق نباشد استفاده میشود
- راهنمای اسپانیایی بین
es برای localeهای سبک اسپانیا و es-419 برای localeهای آمریکای لاتین تقسیم میشود؛ راهنمای چینی هم بین zh-cn و zh-tw تقسیم میشود
- اگر مجموعههای راهنمای محلیِ منطبق موجود باشند، برای زبانها یا نامهای locale عربی، آلمانی، فرانسوی، ایتالیایی، ژاپنی، کرهای، هلندی، لهستانی، پرتغالی، روسی، سوئدی، ترکی و چینی افزوده میشوند
- ساخت نمونههای Delphi و C++Builder پس از نصب از جدیدترین ریشهٔ RAD Studio انتخابشده استفاده میکند و به personality متناظر Delphi یا C++Builder بههمراه compiler درخواستی Win32 / Win64 نیاز دارد
نصب دستی (پیشرفته)
اگر نصب خودکار شکست خورد، میتوانید کامپوننتها را بهصورت دستی نصب کنید
- فایلهای کامپوننت را به library path IDE خود کپی کنید
- Library path را به search directories IDE خود اضافه کنید
- بستهٔ design-time را از طریق Package Manager IDE نصب کنید
- IDE را دوباره build کنید تا کامپوننتها ثبت شوند
توزیع مجدد
هنگام توزیع برنامههایی که از 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 اضافی لازم نیست
- توزیع برنامههای compiled بدون royalty انجام میشود
عیبیابی
مشکلات رایج:
- Components not visible: مطمئن شوید IDE بعد از نصب دوباره راهاندازی شده است
- Runtime errors: بررسی کنید DLL درستِ PDFium در
DLLs\Win32 یا DLLs\Win64 یا مستقیماً در مسیر برنامه قرار دارد
- Access violations: بررسی کنید همهٔ وابستگیهای لازم نصب شدهاند و معماری DLL با برنامه یکی است (32-bit در برابر 64-bit)
- Design-time errors: بستهها را دوباره build کنید و IDE را راهاندازی مجدد کنید
- XFA forms not working: مطمئن شوید
pdfium.v8.dll متناظر در پوشهٔ platform DLLs موجود است و EnableV8Engine قبل از loading تنظیم شده است
حذف نصب
برای حذف کامپوننتهای PDFium VCL
- از Windows Add/Remove Programs استفاده کنید
- یا uninstaller را از پوشهٔ نصب اجرا کنید
- در صورت نیاز، هر فایل باقیمانده را بهصورت دستی حذف کنید