Kurulum Rehberi

Sistem Gereksinimleri

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) sürümünden Delphi/C++Builder 13.1 Florence (RAD Studio 13.1) sürümüne kadar
• Lazarus 1.0 ve üzeri (Free Pascal için)
• Windows XP ve üzeri (Win32 / Win64)
• En az 50 MB boş disk alanı

Kurulum Adımları

1. Kurulum programını çalıştırın: PDFiumPas-FULL.exe veya PDFiumPas-TRIAL.exe dosyasını yönetici olarak çalıştırın
2. IDE entegrasyonunu seçin: RAD Studio Integration sayfasında algılanan Delphi personality'leri, en yeni sürüm önceden işaretli biçimde en üstte listelenir; C++Builder personality'leri ayrı listelenir ve varsayılan olarak kapalı gelir
3. İsteğe bağlı içeriği seçin: C++Builder veya Lazarus için paket dosyaları ve demo projelerinin de kurulmasını istiyorsanız yalnızca bunları işaretleyin
4. Kurulum yolunu belirleyin: Bileşenlerin kurulacağı dizini seçin
5. Kurulumu tamamlayın: Ekrandaki yönergeleri izleyin
6. Kurulumu doğrulayın: Aşağıdaki bileşenler losLab paletine eklenir:
   • TPdf - Temel PDF işleme bileşeni
   • TPdfView - PDF görüntüleme ve etkileşim bileşeni

Yerelleştirilmiş Yardım ve Demo Build'leri

• Kurulum programı paylaşılan Docs kaynaklarını her zaman kurar; ardından yalnızca Windows locale adı ve UI language LCID'sine göre seçilen yardım dili klasörlerini kopyalar
• İngilizce yardım, desteklenen İngiltere, Commonwealth ve Karayip İngilizcesi locale'leri için en-GB kullanır; diğer İngilizce locale'ler için en-US kullanılır ve eşleşen bölgesel yardım seti bulunmadığında da yedek olarak aynı set devreye girer
• İspanyolca yardım, İspanya tarzı locale'ler için es, Latin Amerika locale'leri için es-419 olarak ikiye ayrılır; Çince yardım ise zh-cn ve zh-tw olarak ayrılır
• Arapça, Almanca, Fransızca, İtalyanca, Japonca, Korece, Felemenkçe, Lehçe, Portekizce, Rusça, İsveççe, Türkçe ve Çince UI dilleri ya da locale adları için eşleşen yerelleştirilmiş yardım setleri, mevcut olduklarında eklenir
• Kurulum sonrası Delphi ve C++Builder demo build'leri, seçilen en güncel RAD Studio kökünü kullanır; eşleşen Delphi ya da C++Builder personality'sini ve istenen Win32 / Win64 derleyicisini gerektirir

Manuel Kurulum (İleri Düzey)

Otomatik kurulum başarısız olursa bileşenleri elle kurabilirsiniz:

1. Bileşen dosyalarını IDE'nizin library path'ine kopyalayın
2. Library path'ini IDE'nizin arama dizinlerine ekleyin
3. Tasarım zamanı paketini IDE'nin Package Manager'ı üzerinden kurun
4. Bileşenleri kaydettirmek için IDE'yi yeniden derleyin

Yerel Free Pascal ve LCL Platformları

Yerel sarmalayıcı derlemeleri, işletim sistemi ve CPU ile eşleşen bir Free Pascal derleyicisi, Lazarus/LCL ve PDFium paylaşılan kitaplığı kullanır. Nitelikli yapılandırmalar Linux x86_64'te Qt6 ile FPC 3.3.1 ve LCL 4.99, macOS arm64'te ise Cocoa kullanır

Seçili widget setiyle yerel çalıştırılabilir dosyaları ve birimleri ayrı hedef dizinlerde derleyin. İlgili LCL ve lazutils birim yollarını sağlayın ve derleyicinin gerçek hedef yapılandırmasını kullanın; Windows DCU/PPU dosyaları ve Windows DLL'leri Unix çıktıları olarak yeniden kullanılamaz

Yüklemeden önce LibraryName değerini amaçlanan libpdfium.so ya da libpdfium.dylib yoluna ayarlayın. Sıradan ya da V8 runtime o hedefle eşleşmeli ve istenen özellikleri sunmalıdır. Eksik V8/XFA yetenekleri kullanılamaz özellikler olarak kalır; bir kitaplık dosya adı bunları tesis etmez

Sistem yazı tipi erişimi Linux'ta fontconfig, macOS'te CoreText kullanır; isteğe bağlı CID yazı tipi alt kümeleme, tutulan glif kimlikleriyle HarfBuzz kullanır. LCL bitmap'leri gerçek bayt sıralarını ve kanal tanımlarını kullanır; yerel tampon düzeni doğrudan kullanılamadığında dönüştürme yapılır

Tests/PlatformAcceptance/run_native.py ve NativeWrapper.lpr, yükleme, render, metin, formlar, kaydetme, iptal ve yaşam döngüsü denetimleri için kaynağa bağlı yerel kabul sağlar. Hedef çalıştırılabilir dosyayı gerçek ana makinesinde çalıştırın ve raporu saklayın; yalnızca bir hazır olma envanteri ya da başarılı bir çapraz derleme yeterli değildir

Windows yükleyicileri ve VCL/C++Builder projeleri, Windows kurulum yolu olarak kalır. Yerel Delphi macOS kripto ve zaman damgası yardımcıları, FPC/LCL görsel bileşeninden ayrı olarak nitelendirilir

Yeniden Dağıtım

PDFium VCL kullanan uygulamaları dağıtırken:

• Eşleşen DLLs\Win32\pdfium.dll veya DLLs\Win64\pdfium.dll ağacını uygulamanızın yanına ya da üst uygulama klasörüne ekleyin
• V8/XFA form desteği için eşleşen DLLs\Win32\pdfium.v8.dll veya DLLs\Win64\pdfium.v8.dll dosyasını aynı DLL ağacına ekleyin ve yüklemeden önce EnableV8Engine değerini ayarlayın
• Ek çalışma zamanı lisansı gerekmez
• Derlenmiş uygulamalar için telifsiz dağıtım

Sorun Giderme

Kaldırma

PDFium VCL bileşenlerini kaldırmak için:

1. Windows Program Ekle/Kaldır'ı kullanın
2. Ya da kurulum dizininden kaldırıcıyı çalıştırın
3. Gerekirse kalan dosyaları elle temizleyin