Documentize'i NuGet ile Kurma

NuGet Paket Yöneticisi Konsolu ile Nasıl Kurulur

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. Paket Yöneticisi Konsoluna Erişim Sağlayın:

   • Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu’na gidin.

3. Paketi Kurun:

   • En son tam sürümü kurmak için Install-Package Documentize komutunu girin.
   • Güncellemeleri de içeren en son sürümü kurmak için Install-Package Documentize -prerelease komutunu kullanın.
   • Komutu çalıştırmak için Enter‘a basın.

NuGet Paket Yöneticisi Konsolu ile Paketi Nasıl Güncelleyebilirsiniz

Documentize’i NuGet ile kurduysanız ve en son sürüme güncellemek istiyorsanız:

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. Paket Yöneticisi Konsoluna Erişim Sağlayın:

   • Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu’na gidin.

3. Paketi Güncelleyin:

   • En son tam sürüme güncellemek için Update-Package Documentize komutunu girin.
   • Güncellemeleri de içeren en son sürüme güncellemek için Update-Package Documentize -prerelease komutunu kullanın.
   • Komutu çalıştırmak için Enter‘a basın.

NuGet Paket Yöneticisi GUI ile Nasıl Kurulur

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. NuGet Paketlerini Yönetmeye Gidin:

   • Proje menüsünden NuGet Paketlerini Yönet seçeneğini seçin.

3. Documentize için Arama Yapın:

   • Gözat sekmesine gidin ve arama kutusuna Documentize yazın.

4. Paketi Kurun:

   • Documentize’in en son sürümünün yanındaki Kur/Güncelle düğmesine tıklayın.
   • Açılan pencerede Kabul Et’e tıklayarak onaylayın.

NuGet Kullanmanın Artıları

• Otomatik Bağımlılık Yönetimi:

  • NuGet, bağımlılıkları otomatik olarak yönetir ve gerekli tüm kütüphanelerin dahil edilmesini ve doğru şekilde güncellenmesini sağlar. Bu, kayıp veya uyumsuz bağımlılık riskini azaltır.

• Kolay Güncellemeler:

  • Paketleri güncellemek NuGet ile basittir; ister Paket Yöneticisi Konsolu ile ister GUI aracılığıyla. Bu, kütüphanelerinizi en son özellikler ve hata düzeltmeleri ile güncel tutmayı kolaylaştırır.

• Visual Studio ile Entegre:

  • NuGet, Visual Studio ile sorunsuz bir şekilde entegre edilmiştir ve geliştirici ortamından çıkmadan paketleri yönetmek için kullanıcı dostu bir arayüz sunar.

• Sürümleme:

  • NuGet, kütüphanelerin farklı sürümlerini belirtmenizi ve yönetmenizi sağlar; böylece önceki sürümlere kolayca geri dönebilir veya yeni sürümleri test edebilirsiniz.

NuGet Kullanmanın Eksileri

• Sadece Visual Studio ile Sınırlı:

  • NuGet, öncelikle Visual Studio içinde kullanılmak üzere tasarlanmıştır. Diğer ortamlarda kullanılabilse de, entegrasyon en sağlam Visual Studio’dadır.

• Sürüm Çatışması Potansiyeli:

  • Birçok bağımlılığı olan büyük projelerde, sürümlerin yönetimi ve çatışmaların çözülmesi karmaşık hale gelebilir. NuGet, bunu yönetmek için araçlar sunar, ancak dikkatli bir dikkat gerektirir.

• Ağ Bağlantısı Gereksinimi:

  • Paketleri kurmak ve güncellemek için internet bağlantısı gereklidir. Kısıtlı veya internet erişimi olmayan bir ortamda çalışıyorsanız, çevrimdışı yöntemler veya paketleri önceden indirme yöntemlerini kullanmanız gerekebilir.

• Büyük Projeler İçin Karmaşıklık:

  • Çok büyük projelerle geniş bağımlılık ağaçlarına sahip olduğunda, NuGet aracılığıyla paket yönetiminin getirdiği yük zorlayıcı hale gelebilir. Bu tür durumlarda, bağımlılıkları etkili bir şekilde yönetmek için ek araçlar veya stratejiler gerekebilir.

Documentize'yi MSI ile Kurma

MSI Yükleyici ile Nasıl Kurulur

1. MSI Yükleyicisini İndirin:

   • En son versiyon için MSI yükleyicisini indirmek üzere v24.12 MSI üzerine tıklayın.

2. Yükleyiciyi Çalıştırın:

   • İndirilen MSI dosyasına çift tıklayarak kurulum sihirbazını başlatın.

3. Kurulum Sihirbazını Takip Edin:

   • Yükleyici tarafından sağlanan ekrandaki talimatları takip edin. Lisans anlaşmasını kabul etmeniz ve kurulum seçeneklerini seçmeniz gerekebilir.

4. Kurulumu Tamamlayın:

   • Kurulum tamamlandığında, Documentize DLL’leri sisteminizin Global Assembly Cache (GAC) veya başka bir belirtilen konuma kurulmuş olacaktır.

5. Kurulumu Doğrulayın:

   • DLL’lerin belirtilen kurulum dizininde veya GAC’de mevcut olduğunu doğrulayarak doğru bir şekilde kurulduğundan emin olun.

MSI Yükleyicisini Kullanmanın Artıları

• Kullanım Kolaylığı:

  • MSI yükleyicisi, basit ve yönlendirilmiş bir kurulum süreci sunar. Gerekli tüm yapılandırmaları halleder ve DLL’leri merkezi bir konuma yerleştirir, böylece Documentize’i birden fazla projede kullanmak kolaydır.

• Sistem genelinde Kurulum:

  • MSI yöntemi, Documentize’i sistemin Global Assembly Cache (GAC) veya başka bir merkezi konuma kurar. Bu, sistemdeki herhangi bir uygulamanın DLL’lere erişmesini sağlar, her projede bireysel olarak referans vermek gerekmez.

• Otomatik Güncellemeler:

  • Documentize bir güncellenmiş yükleyici sağlarsa, yeni MSI dosyasını çalıştırarak kurulumunuzu kolayca güncelleyebilirsiniz; bu genellikle güncelleme sürecini sorunsuz bir şekilde yönetir.

• Tutarlılık:

  • MSI yükleyicisini kullanmak, gerekli tüm dosyaların farklı ortamlar arasında doğru ve tutarlı bir şekilde kurulmasını sağlar, bu da kaybolmuş veya hatalı DLL’lerin riskini azaltır.

MSI Yükleyicisini Kullanmanın Eksileri

• Sınırlı Esneklik:

  • MSI yükleyicisi, Documentize’i sistem genelinde bir konuma kurar, bu da tüm geliştirme ortamları için uygun olmayabilir. Proje özel yapılandırmaları veya sürümleri barındırma esnekliğinden yoksun olabilir.

• Potansiyel Üst Yük:

  • DLL’leri GAC’a yüklemek, özellikle birden fazla versiyonun aynı anda gerekebileceği senaryolarda üst yük ve karmaşıklık getirebilir.

• Manuel Kaldırma:

  • Documentize’i kaldırmanız gerektiğinde, MSI tarafından sağlanan kaldırıcıyı kullanmalısınız; bu, doğru yönetilmediği takdirde arta kalan dosyalar veya yapılandırmalar bırakabilir.

• Sürüm Çatışmaları:

  • Sistem genelindeki kurulumlar, farklı projelerin farklı sürümlerini gerektirmesi durumunda sürüm çatışmalarına yol açabilir. Bu çatışmalarla başa çıkmak ek yapılandırma veya temizlik gerektirebilir.

ZIP ile Documentize Kurulumu

ZIP Arşivi ile Nasıl Kurulur

1. ZIP Arşivini İndirin:

   • En son sürüm Documentize’i arşiv formatında indirmek için v24.12 ZIP bağlantısına tıklayın.

2. İçeriği Çıkarın:

   • İndirdikten sonra, ZIP dosyasının içeriğini seçtiğiniz bir dizine çıkarın. Bu dosyaları paylaşılan bir dizinde veya projeniz yapısında tutmayı seçebilirsiniz.

3. Projenize Referans Ekleyin:

   • Projenizi IDE’nizde (örn. Visual Studio) açın.
   • Proje > Referans Ekle > Gözat kısmına gidin ve DLL’leri çıkardığınız dizine gidin.
   • İlgili DLL dosyalarını seçin ve projenize referans olarak ekleyin.

4. Manuel Güncellemeler:

   • Documentize’in yeni bir sürümü yayınlandığında, güncellenmiş ZIP arşivini manuel olarak indirmeniz ve eski DLL dosyalarını projenizde yenileri ile değiştirmeniz gerekecektir.

ZIP Arşivini Kullanmanın Artıları

• Tam Kontrol:

  • DLL’lerin nerede ve nasıl saklandığı ve referans verildiği üzerinde tam kontrolünüz vardır. Bu, özel bir kurulum tercih ettiğinizde veya bağımlılıkları manuel olarak yönetmeniz gerektiğinde faydalı olabilir.

• Paket Yöneticilerine Bağımlılık Yok:

  • NuGet’in aksine, kurulumları yönetmek için bir paket yöneticisine güvenmiyorsunuz. Bu, paket yöneticilerinin mevcut olmadığı veya tercih edilmediği ortamlarda avantajlı olabilir.

• Taşınabilirlik:

  • ZIP arşivi kolayca paylaşılabilir ve farklı sistemler arasında taşınabilir, bu da onu dış araçlara güvenmeden taşınabilir veya dağıtılması gereken projeler için ideal hale getirir.

ZIP Arşivini Kullanmanın Eksileri

• Manuel Yönetim:

  • Güncellemelerin ve bağımlılık yönetiminin otomatikleştirildiği NuGet’in aksine, ZIP arşivinde güncellemeleri manuel olarak yönetmeli ve gereken tüm DLL’lerin doğru bir şekilde referans verildiğinden emin olmalısınız.

• Sürüm Çatışması Riski:

  • Birden fazla projeyi yönetiyorsanız veya bir ekipte çalışırken, farklı projelerin farklı DLL sürümlerini kullanması durumunda sürüm çatışması riski vardır. Bu, projeler arasında sürümleri dikkatlice takip etmeyi gerektirir.

• Otomatik Güncelleme Yok:

  • Yeni bir sürüm mevcut olduğunda otomatik güncellemeler veya bildirimler almazsınız. Bu, düzenli olarak güncellemeleri kontrol etmezseniz eski kütüphanelerin kullanılma riskiyle sonuçlanabilir.

Windows Dışı Ortam

Windows Dışı Ortamda .NET Core DLL’leriyle Çalışmak

Documentize for .NET, .NET Standard 2.0 (.NET Core 2.0) desteği sağladığı için, Linux benzeri işletim sistemlerinde çalışan Core Uygulamalarında kullanılabilir. API’mizde .NET Core desteğini geliştirmek için sürekli çalışıyoruz. Ancak, Documentize for .NET özelliklerini kullanırken daha iyi sonuçlar elde etmek için müşterilerimizin gerçekleştirmelerini önerdiğimiz bazı işlemler vardır. Lütfen şu paketleri yükleyin:

• libgdiplus paketi
• Microsoft uyumlu yazı tipleri içeren paket: ttf-mscorefonts-installer (örneğin, sudo apt-get install ttf-mscorefonts-installer). Bu yazı tipleri, Documentize for .NET’in Linux benzeri işletim sistemlerinde bu klasörü taradığı için /usr/share/fonts/truetype/msttcorefonts dizinine yerleştirilmelidir. İşletim sistemi, yazı tipleri için başka bir varsayılan klasör/dizine sahipse, Documentize kullanmadan önce herhangi bir işlem yapmadan önce aşağıdaki kod satırını kullanmalısınız:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<kullanıcının ms yazı tiplerine giden yolu>"));