دليل التثبيت

متطلبات النظام

• من 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

خطوات التثبيت

1. شغّل المثبّت: نفّذ PDFiumPas-FULL.exe أو PDFiumPas-TRIAL.exe بصلاحيات Administrator
2. اختر تكامل IDE: في صفحة RAD Studio Integration تُسرَد بيئات Delphi المكتشفة أولًا مع تحديد أحدث إصدار مسبقًا؛ وتُسرَد بيئات C++Builder في قسم منفصل وتكون غير محددة افتراضيًا
3. اختر المحتوى الاختياري: حدّد C++Builder أو Lazarus فقط عندما تريد تثبيت ملفات الحزم ومشاريع العروض التوضيحية الخاصة بها
4. اختر مسار التثبيت: حدد المجلد الذي ستُثبَّت فيه المكوّنات
5. أكمل التثبيت: اتبع التعليمات التي تظهر على الشاشة
6. تحقق من التثبيت: ستُضاف المكوّنات التالية إلى لوحة losLab:
   • TPdf - مكوّن معالجة PDF الأساسي
   • TPdfView - مكوّن عرض PDF والتفاعل معه

المساعدة المحلية وبناء العروض التوضيحية

• يثبّت المثبّت دائمًا أصول Docs المشتركة، ثم ينسخ فقط مجلدات لغات المساعدة التي يختارها اسم الإعدادات الإقليمية لـ Windows و LCID للغة واجهة المستخدم
• تستخدم المساعدة الإنجليزية en-GB للإعدادات الإقليمية الإنجليزية المدعومة في بريطانيا ودول الكومنولث والكاريبي؛ وتُستخدم en-US لبقية الإعدادات الإقليمية الإنجليزية وكخيار احتياطي عندما لا تتطابق أي مجموعة مساعدة إقليمية
• تنقسم المساعدة الإسبانية بين es للإعدادات الإقليمية بنمط إسبانيا و es-419 لإعدادات أمريكا اللاتينية؛ وتنقسم المساعدة الصينية بين zh-cn و zh-tw
• تُضاف مجموعات المساعدة المحلية المطابقة عند توفرها للغات واجهة المستخدم أو أسماء الإعدادات الإقليمية العربية والألمانية والفرنسية والإيطالية واليابانية والكورية والهولندية والبولندية والبرتغالية والروسية والسويدية والتركية والصينية
• تستخدم عمليات بناء العروض التوضيحية لـ Delphi و C++Builder بعد التثبيت أحدث جذر RAD Studio محدد، وتتطلب بيئة Delphi أو C++Builder المطابقة مع مترجم Win32 / Win64 المطلوب

التثبيت اليدوي (للمتقدمين)

إذا فشل التثبيت التلقائي، يمكنك تثبيت المكوّنات يدويًا:

1. انسخ ملفات المكوّنات إلى مسار المكتبة في بيئة IDE لديك
2. أضف مسار المكتبة إلى مجلدات البحث في IDE لديك
3. ثبّت حزمة design-time عبر مدير الحزم في IDE
4. أعد بناء IDE لتسجيل المكوّنات

منصات Free Pascal و LCL الأصلية

يلزم مترجم Free Pascal و Lazarus/LCL ومكتبة PDFium مطابقة للنظام و CPU؛ التكوينات المؤهلة FPC 3.3.1 و LCL 4.99 و Qt6 على Linux x86_64 و Cocoa على macOS arm64

ابنِ البرامج والوحدات في مجلدات أهداف منفصلة مع widget set المختار؛ قدم مسارات LCL و lazutils وتكوين الهدف الفعلي؛ لا تعاد ملفات Windows DCU/PPU أو DLL كإخراج Unix

ضع LibraryName على مسار libpdfium.so أو libpdfium.dylib قبل التحميل؛ يجب مطابقة runtime العادي أو V8 للهدف وتوفير الميزات؛ يبقى V8/XFA الغائب غير متاح، فالاسم لا يثبت القدرات

تستخدم الخطوط fontconfig على Linux و CoreText على macOS؛ يستخدم CID subset الاختياري HarfBuzz مع حفظ glyph IDs؛ تتبع bitmaps LCL وصف البايتات والقنوات الحقيقي وتُحول عند تعذر الاستخدام المباشر

توفر Tests/PlatformAcceptance/run_native.py و NativeWrapper.lpr قبولًا أصليًا مرتبطًا بالمصدر للتحميل والتصيير والنص والنماذج والحفظ والإلغاء ودورة الحياة؛ شغل التنفيذ على مضيفه الفعلي واحفظ التقرير؛ الجرد أو نجاح cross-compile لا يكفي

تبقى مثبتات Windows ومشاريع VCL/C++Builder طريق Windows؛ تؤهل crypto والطابع الزمني في Delphi macOS مستقلًا عن المكون المرئي FPC/LCL

إعادة التوزيع

عند توزيع تطبيقات تستخدم 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 إضافية
• توزيع خالٍ من حقوق الامتياز للتطبيقات المترجمة

استكشاف الأخطاء وإصلاحها

إلغاء التثبيت

لإزالة مكوّنات PDFium VCL:

1. استخدم Add/Remove Programs في Windows
2. أو شغّل أداة إزالة التثبيت من مجلد التثبيت
3. احذف يدويًا أي ملفات متبقية عند الحاجة