คู่มือการติดตั้ง
ข้อกำหนดของระบบ
- 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 personalities ที่ตรวจพบไว้ก่อนโดยทำเครื่องหมายเลือกเวอร์ชันใหม่สุดไว้แล้ว C++Builder personalities จะถูกแยกเป็นอีกชุดและปิดไว้ตามค่าเริ่มต้น
- เลือกเนื้อหาเสริม: ทำเครื่องหมาย C++Builder หรือ Lazarus เฉพาะเมื่อควรติดตั้งไฟล์แพ็กเกจและโปรเจ็กต์ตัวอย่างเหล่านั้น
- เลือกเส้นทางติดตั้ง: เลือกไดเรกทอรีที่จะติดตั้งคอมโพเนนต์
- ติดตั้งให้เสร็จ: ทำตามคำแนะนำบนหน้าจอ
- ตรวจสอบการติดตั้ง: คอมโพเนนต์ต่อไปนี้จะถูกเพิ่มลงในพาเลตต์ losLab:
- TPdf - คอมโพเนนต์หลักสำหรับจัดการ PDF
- TPdfView - คอมโพเนนต์สำหรับดู PDF และโต้ตอบ
ความช่วยเหลือแบบโลคัลไลซ์และบิลด์ตัวอย่าง
- ตัวติดตั้งจะติดตั้ง assets ที่ใช้ร่วมกันใน
Docs เสมอ จากนั้นคัดลอกเฉพาะโฟลเดอร์ภาษาความช่วยเหลือที่เลือกตามชื่อ locale ของ Windows และ LCID ของภาษาของ UI
- ความช่วยเหลือภาษาอังกฤษใช้
en-GB สำหรับ locale อังกฤษแบบอังกฤษ เครือจักรภพ และแคริบเบียนที่รองรับ ส่วน en-US ใช้กับ locale อังกฤษอื่น ๆ และเป็นตัว fallback เมื่อไม่มีชุดความช่วยเหลือภูมิภาคที่ตรงกัน
- ความช่วยเหลือภาษาสเปนแยกระหว่าง
es สำหรับ locale แบบสเปน และ es-419 สำหรับ locale ละตินอเมริกา ส่วนความช่วยเหลือภาษาจีนแยกระหว่าง zh-cn และ zh-tw
- ชุดความช่วยเหลือแบบโลคัลไลซ์ที่ตรงกันจะถูกเพิ่มเมื่อมีให้สำหรับภาษา UI หรือชื่อ locale ของ Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Swedish, Turkish และ Chinese
- บิลด์ตัวอย่าง Delphi และ C++Builder หลังติดตั้งจะใช้ RAD Studio root ล่าสุดที่เลือกไว้ และต้องมี personality ของ Delphi หรือ C++Builder ที่ตรงกันพร้อมคอมไพเลอร์ Win32 / Win64 ที่ร้องขอ
การติดตั้งด้วยตนเอง (ขั้นสูง)
ถ้าการติดตั้งอัตโนมัติล้มเหลว คุณสามารถติดตั้งคอมโพเนนต์ด้วยตนเองได้:
- คัดลอกไฟล์คอมโพเนนต์ไปยัง library path ของ IDE
- เพิ่ม library path ลงใน search directories ของ IDE
- ติดตั้ง design-time package ผ่าน Package Manager ของ IDE
- rebuild IDE ของคุณเพื่อจดทะเบียนคอมโพเนนต์
การแจกจ่ายต่อ
เมื่อแจกจ่ายแอปพลิเคชันที่ใช้ PDFium VCL:
- รวม tree
DLLs\Win32\pdfium.dll หรือ DLLs\Win64\pdfium.dll ที่ตรงกันไว้ข้างแอปพลิเคชันของคุณหรือในโฟลเดอร์แอปพลิเคชันแม่
- สำหรับการรองรับฟอร์ม V8/XFA ให้รวม
DLLs\Win32\pdfium.v8.dll หรือ DLLs\Win64\pdfium.v8.dll ที่ตรงกันไว้ใน tree DLLs เดียวกันและตั้ง EnableV8Engine ก่อนโหลด
- ไม่ต้องใช้สิทธิ์ runtime เพิ่มเติม
- แจกจ่ายแอปพลิเคชันที่คอมไพล์แล้วได้โดยไม่ต้องจ่ายค่าลิขสิทธิ์
การแก้ปัญหา
ปัญหาที่พบบ่อย:
- มองไม่เห็นคอมโพเนนต์: ตรวจสอบว่าได้รีสตาร์ต IDE หลังติดตั้งแล้ว
- ข้อผิดพลาด runtime: ตรวจสอบว่า PDFium DLL ที่ถูกต้องอยู่ใน
DLLs\Win32 หรือ DLLs\Win64 หรืออยู่ตรงใน path ของแอปพลิเคชัน
- การละเมิดการเข้าถึง: ตรวจว่าติดตั้ง dependency ที่ต้องใช้ครบแล้ว และสถาปัตยกรรมของ DLL ตรงกับแอปพลิเคชัน (32-bit เทียบกับ 64-bit)
- ข้อผิดพลาด design-time: rebuild packages และรีสตาร์ต IDE
- ฟอร์ม XFA ใช้งานไม่ได้: ตรวจสอบว่า
pdfium.v8.dll ที่ตรงกันพร้อมใช้อยู่ในโฟลเดอร์ platform DLLs และตั้ง EnableV8Engine ก่อนโหลด
การถอนการติดตั้ง
หากต้องการลบคอมโพเนนต์ PDFium VCL:
- ใช้ Windows Add/Remove Programs
- หรือเรียก uninstaller จากไดเรกทอรีที่ติดตั้งไว้
- ลบไฟล์ที่เหลือด้วยตนเองหากจำเป็น