Przewodnik instalacji

Wymagania systemowe

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) do Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 lub nowszy (dla Free Pascal)
• Windows XP lub nowszy (Win32 / Win64)
• Minimum 50 MB wolnego miejsca na dysku

Kroki instalacji

1. Uruchom instalator: wykonaj PDFiumPas-FULL.exe lub PDFiumPas-TRIAL.exe jako Administrator
2. Wybierz integrację z IDE: na stronie RAD Studio Integration wykryte personality Delphi są wymienione jako pierwsze, z wstępnie zaznaczoną najnowszą wersją; personality C++Builder są wymienione osobno i są domyślnie wyłączone
3. Wybierz zawartość opcjonalną: zaznacz C++Builder lub Lazarus tylko wtedy, gdy pakiety i projekty demo dla tych środowisk mają zostać zainstalowane
4. Wybierz ścieżkę instalacji: wskaż katalog, w którym zostaną zainstalowane komponenty
5. Zakończ instalację: postępuj zgodnie z instrukcjami na ekranie
6. Zweryfikuj instalację: do palety losLab zostaną dodane następujące komponenty:
   • TPdf - główny komponent manipulacji PDF
   • TPdfView - komponent przeglądania i interakcji z PDF

Zlokalizowana pomoc i buildy demo

• Instalator zawsze instaluje wspólne zasoby Docs, a następnie kopiuje tylko foldery pomocy wybrane na podstawie Windows locale name oraz UI language LCID
• Pomoc angielska używa en-GB dla obsługiwanych brytyjskich, wspólnotowych (Commonwealth) i karaibskich locale angielskich; en-US stosuje się dla pozostałych locale angielskich oraz jako fallback, gdy żaden regionalny zestaw pomocy nie pasuje
• Pomoc hiszpańska jest podzielona na es dla locales w stylu Hiszpanii oraz es-419 dla locales Ameryki Łacińskiej; pomoc chińska jest podzielona na zh-cn i zh-tw
• Pasujące zlokalizowane zestawy pomocy są dodawane, jeśli są dostępne, dla języków UI lub nazw locale: arabskiego, niemieckiego, francuskiego, włoskiego, japońskiego, koreańskiego, niderlandzkiego, polskiego, portugalskiego, rosyjskiego, szwedzkiego, tureckiego i chińskiego
• Buildy demo dla Delphi i C++Builder wykonywane po instalacji korzystają z najnowszego wybranego katalogu głównego RAD Studio i wymagają pasującej personality Delphi lub C++Builder oraz żądanego kompilatora Win32 / Win64

Instalacja ręczna (zaawansowana)

Jeśli instalacja automatyczna zawiedzie, możesz zainstalować komponenty ręcznie:

1. Skopiuj pliki komponentów do ścieżki bibliotek swojego IDE
2. Dodaj ścieżkę biblioteki do katalogów wyszukiwania IDE
3. Zainstaluj pakiet czasu projektowania przez menedżera pakietów IDE
4. Przebuduj IDE, aby zarejestrować komponenty

Natywne platformy Free Pascal i LCL

Natywne kompilacje nakładki używają dopasowanego do systemu i CPU kompilatora Free Pascal, Lazarus/LCL oraz współdzielonej biblioteki PDFium. Zakwalifikowane konfiguracje używają FPC 3.3.1 z LCL 4.99, Qt6 na Linux x86_64 oraz Cocoa na macOS arm64

Buduj natywne pliki wykonywalne i moduły w osobnych katalogach docelowych z wybranym zestawem widżetów. Dostarcz odpowiednie ścieżki modułów LCL i lazutils i użyj rzeczywistej konfiguracji docelowej kompilatora; pliki DCU/PPU z Windows i biblioteki DLL z Windows nie mogą być ponownie użyte jako wyniki uniksowe

Ustaw LibraryName na zamierzoną ścieżkę libpdfium.so lub libpdfium.dylib przed załadowaniem. Zwykły runtime albo runtime V8 musi pasować do tego celu i udostępniać żądane funkcje. Brakujące możliwości V8/XFA pozostają niedostępnymi funkcjami; sama nazwa pliku biblioteki ich nie ustanawia

Dostęp do czcionek systemowych używa fontconfig na Linuksie i CoreText na macOS; opcjonalne tworzenie podzbiorów czcionek CID używa HarfBuzz z zachowanymi identyfikatorami glifów. Bitmapy LCL używają rzeczywistej kolejności bajtów i opisu kanałów, z konwersją, gdy natywnego układu bufora nie można użyć bezpośrednio

Tests/PlatformAcceptance/run_native.py i NativeWrapper.lpr dostarczają powiązanej ze źródłem natywnej akceptacji dla wczytywania, renderowania, tekstu, formularzy, zapisu, anulowania i kontroli cyklu życia. Uruchom docelowy plik wykonywalny na jego rzeczywistym hoście i zachowaj raport; sam inwentarz gotowości albo udana kompilacja skrośna nie wystarczą

Instalatory Windows oraz projekty VCL/C++Builder pozostają windowsową ścieżką instalacji. Natywne pomocniki kryptograficzne i znaczników czasu Delphi dla macOS są kwalifikowane osobno od wizualnego komponentu FPC/LCL

Redystrybucja

Przy dystrybucji aplikacji korzystających z PDFium VCL:

• Dołącz pasujące drzewo DLLs\Win32\pdfium.dll lub DLLs\Win64\pdfium.dll obok aplikacji lub w nadrzędnym folderze aplikacji
• Dla obsługi formularzy V8/XFA dołącz pasującą DLLs\Win32\pdfium.v8.dll lub DLLs\Win64\pdfium.v8.dll do tego samego drzewa DLLs i ustaw EnableV8Engine przed załadowaniem
• Bez dodatkowych licencji środowiska uruchomieniowego
• Redystrybucja bezopłatowa (royalty-free) dla skompilowanych aplikacji

Rozwiązywanie problemów

Dezinstalacja

Aby usunąć komponenty PDFium VCL:

1. Użyj Windows Dodaj lub usuń programy
2. Albo uruchom dezinstalator z katalogu instalacji
3. W razie potrzeby ręcznie usuń pozostałe pliki