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>"));

v24.12

Dodano nowy wtyczkę: Konwerter PDF na PNG

• Klasa PngConverter: Reprezentuje wtyczkę Documentize.PngConverter. Używana do konwersji dokumentów PDF na format PNG.
• Klasa PdfToPngOptions: Reprezentuje opcje konwertera PDF na PNG dla wtyczki Documentize.PngConverter.

Przykład użycia:

// utworzyć PngConverter
var plugin = new PngConverter();
// utworzyć obiekt PdfToPngOptions, aby ustawić instrukcje
var opt = new PdfToPngOptions();
// dodać ścieżkę do pliku wejściowego
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ustawić ścieżkę do pliku wyjściowego
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// wykonać proces
plugin.Process(opt);

Dodano nowy wtyczkę: Konwerter PDF na TIFF

• Klasa TiffConverter: Reprezentuje wtyczkę Documentize.TiffConverter. Używana do konwersji dokumentów PDF na format TIFF.
• Klasa PdfToTiffOptions: Reprezentuje opcje konwertera PDF na TIFF dla wtyczki Documentize.TiffConverter.

Przykład użycia:

// utworzyć TiffConverter
var plugin = new TiffConverter();
// utworzyć obiekt PdfToTiffOptions, aby ustawić instrukcje
var opt = new PdfToTiffOptions();
// dodać ścieżkę do pliku wejściowego
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ustawić ścieżkę do pliku wyjściowego
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// wykonać proces
plugin.Process(opt);

Dodano nowy wtyczkę: Generator tabel PDF

• Klasa TableGenerator: Reprezentuje wtyczkę Documentize.TableGenerator. Używana do dodawania tabeli do dokumentu PDF.
• Klasa TableBuilder: Klasa reprezentuje budowniczego dla tabeli na stronie PDF.
• Klasa TableRowBuilder: Klasa reprezentuje budowniczego dla wiersza tabeli.
• Klasa TableCellBuilder: Klasa reprezentuje budowniczego dla komórki tabeli.

Przykład użycia:

// utworzyć TableGenerator
var plugin = new TableGenerator();
// utworzyć obiekt TableOptions, aby ustawić instrukcje
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Imię")
            .AddCell().AddParagraph("Wiek")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// dodać ścieżkę do pliku wejściowego
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ustawić ścieżkę do pliku wyjściowego
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// wykonać proces
plugin.Process(opt);

Zmieniono nazwę klasy PdfDoc na DocConverter

• Klasa DocConverter: Reprezentuje wtyczkę Documentize.DocConverter. Używana do konwersji dokumentów PDF na format DOC/DOCX.

Przykład użycia:

// utworzyć DocConverter
var plugin = new DocConverter();
// utworzyć obiekt PdfToDocOptions, aby ustawić instrukcje
var opt = new PdfToDocOptions();
// dodać ścieżkę do pliku wejściowego
opt.AddInput(new FileDataSource(inputPath));
// ustawić ścieżkę do pliku wyjściowego
opt.AddOutput(new FileDataSource(outputPath));
// wykonać proces
plugin.Process(opt);

v24.11

Dodano nowy wtyczkę: Konwerter PDF na JPEG

• Cel: Klasa JpegConverter została zaprojektowana do konwertowania dokumentów PDF na format JPEG, co ułatwia użytkownikom obsługę i udostępnianie obrazów pochodzących z PDF-ów.
• Konstruktor:
  • JpegConverter(): Inicjalizuje nową instancję konwertera JPEG.

Przykład użycia:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);

• Metoda:
  • Process(PdfToJpegOptions options): Rozpoczyna proces konwersji JPEG z wykorzystaniem określonych opcji.

Dodano klasę DirectoryDataSource

• Cel: Klasa DirectoryDataSource pozwala użytkownikom zarządzać danymi katalogu do operacji ładowania i zapisywania w ramach wtyczek.
• Konstruktor:
  • DirectoryDataSource(string path): Inicjalizuje nowy obiekt danych katalogu z określoną ścieżką.

Przykład użycia:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Właściwości:
  • DataType: Pobiera typ źródła danych.
  • Path: Pobiera ścieżkę bieżącego katalogu danych.

Dodano klasę PdfToJpegOptions

• Cel: Klasa ta zawiera opcje konfigurowania procesu konwersji JPEG, pozwalając użytkownikom na określenie rozdzielczości, listy stron oraz jakości obrazu.
• Konstruktor:
  • PdfToJpegOptions(): Inicjalizuje nową instancję opcji dla konwertera JPEG.

Właściwości:

• OutputResolution: Określa rozdzielczość wynikowych obrazów JPEG.
• PageList: Lista stron do konwersji z PDF-a.
• Quality: Ustala jakość wyjściowego obrazu JPEG.

v24.10

Dodano nowy wtyczkę: PDF/A Converter

• Wprowadzono nową funkcję konwersji PDF/A, która umożliwia użytkownikom łatwe przekształcanie standardowych plików PDF na dokumenty zgodne z PDF/A.

Przykład użycia:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Poprawki błędów

• Naprawiono problemy związane z klasą FileResult, które skutkowały błędnymi ścieżkami wyjściowymi.
• Rozwiązano drobne błędy wpływające na HtmlConverter podczas obsługi dużych plików.

Ulepszenia

• Zwiększona wydajność PdfExtractor i ImageExtractor w celu szybszego czasu przetwarzania.
• Zaktualizowano klasę RotateOptions, aby obsługiwała dodatkowe kąty rotacji.

v24.9

Wydano