Instalace Documentize přes NuGet

Jak nainstalovat přes konzoli správce balíčků NuGet

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Získejte přístup k konzoli správce balíčků:

   • Přejděte na Nástroje > Správce balíčků NuGet > Konzole správce balíčků.

3. Nainstalujte balík:

   • Pro instalaci nejnovější plné verze zadejte příkaz Install-Package Documentize.
   • Pro instalaci nejnovější verze včetně oprav chyb použijte Install-Package Documentize -prerelease.
   • Stiskněte Enter pro provedení příkazu.

Jak aktualizovat balík přes konzoli správce balíčků NuGet

Pokud jste již nainstalovali Documentize přes NuGet a chcete aktualizovat na nejnovější verzi:

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Získejte přístup k konzoli správce balíčků:

   • Přejděte na Nástroje > Správce balíčků NuGet > Konzole správce balíčků.

3. Aktualizujte balík:

   • Pro aktualizaci na nejnovější plnou verzi zadejte Update-Package Documentize.
   • Pro aktualizaci na nejnovější verzi včetně oprav chyb použijte Update-Package Documentize -prerelease.
   • Stiskněte Enter pro provedení příkazu.

Jak nainstalovat přes grafické rozhraní správce balíčků NuGet

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Přejděte na správu balíčků NuGet:

   • Z nabídky Projekt vyberte Spravovat balíčky NuGet.

3. Hledejte Documentize:

   • Přejděte na kartu Procházet a zadejte Documentize do vyhledávacího pole.

4. Nainstalujte balík:

   • Klikněte na Nainstalovat/Aktualizovat vedle nejnovější verze Documentize.
   • Potvrďte kliknutím na Přijmout v pop-up okně.

Výhody používání NuGet

• Automatická správa závislostí:

  • NuGet automaticky zpracovává závislosti, zajišťuje, že všechny potřebné knihovny jsou zahrnuty a správně aktualizovány. To snižuje riziko chybějících nebo nekompatibilních závislostí.

• Zjednodušené aktualizace:

  • Aktualizace balíků je s NuGet jednoduchá, buď přes konzoli správce balíčků, nebo grafické rozhraní. To usnadňuje udržování vašich knihoven aktuálních s nejnovějšími funkcemi a opravami chyb.

• Integrace s Visual Studio:

  • NuGet je bezproblémově integrován s Visual Studio, což poskytuje uživatelsky přívětivé rozhraní pro správu balíčků bez opuštění vývojového prostředí.

• Verzování:

  • NuGet vám umožňuje specifikovat a spravovat různé verze knihoven, což vám umožňuje snadno se vrátit k předchozím verzím nebo testovat nové verze bez narušení vašeho vývoje.

Nevýhody používání NuGet

• Omezeno na Visual Studio:

  • NuGet je primárně navržen pro použití v rámci Visual Studio. Ačkoliv může být použit v jiných prostředích, integrace je nejrobustnější ve Visual Studio.

• Potenciál pro konflikty verzí:

  • Větší projekty s mnoha závislostmi mohou mít problémy s řízením verzí a řešením konfliktů. NuGet poskytuje nástroje pro správu tohoto, ale vyžaduje pečlivou pozornost.

• Závislost na síti:

  • Instalace a aktualizace balíků vyžaduje internetové připojení. Pokud pracujete v prostředí s omezeným nebo žádným přístupem k internetu, může být nutné použít offline metody nebo předem stáhnout balíky.

• Složitost pro velké projekty:

  • Pro velmi velké projekty s rozsáhlými stromy závislostí může být správa balíků prostřednictvím NuGet obtížná. V takových případech může být potřeba dalších nástrojů nebo strategií pro účinnou správu závislostí.

Instalace Documentize pomocí MSI

Jak nainstalovat pomocí MSI instalátoru

1. Stáhněte MSI instalátor:

   • Klikněte na v24.12 MSI pro stažení MSI instalátoru pro poslední verzi Documentize.

2. Spusťte instalátor:

   • Dvakrát klikněte na stažený MSI soubor pro spuštění instalačního průvodce.

3. Postupujte podle instalačního průvodce:

   • Postupujte podle pokynů na obrazovce, které poskytuje instalátor. Můžete být požádáni, abyste souhlasili s licenční smlouvou a vybrali možnosti instalace.

4. Dokončete instalaci:

   • Jakmile je instalace dokončena, DLL knihovny Documentize budou nainstalovány do globálního vyrovnávacího prostoru Assembly Cache (GAC) nebo do jiného určeného umístění.

5. Ověřte instalaci:

   • Zkontrolujte, že jsou DLL knihovny správně nainstalovány ověřením jejich přítomnosti ve vyhrazeném instalačním adresáři nebo GAC.

Výhody použití MSI instalátoru

• Jednoduchost použití:

  • MSI instalátor poskytuje jednoduchý a vedený proces instalace. Zvládá všechny potřebné konfigurace a umisťuje DLL knihovny na centrální místo, což usnadňuje použití Documentize napříč více projekty.

• Instalace systémově:

  • MSI metoda instaluje Documentize do globálního vyrovnávacího prostoru Assembly Cache (GAC) nebo na jiné centrální místo. To umožňuje jakékoli aplikaci v systému přistupovat k DLL knihovnám, aniž by je bylo potřeba jednotlivě specifikovat v každém projektu.

• Automatizované aktualizace:

  • Pokud Documentize poskytuje aktualizovaný instalátor, můžete snadno aktualizovat svou instalaci spuštěním nového MSI souboru, což obvykle zajišťuje plynulý proces aktualizace.

• Konzistence:

  • Použití MSI instalátoru zajišťuje, že všechny potřebné soubory jsou nainstalovány správně a konzistentně napříč různými prostředími, čímž se snižuje riziko chybějících nebo nesprávně umístěných DLL knihoven.

Nevýhody použití MSI instalátoru

• Omezená flexibilita:

  • MSI instalátor instaluje Documentize na systémově centrální místo, což nemusí být vhodné pro všechny vývojové prostředí. Může postrádat flexibilitu pro přizpůsobení specifickým konfiguracím nebo verzím projektu.

• Potenciální režie:

  • Instalace DLL knihoven do GAC může zavést režii a složitost, zejména v scénářích, kdy může být potřeba mít současně více verzí Documentize.

• Manuální odstranění:

  • Pokud potřebujete odinstalovat Documentize, musíte použít odinstalátor poskytovaný MSI, což může zanechat zbylé soubory nebo konfigurace, pokud není správně spravováno.

• Konflikty verzí:

  • Systémové instalace mohou vést ke konfliktům verzí, pokud různé projekty vyžadují různé verze Documentize. Správa těchto konfliktů může vyžadovat dodatečné konfigurace nebo úklid.

Instalace Documentize pomocí ZIP

Jak nainstalovat pomocí ZIP archivu

1. Stáhněte ZIP archiv:

   • Klikněte na v24.12 ZIP pro stažení nejnovější verze Documentize ve formátu archivu.

2. Extrahujte obsah:

   • Po stažení extrahujte obsah ZIP souboru do vybraného adresáře. Můžete si vybrat, zda tyto soubory uchováte ve sdíleném adresáři, nebo v rámci struktury vašeho projektu.

3. Přidejte odkazy do vašeho projektu:

   • Otevřete svůj projekt ve svém IDE (např. Visual Studio).
   • Přejděte na Projekt > Přidat odkaz > Procházet a přejděte do adresáře, kde jste extrahovali DLL soubory.
   • Vyberte relevantní DLL soubory a přidejte je jako odkazy do vašeho projektu.

4. Manuální aktualizace:

   • Pokud bude vydána nová verze Documentize, budete muset manuálně stáhnout aktualizovaný ZIP archiv a nahradit staré DLL soubory ve vašem projektu novými.

Výhody používání ZIP archivu

• Úplná kontrola:

  • Máte plnou kontrolu nad tím, kde a jak jsou DLL soubory uloženy a odkazovány ve vašem projektu. To může být výhodné, pokud preferujete vlastní nastavení nebo potřebujete spravovat závislosti manuálně.

• Žádná závislost na správcích balíčků:

  • Na rozdíl od NuGet se nespolehnete na správce balíčků pro provádění instalací. To může být výhodné v prostředích, kde správci balíčků nejsou k dispozici nebo preferováni.

• Přenositelnost:

  • ZIP archiv lze snadno sdílet a přesouvat mezi různými systémy, což ho činí ideálním pro projekty, které potřebují být přenosné nebo distribuovány bez spolehnutí na externí nástroje.

Nevýhody používání ZIP archivu

• Manuální správa:

  • Na rozdíl od NuGet, kde jsou aktualizace a správa závislostí automatizovány, s ZIP archivem musíte manuálně spravovat aktualizace a zajistit, že všechny potřebné DLL soubory jsou správně odkazovány.

• Riziko konfliktů verzí:

  • Pokud spravujete více projektů nebo pracujete v týmu, existuje riziko konfliktů verzí, pokud různé projekty používají různé verze DLL souborů. To vyžaduje pečlivé sledování verzí napříč projekty.

• Žádné automatické aktualizace:

  • Nebudete dostávat automatické aktualizace nebo oznámení, když bude k dispozici nová verze. To může vést k riziku používání zastaralých knihoven, pokud pravidelně nekontrolujete aktualizace.

Nenárodní prostředí

Práce s .NET Core DLL v nenárodním prostředí

Jelikož Documentize pro .NET poskytuje podporu pro .NET Standard 2.0 (.NET Core 2.0), může být použit v Core aplikacích běžících v operačních systémech podobných Linuxu. Neustále pracujeme na zlepšení podpory .NET Core v našem API. Existují však některé operace, které doporučujeme našim zákazníkům provádět, aby dosáhli lepších výsledků při používání funkcí Documentize pro .NET. Nainstalujte prosím:

• balíček libgdiplus
• Balíček s písmem kompatibilním s Microsoftem: ttf-mscorefonts-installer (např. sudo apt-get install ttf-mscorefonts-installer). Tato písma by měla být umístěna v adresáři /usr/share/fonts/truetype/msttcorefonts, protože Documentize pro .NET skenuje tuto složku v operačních systémech podobných Linuxu. V případě, že má operační systém jinou výchozí složku/adresář pro písma, měli byste použít následující řádek kódu před provedením jakékoli operace pomocí Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<cesta uživatele k ms písmům>"));