Kurulum

Documentize SDK, farklı geliştirme ortamları ve tercihlere göre uyarlanmış birden fazla yöntemle kurulabilir. Documentize’i kurmanın önerilen yolları aşağıdadır:

1. NuGet (Tercih Edilen Yöntem)

NuGet, Documentize’i kurmanın en basit ve tercih edilen yöntemidir; bu, her zaman en son sürüm ve güncellemelerin geliştirme ortamınızda doğrudan bulunmasını sağlar. Bu kurulum yöntemi hakkında daha fazla detay için NuGet kullanarak Documentize SDK’lerini nasıl kurulur sayfasını kontrol edin.

2. MSI Kurulum Aracı

MSI kurulum aracı, Documentize DLL’lerinin doğrudan sisteminize kurulmasını tercih ediyorsanız uygun bir seçenektir. Bu yöntem, DLL dosyalarını manuel olarak yönetmeye gerek kalmadan Documentize’i birden fazla projede kullanmak isteyen geliştiriciler için idealdir. Bu kurulum yöntemi hakkında daha fazla detay için MSI kullanarak Documentize SDK’lerini nasıl kurulur sayfasını kontrol edin.

3. ZIP Arşivi

Manuel bir yaklaşımı tercih eden geliştiriciler için ZIP arşivi, Documentize DLL’lerini içerir ve bunlar doğrudan projenize eklenebilir. Bu kurulum yöntemi hakkında daha fazla detay için ZIP kullanarak Documentize SDK’lerini nasıl kurulur sayfasını kontrol edin.

Sistem Gereksinimleri

Documentize SDK’ları, .NET uygulamalarıyla entegre edilmek üzere tasarlanmış ve çeşitli işletim sistemleri ile geliştirme ortamlarını desteklemektedir. Aşağıda ana sistem gereksinimleri yer almaktadı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’ten Windows Server 2022’ye kadar (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önelen herhangi bir geliştirme ortamını desteklemektedir.

Desteklenen .NET Framework’ler

.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

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

Beyan

Documentize.com SDK’leri, .NET uygulamaları içinde kullanıldığında Tam Güven izin seti gerektirir. Bu izin seviyesi, SDK’lerin sistem düzeyinde belirli işlemleri gerçekleştirmesi için gereklidir; örneğin, kayıt defteri ayarlarına, sistem dosyalarına erişim sağlama ve yazı tiplerini çözümleme gibi.

Neden Tam Güven Gereklidir

Documentize SDK’leri, sıklıkla yüsek izinler gerektiren temel .NET sistem sınıflarını kullanır. Bunun sebepleri şunlardır:

Kayıt Defteri Erişimi: Bazı işlemler, sistem kayıt defterine okuma veya yazma gerektirebilir.
Sistem Dosyaları: Yazı tiplerini işleme veya dosya işlemleri yapma gibi belirli görevler için uygulamanın sanal dizini ötesindeki sistem dosyalarına erişim gerekebilir.

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

Orta Güven güvenliğini zorunlu kılan barındırma ortamlarında, birkaç önemli izin kısıtlanmış veya kullanılamaz durumdadır. Bu durum, SDK’lerin bu tür ortamlarda düzgün çalışmasını engelleyebilir. Orta Güven altında şu kısıtlamalar geçerlidir:

OleDbPermission: Veritabanlarına erişim için ADO.NET yönetilen OLE DB veri sağlayıcısını kullanamaz.
EventLogPermission: Windows Olay Günlüğüne erişim yasaktır.
ReflectionPermission: Yansıma kullanımını engeller; bu durum bazı dinamik işlemleri etkileyebilir.
RegistryPermission: Sistem kayıt defterine erişim reddedilir.
WebPermission: İletişim, <trust> elementinde yapılandırıldığı gibi önceden tanımlanmış adreslere veya aralıklara kısıtlanmıştır.
FileIOPermission: Dosyalara erişim, yalnızca uygulamanın sanal dizini içindeki dosyalarla sınırlıdır.

Windows Dışı Ortam

Documentize SDK’ları .NET Standard 2.0‘ı destekler; bu, bunların Linux veya diğer Windows dışı ortamlarda çalışan .NET Core uygulamalarında kullanılmasına olanak tanır. Optimal performans ve doğru metin akışı sağlamak için aşağıdaki adımları izleyin:

Linux için Önerilen Kurulum

1. libgdiplus Paketi Kurun

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

sudo apt-get install libgdiplus

2. Microsoft Uyumlu Yazı Tiplerini Kurun

Doğru metin akışı için Microsoft TrueType yazı tiplerini aşağıdaki komutla kurun:

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’larıyla herhangi bir işlem yapmadan önce kodunuzda yolu güncelleyin:

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

Bahşiş

Bu kurulumların eksiksiz olduğundan ve yazı tipi yolunun doğru bir şekilde yapılandırıldığından emin olarak, Documentize SDK’larının Linux veya diğer Windows dışı sistemlerdeki performansını en üst düzeye çıkarabilirsiniz.

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 aynı olup, tek fark, lisansın nasıl uygulanacağıdır.

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

Değerlendirme sürümü tüm özelliklere tam erişim sağlasa da, bir lisans uygulanana kadar aşağıdaki sınırlamalar bulunmaktadır:

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 bir lisans uygulamanız yeterlidir.