Instalacja Documentize za pomocą NuGet

Jak zainstalować za pomocą konsoli menedżera pakietów NuGet

1. Otwórz swój projekt:

   • Uruchom Visual Studio i otwórz swoją aplikację .NET.

2. Dostęp do konsoli menedżera pakietów:

   • Przejdź do Narzędzia > Menedżer pakietów NuGet > Konsola menedżera pakietów.

3. Zainstaluj pakiet:

   • Aby zainstalować najnowszą pełną wersję, wprowadź polecenie Install-Package Documentize.
   • Aby zainstalować najnowszą wersję, w tym poprawki, użyj Install-Package Documentize -prerelease.
   • Naciśnij Enter, aby wykonać polecenie.

Jak zaktualizować pakiet za pomocą konsoli menedżera pakietów NuGet

Jeśli już zainstalowałeś Documentize za pomocą NuGet i chcesz zaktualizować do najnowszej wersji:

1. Otwórz swój projekt:

   • Uruchom Visual Studio i otwórz swoją aplikację .NET.

2. Dostęp do konsoli menedżera pakietów:

   • Przejdź do Narzędzia > Menedżer pakietów NuGet > Konsola menedżera pakietów.

3. Zaktualizuj pakiet:

   • Aby zaktualizować do najnowszej pełnej wersji, wprowadź Update-Package Documentize.
   • Aby zaktualizować do najnowszej wersji, w tym poprawki, użyj Update-Package Documentize -prerelease.
   • Naciśnij Enter, aby wykonać polecenie.

Jak zainstalować za pomocą graficznego interfejsu menedżera pakietów NuGet

1. Otwórz swój projekt:

   • Uruchom Visual Studio i otwórz swoją aplikację .NET.

2. Przejdź do zarządzania pakietami NuGet:

   • Z menu Projekt wybierz Zarządzaj pakietami NuGet.

3. Szukaj Documentize:

   • Przejdź do zakładki Przeglądaj i wpisz Documentize w polu wyszukiwania.

4. Zainstaluj pakiet:

   • Kliknij Zainstaluj/Aktualizuj obok najnowszej wersji Documentize.
   • Potwierdź, klikając Akceptuj w oknie pop-up.

Zalety korzystania z NuGet

• Automatyczne zarządzanie zależnościami:

  • NuGet automatycznie zajmuje się zależnościami, zapewniając, że wszystkie wymagane biblioteki są włączone i aktualizowane poprawnie. Redukuje to ryzyko pominięcia lub niekompatybilnych zależności.

• Uproszczone aktualizacje:

  • Aktualizacja pakietów jest prosta z NuGet, zarówno przez konsolę menedżera pakietów, jak i GUI. Ułatwia to utrzymanie bibliotek na bieżąco z najnowszymi funkcjami i poprawkami błędów.

• Zintegrowane z Visual Studio:

  • NuGet jest płynnie zintegrowany z Visual Studio, oferując przyjazny interfejs do zarządzania pakietami bez opuszczania środowiska programistycznego.

• Wersjonowanie:

  • NuGet pozwala na określenie i zarządzanie różnymi wersjami bibliotek, umożliwiając łatwe powracanie do wcześniejszych wersji lub testowanie nowych wydań bez zakłócania pracy.

Wady korzystania z NuGet

• Ograniczone do Visual Studio:

  • NuGet jest głównie zaprojektowany do użycia w Visual Studio. Chociaż można go używać w innych środowiskach, integracja jest najbardziej rozbudowana w Visual Studio.

• Potencjalne konflikty wersji:

  • W większych projektach z wieloma zależnościami zarządzanie wersjami i rozwiązywanie konfliktów może stać się skomplikowane. NuGet oferuje narzędzia do zarządzania tym, ale wymaga to starannej uwagi.

• Zależność od sieci:

  • Instalacja i aktualizacja pakietów wymaga połączenia z Internetem. Jeśli pracujesz w środowisku z ograniczonym lub brakiem dostępu do Internetu, możesz potrzebować użyć metod offline lub wstępnie pobrać pakiety.

• Złożoność dla dużych projektów:

  • W bardzo dużych projektach z rozbudowanymi drzewami zależności zarządzanie pakietami przez NuGet może stać się uciążliwe. W takich przypadkach mogą być potrzebne dodatkowe narzędzia lub strategie do skutecznego zarządzania zależnościami.

Instalacja Documentize za pomocą instalatora MSI

Jak zainstalować za pomocą instalatora MSI

1. Pobierz instalator MSI:

   • Kliknij v24.12 MSI, aby pobrać instalator MSI dla najnowszej wersji Documentize.

2. Uruchom instalator:

   • Kliknij dwukrotnie na pobrany plik MSI, aby uruchomić kreatora instalacji.

3. Postępuj zgodnie z kreatorem instalacji:

   • Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie przez instalatora. Może być konieczne zaakceptowanie umowy licencyjnej i wybranie opcji instalacji.

4. Zakończ instalację:

   • Po zakończeniu instalacji, DLL Documentize zostaną zainstalowane w globalnej pamięci podręcznej zestawów (GAC) systemu lub w innym wyznaczonym miejscu.

5. Zweryfikuj instalację:

   • Sprawdź, czy DLL są poprawnie zainstalowane, weryfikując ich obecność w wyznaczonej lokalizacji instalacji lub GAC.

Zalety korzystania z instalatora MSI

• Łatwość użycia:

  • Instalator MSI zapewnia prosty i kierowany proces instalacji. Obsługuje wszystkie niezbędne konfiguracje i umieszcza DLL w centralnej lokalizacji, co ułatwia korzystanie z Documentize w wielu projektach.

• Instalacja systemowa:

  • Metoda MSI instaluje Documentize w globalnej pamięci podręcznej zestawów (GAC) systemu lub w innym centralnym miejscu. Pozwala to na dostęp do DLL z dowolnej aplikacji w systemie bez potrzeby ich indywidualnego odniesienia w każdym projekcie.

• Automatyczne aktualizacje:

  • Jeśli Documentize udostępnia zaktualizowany instalator, możesz łatwo zaktualizować swoją instalację, uruchamiając nowy plik MSI, który zazwyczaj obsługuje proces aktualizacji bezproblemowo.

• Spójność:

  • Korzystanie z instalatora MSI zapewnia, że wszystkie wymagane pliki są instalowane poprawnie i spójnie w różnych środowiskach, co zmniejsza ryzyko brakujących lub źle umiejscowionych DLL.

Wady korzystania z instalatora MSI

• Ograniczona elastyczność:

  • Instalator MSI instaluje Documentize w lokalizacji systemowej, co może nie być odpowiednie dla wszystkich środowisk deweloperskich. Może brakować elastyczności w dostosowywaniu konfiguracji lub wersji specyficznych dla projektu.

• Potencjalne obciążenie:

  • Instalowanie DLL w GAC może wprowadzać obciążenie i złożoność, szczególnie w scenariuszach, gdzie jednocześnie może być potrzebnych wiele wersji Documentize.

• Ręczne usuwanie:

  • Jeśli musisz odinstalować Documentize, musisz użyć programu odinstalowującego dostarczonego przez MSI, co może pozostawić resztki plików lub konfiguracji, jeśli nie jest odpowiednio zarządzane.

• Konflikty wersji:

  • Instalacje systemowe mogą prowadzić do konfliktów wersji, jeśli różne projekty wymagają różnych wersji Documentize. Zarządzanie tymi konfliktami może wymagać dodatkowej konfiguracji lub sprzątania.

Instalacja Documentize za pomocą ZIP-a

Jak zainstalować za pomocą archiwum ZIP

1. Pobierz archiwum ZIP:

   • Kliknij v24.12 ZIP aby pobrać najnowszą wersję Documentize w formacie archiwum.

2. Wydobycie zawartości:

   • Po pobraniu, wydobądź zawartość pliku ZIP do wybranego katalogu. Możesz zdecydować się na przechowanie tych plików w katalogu współdzielonym lub w strukturze swojego projektu.

3. Dodaj odniesienia do swojego projektu:

   • Otwórz swój projekt w IDE (np. Visual Studio).
   • Przejdź do Projekt > Dodaj odniesienie > Przeglądaj i przejdź do katalogu, w którym wydobyłeś pliki DLL.
   • Wybierz odpowiednie pliki DLL i dodaj je jako odniesienia do swojego projektu.

4. Ręczne aktualizacje:

   • Jeśli zostanie wydana nowa wersja Documentize, będziesz musiał ręcznie pobrać zaktualizowane archiwum ZIP i zastąpić stare pliki DLL w swoim projekcie nowymi.

Zalety korzystania z archiwum ZIP

• Pełna kontrola:

  • Masz pełną kontrolę nad tym, gdzie i jak przechowywane i wskazywane są pliki DLL w Twoim projekcie. Może to być korzystne, jeśli preferujesz niestandardową konfigurację lub potrzebujesz ręcznie zarządzać zależnościami.

• Brak zależności od menedżerów pakietów:

  • W odróżnieniu od NuGet, nie polegasz na menedżerze pakietów do obsługi instalacji. Może to być korzystne w środowiskach, gdzie menedżery pakietów nie są dostępne lub preferowane.

• Przenośność:

  • Archiwum ZIP można łatwo udostępniać i przenosić na różnych systemach, co czyni je idealnym dla projektów, które muszą być przenośne lub rozprowadzane bez polegania na zewnętrznych narzędziach.

Wady korzystania z archiwum ZIP

• Ręczne zarządzanie:

  • W przeciwieństwie do NuGet, gdzie aktualizacje i zarządzanie zależnościami są zautomatyzowane, w przypadku archiwum ZIP musisz ręcznie zarządzać aktualizacjami i upewnić się, że wszystkie wymagane pliki DLL są poprawnie wskazane.

• Ryzyko konfliktów wersji:

  • Jeśli zarządzasz wieloma projektami lub pracujesz w zespole, istnieje ryzyko konfliktów wersji, jeśli różne projekty korzystają z różnych wersji plików DLL. To wymaga starannego śledzenia wersji w różnych projektach.

• Brak automatycznych aktualizacji:

  • Nie otrzymasz automatycznych aktualizacji ani powiadomień, gdy dostępna jest nowa wersja. Może to prowadzić do ryzyka korzystania z przestarzałych bibliotek, chyba że regularnie sprawdzasz aktualizacje.

Środowisko nie-Windows

Praca z DLL .NET Core w środowisku nie-Windows

Ponieważ Documentize dla .NET obsługuje .NET Standard 2.0 (.NET Core 2.0), może być używany w aplikacjach Core działających w systemach operacyjnych podobnych do Linuxa. Nieustannie pracujemy nad poprawą wsparcia dla .NET Core w naszym API. Istnieją jednak pewne operacje, które zalecamy naszym klientom wykonać, aby uzyskać lepsze wyniki podczas korzystania z funkcji Documentize dla .NET. Proszę zainstalować:

• pakiet libgdiplus
• Pakiet z czcionkami zgodnymi z Microsoft: ttf-mscorefonts-installer (np. sudo apt-get install ttf-mscorefonts-installer). Te czcionki powinny być umieszczone w katalogu /usr/share/fonts/truetype/msttcorefonts, ponieważ Documentize dla .NET skanuje ten folder w systemach operacyjnych podobnych do Linuxa. W przypadku, gdy system operacyjny ma inny domyślny folder/katalog dla czcionek, należy użyć następującej linii kodu przed wykonaniem jakiejkolwiek operacji z użyciem Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<ścieżka użytkownika do czcionek ms>"));