Kurulum

Documentize SDK, farklı geliştirme ortamlarına ve tercihlere göre özelleştirilmiş birden fazla yöntemle kurulabilir. Aşağıda Documentize’i kurmanın önerilen yolları bulunmaktadır:

1. NuGet (Tercih Edilen Yöntem)

NuGet, Documentize’i kurmanın en basit ve tercih edilen yöntemidir; böylece her zaman en son sürümü ve güncellemeleri doğrudan geliştirme ortamınızda almış olursunuz. Bu kurulum yöntemi hakkında daha fazla bilgi için Documentize SDK’larını NuGet kullanarak nasıl kurulur başlıklı içeriği kontrol edin.

2. MSI Yükleyici

MSI yükleyici, Documentize DLL’lerini doğrudan sisteminize kurmayı tercih ediyorsanız kullanışlı bir seçenektir. Bu yöntem, Documentize’i birden fazla projede kullanmak isteyen geliştiriciler için idealdir; böylece DLL dosyalarını manuel olarak yönetmek zorunda kalmazsınız. Bu kurulum yöntemi hakkında daha fazla bilgi için Documentize SDK’larını MSI kullanarak nasıl kurulur başlıklı içeriği kontrol edin.

3. ZIP Arşivi

Manuel bir yaklaşımı tercih eden geliştiriciler için ZIP arşivi, Documentize DLL’lerini içerir; bu DLL’ler çıkartılarak doğrudan projenize eklenebilir. Bu kurulum yöntemi hakkında daha fazla bilgi için Documentize SDK’larını ZIP kullanarak nasıl kurulur başlıklı içeriği kontrol edin.

Sistem Gereksinimleri

Documentize SDK’ları, .NET uygulamalarıyla entegrasyon için tasarlanmış ve çeşitli işletim sistemleri ve geliştirme ortamlarını desteklemektedir. Aşağıda ana sistem gereksinimleri bulunmaktadır:

Desteklenen İşletim Sistemleri

Windows

Windows 7 (x64, x86)
Windows 8, 8.1 (x64, x86)
Windows 10 (x64, x86)
Windows 11 (x64, x86)
Windows Server 2003 ile Windows Server 2022 (x64, x86)
Bulut: Microsoft Azure

macOS

macOS 10.12 (Sierra) ve sonrası

Linux

Birden fazla Linux dağıtımıyla uyumludur:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)

Android

Android 8.0 (Oreo) ve sonrası desteklenmektedir.

Geliştirme Ortamları

Microsoft Visual Studio:
- Visual Studio 2010 ve sonrası (2019 ve 2022 dahil)
.NET platformlarına yönelik herhangi bir geliştirme ortamını destekler.

Desteklenen .NET Çerçeveleri

.NET Framework 4.0 ve üzeri
.NET Standard 2.0 (.NET Core 3.1+)
.NET 6.0, .NET 7.0, .NET 8.0

Ek Notlar

Adobe Acrobat, Documentize SDK’larının çalışması için gerekli değildir, ancak PDF görüntülemek için önerilir.

Beyanat

Documentize.com SDK’leri, .NET uygulamaları içinde kullanıldığında Tam Güven izni seti gerektirir. Bu izin seviyesi, SDK’lerin kayıt defteri ayarlarına, sistem dosyalarına erişim gibi bazı sistem düzeyinde işlemleri gerçekleştirmesi için çok önemlidir.

Neden Tam Güven Gereklidir

Documentize SDK’leri, genellikle aşağıdaki nedenlerden ötürü yükseltilmiş izinlere ihtiyaç duyan temel .NET sistem sınıflarını kullanır:

Kayıt Defteri Erişimi: Bazı işlemler, sistem kayıt defterine okuma veya yazma yapmayı gerektirebilir.
Sistem Dosyaları: Belirli görevler için uygulamanın sanal dizininden öteye gidebilecek sistem dosyalarına erişim gerekebilir, örneğin yazı tiplerini işlemek veya dosya işlemleri gerçekleştirmek.

Orta Güvenli Ortamın Sınırlamaları

Orta Güven güvenliğini uygulayan barındırma ortamlarında, birçok önemli iznin kısıtlandığı veya mevcut olmadığı durumlar vardır. Bu, SDK’lerin bu tür ortamlarda doğru şekilde çalışmasını engelleyebilir. Orta Güven altında aşağıdaki kısıtlamalar geçerlidir:

OleDbPermission: Veritabanlarına erişmek için ADO.NET yönetilen OLE DB veri sağlayıcısı kullanılamaz.
EventLogPermission: Windows Olay Kaydı’na erişim yasaktır.
ReflectionPermission: Yansıtma kullanımını engeller; bu da belirli dinamik işlemler üzerinde etkili olabilir.
RegistryPermission: Sistem kayıt defterine erişim reddedilir.
WebPermission: İletişim, <trust> elemanında yapılandırıldığı gibi önceden tanımlanmış adreslere veya aralıklara sınırlıdır.
FileIOPermission: Dosyalara erişim, yalnızca uygulamanın sanal dizini içindeki dosyalarla sınırlıdır.

Non-Windows Ortam

Documentize SDK’leri .NET Standard 2.0‘ı destekler, bu da onları Linux veya diğer Windows dışı ortamlarda çalışan .NET Core uygulamalarında kullanılabilir hale getirir. Optimal performansı ve doğru metin render’lamayı sağlamak için aşağıdaki adımları izleyin:

Linux için Önerilen Kurulum

1. libgdiplus Paketini Yükleyin

Bu paket, PDF’lerin render’lanması ve işlenmesi için kritik olan gerekli GDI+ işlevselliğini sağlar. Terminalinizde aşağıdaki komutu çalıştırarak yükleyebilirsiniz:

sudo apt-get install libgdiplus

2. Microsoft Uyumlu Yazıtiplerini Yükleyin

Doğru metin render’laması için, Microsoft TrueType yazıtiplerini yüklemek üzere şu komutu kullanın:

sudo apt-get install ttf-mscorefonts-installer

Bu yazıtipleri, /usr/share/fonts/truetype/msttcorefonts dizinine yerleştirilmelidir. Eğer sisteminiz yazıtiplerini farklı bir dizinde saklıyorsa, Documentize SDK’leri ile herhangi bir işlem yapmadan önce kodunuzda yolu güncelleyin:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<yazıtipleri yolu>"));

Bahşiş

Bu kurulumların tamamlandığından emin olun ve yazıtipi yolunu doğru bir şekilde yapılandırarak, Documentize SDK’lerinin Linux veya diğer Windows dışı sistemlerdeki performansını maksimize edebilirsiniz.

Değerlendirme

Documentize SDK’larını değerlendirme amaçları için kolayca indirebilirsiniz. Değerlendirme sürümü, satın alınan sürümle tamamen aynıdır, tek fark lisansın nasıl uygulandığıdır.

Değerlendirme Sürümünün Sınırlamaları

Değerlendirme sürümü tüm özelliklere tam erişim sağlarken, bir lisans uygulanana kadar aşağıdaki sınırlamaları içerir:

Tüm çıktı belgelerine bir değerlendirme filigranı eklenir.
Herhangi bir PDF belgesinin yalnızca ilk dört sayfası görüntülenebilir veya düzenlenebilir.

Bu sınırlamaları kaldırmak ve tam sürümü açmak için projenize birkaç satır kod ekleyerek basitçe bir lisans uygulayabilirsiniz.