설치 안내

시스템 요구 사항

• 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를 관리자 권한으로 실행합니다
2. IDE 통합 선택: RAD Studio Integration 페이지에서 감지된 Delphi personality가 먼저 나열되고 최신 버전이 미리 선택됩니다. C++Builder personality는 별도로 나열되며 기본적으로는 꺼져 있습니다
3. 선택 콘텐츠 선택: 해당 패키지 파일과 데모 프로젝트를 함께 설치하려는 경우에만 C++Builder 또는 Lazarus를 선택합니다
4. 설치 경로 선택: 컴포넌트를 설치할 디렉터리를 선택합니다
5. 설치 완료: 화면의 지시에 따릅니다
6. 설치 확인: 다음 컴포넌트가 losLab 팔레트에 추가됩니다:
   • TPdf - 핵심 PDF 조작 컴포넌트
   • TPdfView - PDF 보기 및 상호 작용 컴포넌트

현지화된 도움말 및 데모 빌드

• 설치 관리자는 공유 Docs 에셋을 항상 설치한 뒤, Windows 로캘 이름과 UI 언어 LCID가 가리키는 도움말 언어 폴더만 복사합니다
• 영어 도움말은 지원되는 영국식·영연방권·카리브해 영어 로캘에는 en-GB를 사용하고, 그 밖의 영어 로캘에는 en-US를 사용하며, 어느 지역 도움말 세트와도 일치하지 않을 때의 기본 대체이기도 합니다
• 스페인어 도움말은 스페인식 로캘용 es와 라틴아메리카 로캘용 es-419로 나뉘며, 중국어 도움말은 zh-cn과 zh-tw로 나뉩니다
• 아랍어, 독일어, 프랑스어, 이탈리아어, 일본어, 한국어, 네덜란드어, 폴란드어, 포르투갈어, 러시아어, 스웨덴어, 터키어, 중국어 UI 언어나 로캘 이름에는 사용 가능한 현지화 도움말 세트가 함께 추가됩니다
• 설치 후 Delphi 및 C++Builder 데모 빌드는 마지막으로 선택한 RAD Studio 루트를 사용하며, 일치하는 Delphi 또는 C++Builder personality와 요청된 Win32 / Win64 컴파일러가 필요합니다

수동 설치 (고급)

자동 설치가 실패하면 컴포넌트를 수동으로 설치할 수 있습니다:

1. 컴포넌트 파일을 IDE의 라이브러리 경로에 복사합니다
2. 라이브러리 경로를 IDE의 검색 디렉터리에 추가합니다
3. IDE의 Package Manager를 통해 디자인 타임 패키지를 설치합니다
4. 컴포넌트를 등록하도록 IDE를 다시 빌드합니다

네이티브 Free Pascal 및 LCL 플랫폼

네이티브 래퍼 빌드에는 OS와 CPU가 일치하는 Free Pascal 컴파일러, Lazarus/LCL, PDFium 공유 라이브러리가 필요합니다. 검증된 구성은 FPC 3.3.1과 LCL 4.99이며, Linux x86_64에서는 Qt6, macOS arm64에서는 Cocoa를 사용합니다

선택한 widget set으로 네이티브 실행 파일과 유닛을 별도 대상 디렉터리에 빌드하세요. 대응하는 LCL 및 lazutils 유닛 경로를 제공하고 컴파일러의 실제 타깃 설정을 사용해야 합니다. Windows DCU/PPU 파일과 Windows DLL을 Unix 출력으로 재사용할 수는 없습니다

로드하기 전에 LibraryName을 사용할 libpdfium.so 또는 libpdfium.dylib 경로로 설정하세요. 일반 런타임이든 V8 런타임이든 타깃과 일치하고 요청한 기능을 제공해야 합니다. V8/XFA 기능이 없으면 해당 기능은 계속 사용할 수 없습니다. 라이브러리 파일 이름만으로 기능 지원을 확인할 수는 없습니다

시스템 글꼴은 Linux에서 fontconfig, macOS에서 CoreText로 접근합니다. 선택적인 CID 글꼴 subsetting은 원래 glyph ID를 유지하는 HarfBuzz를 사용합니다. LCL 비트맵은 실제 바이트 순서와 채널 정의를 따르며, 네이티브 버퍼 레이아웃을 직접 사용할 수 없으면 변환합니다

Tests/PlatformAcceptance/run_native.py와 NativeWrapper.lpr는 해당 소스로 빌드한 네이티브 환경에서 로드, 렌더링, 텍스트, 폼, 저장, 취소, 수명 주기 검증을 제공합니다. 타깃 실행 파일을 실제 호스트에서 실행하고 보고서를 보관하세요. 준비 상태 목록이나 성공적인 cross-compile만으로는 충분하지 않습니다

Windows에서는 기존 Windows 설치 프로그램과 VCL/C++Builder 프로젝트로 설치합니다. 네이티브 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을 설정합니다
• 추가 런타임 라이선스가 필요하지 않습니다
• 컴파일된 애플리케이션은 로열티 없이 배포할 수 있습니다

문제 해결

제거

PDFium VCL 컴포넌트를 제거하려면:

1. Windows 프로그램 추가/제거를 사용합니다
2. 또는 설치 디렉터리에서 제거 프로그램을 실행합니다
3. 필요하면 남아 있는 파일을 수동으로 제거합니다