Hướng dẫn cài đặt
Yêu cầu hệ thống
- Delphi XE5 / C++Builder XE5 (RAD Studio XE5) đến Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
- Lazarus 1.0 trở lên (dành cho Free Pascal)
- Windows XP trở lên (Win32 / Win64)
- Tối thiểu 50 MB dung lượng đĩa trống
Các bước cài đặt
- Chạy trình cài đặt: Chạy
PDFiumPas-FULL.exe hoặc PDFiumPas-TRIAL.exe với quyền Administrator
- Chọn tích hợp IDE: Trên trang RAD Studio Integration, các Delphi personality được phát hiện sẽ được liệt kê trước với phiên bản mới nhất được chọn sẵn; các C++Builder personality được liệt kê riêng và mặc định tắt
- Chọn nội dung tùy chọn: Chỉ chọn C++Builder hoặc Lazarus khi cần cài các package file và demo project tương ứng
- Chọn đường dẫn cài đặt: Chọn thư mục nơi các component sẽ được cài
- Hoàn tất cài đặt: Làm theo hướng dẫn trên màn hình
- Xác minh cài đặt: Các component sau sẽ được thêm vào palette losLab:
- TPdf - Thành phần thao tác PDF cốt lõi
- TPdfView - Thành phần xem và tương tác với PDF
Trợ giúp bản địa hóa và bản dựng demo
- Trình cài đặt luôn cài các tài nguyên dùng chung trong
Docs rồi chỉ sao chép các thư mục ngôn ngữ trợ giúp được chọn theo tên locale Windows và LCID của ngôn ngữ giao diện
- Trợ giúp tiếng Anh dùng
en-GB cho các locale tiếng Anh được hỗ trợ ở British, Commonwealth và Caribbean; en-US được dùng cho các locale tiếng Anh khác và làm phương án dự phòng khi không có bộ trợ giúp theo vùng phù hợp
- Trợ giúp tiếng Tây Ban Nha được chia thành
es cho locale kiểu Tây Ban Nha và es-419 cho locale Mỹ Latinh; trợ giúp tiếng Trung được chia thành zh-cn và zh-tw
- Các bộ trợ giúp bản địa hóa khớp sẽ được thêm khi có sẵn cho các ngôn ngữ giao diện hoặc tên locale tiếng Ả Rập, Đức, Pháp, Ý, Nhật, Hàn, Hà Lan, Ba Lan, Bồ Đào Nha, Nga, Thụy Điển, Thổ Nhĩ Kỳ và tiếng Trung
- Các bản dựng demo Delphi và C++Builder sau cài đặt dùng RAD Studio root mới nhất đã chọn và yêu cầu đúng Delphi hoặc C++Builder personality cùng compiler Win32 / Win64 tương ứng
Cài đặt thủ công (nâng cao)
Nếu cài đặt tự động thất bại, bạn có thể cài thủ công các component
- Sao chép các file component vào library path của IDE
- Thêm library path vào search directories của IDE
- Cài design-time package thông qua Package Manager của IDE
- Biên dịch lại IDE để đăng ký các component
Phân phối lại
Khi phân phối ứng dụng dùng PDFium VCL
- Đặt cây
DLLs\Win32\pdfium.dll hoặc DLLs\Win64\pdfium.dll phù hợp bên cạnh ứng dụng của bạn hoặc trong thư mục ứng dụng cha
- Đối với hỗ trợ biểu mẫu V8/XFA, hãy đặt
DLLs\Win32\pdfium.v8.dll hoặc DLLs\Win64\pdfium.v8.dll phù hợp trong cùng cây DLLs và đặt EnableV8Engine trước khi tải
- Không cần thêm giấy phép runtime
- Phân phối miễn phí bản quyền cho ứng dụng đã biên dịch
Khắc phục sự cố
Các vấn đề thường gặp
- Component không hiển thị: Hãy bảo đảm IDE đã được khởi động lại sau khi cài đặt
- Lỗi runtime: Xác minh PDFium DLL đúng đang nằm trong
DLLs\Win32 hoặc DLLs\Win64, hoặc trực tiếp trong đường dẫn ứng dụng
- Lỗi truy cập bộ nhớ: Kiểm tra rằng mọi dependency bắt buộc đã được cài và kiến trúc DLL khớp với ứng dụng (32-bit so với 64-bit)
- Lỗi ở thời điểm thiết kế: Biên dịch lại package và khởi động lại IDE
- Biểu mẫu XFA không hoạt động: Hãy bảo đảm
pdfium.v8.dll tương ứng có sẵn trong thư mục DLLs của nền tảng và EnableV8Engine được đặt trước khi tải
Gỡ cài đặt
Để gỡ các component PDFium VCL
- Dùng Windows Add/Remove Programs
- Hoặc chạy trình gỡ cài đặt từ thư mục cài đặt
- Xóa thủ công các file còn sót lại nếu cần