Installare Documentize tramite NuGet

Come Installare tramite la Console del Gestore Pacchetti NuGet

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Accedi alla Console del Gestore Pacchetti:

   • Vai su Strumenti > Gestore pacchetti NuGet > Console del gestore pacchetti.

3. Installa il pacchetto:

   • Per installare l’ultima versione completa, inserisci il comando Install-Package Documentize.
   • Per installare l’ultima versione inclusa le correzioni, usa Install-Package Documentize -prerelease.
   • Premi Invio per eseguire il comando.

Come Aggiornare il Pacchetto tramite la Console del Gestore Pacchetti NuGet

Se hai già installato Documentize tramite NuGet e desideri aggiornare all’ultima versione:

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Accedi alla Console del Gestore Pacchetti:

   • Vai su Strumenti > Gestore pacchetti NuGet > Console del gestore pacchetti.

3. Aggiorna il pacchetto:

   • Per aggiornare all’ultima versione completa, inserisci Update-Package Documentize.
   • Per aggiornare all’ultima versione inclusa le correzioni, usa Update-Package Documentize -prerelease.
   • Premi Invio per eseguire il comando.

Come Installare tramite l’Interfaccia Grafica del Gestore Pacchetti NuGet

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Naviga per Gestire i Pacchetti NuGet:

   • Dal menu Progetto, seleziona Gestisci pacchetti NuGet.

3. Cerca Documentize:

   • Vai alla scheda Sfoglia e inserisci Documentize nella casella di ricerca.

4. Installa il pacchetto:

   • Clicca su Installa/Aggiorna accanto all’ultima versione di Documentize.
   • Conferma cliccando su Accetta nella finestra pop-up.

Vantaggi dell’Utilizzo di NuGet

• Gestione Automatica delle Dipendenze:

  • NuGet gestisce automaticamente le dipendenze, assicurando che tutte le librerie necessarie siano incluse e aggiornate correttamente. Questo riduce il rischio di dipendenze mancanti o incompatibili.

• Aggiornamenti Semplificati:

  • Aggiornare i pacchetti è semplice con NuGet, sia attraverso la Console del Gestore Pacchetti che l’interfaccia grafica. Questo rende facile mantenere le librerie aggiornate con le ultime funzionalità e correzioni di bug.

• Integrato con Visual Studio:

  • NuGet è perfettamente integrato con Visual Studio, fornendo un’interfaccia utente facile da usare per gestire i pacchetti senza lasciare l’ambiente di sviluppo.

• Versionamento:

  • NuGet consente di specificare e gestire diverse versioni delle librerie, permettendo di ripristinare facilmente versioni precedenti o testare nuove versioni senza interrompere lo sviluppo.

Svantaggi dell’Utilizzo di NuGet

• Limitato a Visual Studio:

  • NuGet è progettato principalmente per essere utilizzato all’interno di Visual Studio. Sebbene possa essere utilizzato in altri ambienti, l’integrazione è più robusta in Visual Studio.

• Potenziale per Conflitti di Versione:

  • In progetti più grandi con molte dipendenze, gestire le versioni e risolvere i conflitti può diventare complesso. NuGet fornisce strumenti per gestire questo, ma richiede attenzione.

• Dipendenza dalla Rete:

  • L’installazione e l’aggiornamento dei pacchetti richiedono una connessione a Internet. Se lavori in un ambiente con accesso a Internet limitato o assente, potresti dover utilizzare metodi offline o pre-scaricare i pacchetti.

• Complessità per Grandi Progetti:

  • Per progetti molto grandi con alberi di dipendenze estesi, la gestione dei pacchetti tramite NuGet può diventare gravosa. In tali casi, potrebbero essere necessari strumenti o strategie aggiuntive per gestire efficacemente le dipendenze.

Installare Documentize tramite MSI

Come installare tramite l’installer MSI

1. Scarica l’installer MSI:

   • Clicca sul v24.12 MSI per scaricare l’installer MSI per l’ultima versione di Documentize.

2. Esegui l’installer:

   • Fai doppio clic sul file MSI scaricato per avviare la procedura guidata di installazione.

3. Segui la procedura guidata di installazione:

   • Segui le istruzioni visualizzate dall’installer. Potrebbe essere necessario accettare il contratto di licenza e selezionare le opzioni di installazione.

4. Completa l’installazione:

   • Una volta completata l’installazione, le DLL di Documentize verranno installate nella Global Assembly Cache (GAC) del tuo sistema o in un’altra posizione specificata.

5. Verifica l’installazione:

   • Controlla che le DLL siano installate correttamente verificando la loro presenza nella directory di installazione designata o nella GAC.

Vantaggi dell’uso dell’installer MSI

• Facilità d’uso:

  • L’installer MSI fornisce un processo di installazione semplice e guidato. Gestisce tutte le configurazioni necessarie e colloca le DLL in una posizione centrale, facilitando l’uso di Documentize in più progetti.

• Installazione a livello di sistema:

  • Il metodo MSI installa Documentize nella Global Assembly Cache (GAC) del sistema o in un’altra posizione centrale. Questo consente a qualsiasi applicazione nel sistema di accedere alle DLL senza doverle riferire individualmente in ciascun progetto.

• Aggiornamenti automatizzati:

  • Se Documentize fornisce un installer aggiornato, puoi facilmente aggiornare la tua installazione eseguendo il nuovo file MSI, che solitamente gestisce il processo di aggiornamento senza problemi.

• Coerenza:

  • Utilizzare l’installer MSI assicura che tutti i file necessari siano installati correttamente e in modo coerente in diversi ambienti, riducendo il rischio di DLL mancanti o dislocate.

Svantaggi dell’uso dell’installer MSI

• Flessibilità limitata:

  • L’installer MSI installa Documentize in una posizione a livello di sistema, che potrebbe non essere adatta per tutti gli ambienti di sviluppo. Potrebbe mancare della flessibilità necessaria per adattarsi a configurazioni o versioni specifiche del progetto.

• Sovraccarico potenziale:

  • Installare DLL nella GAC può introdurre sovraccarico e complessità, in particolare in scenari in cui potrebbero essere necessarie più versioni di Documentize contemporaneamente.

• Rimozione manuale:

  • Se è necessario disinstallare Documentize, devi utilizzare il disinstaller fornito dall’MSI, che può lasciare file residui o configurazioni dietro se non gestito correttamente.

• Conflitti di versione:

  • Le installazioni a livello di sistema possono portare a conflitti di versione se diversi progetti richiedono versioni diverse di Documentize. La gestione di questi conflitti potrebbe richiedere configurazioni o pulizie aggiuntive.

Ambiente Non-Windows

Lavorare con DLL .NET Core in un Ambiente Non-Windows

Poiché Documentize per .NET offre supporto per .NET Standard 2.0 (.NET Core 2.0), può essere utilizzato nelle Applicazioni Core che girano su sistemi operativi simili a Linux. Stiamo costantemente lavorando per migliorare il supporto per .NET Core nella nostra API. Tuttavia, ci sono alcune operazioni che raccomandiamo ai nostri clienti di eseguire per ottenere risultati migliori durante l’utilizzo delle funzionalità di Documentize per .NET. Si prega di installare:

• pacchetto libgdiplus
• Pacchetto con font compatibili con Microsoft: ttf-mscorefonts-installer (ad esempio, sudo apt-get install ttf-mscorefonts-installer). Questi font dovrebbero essere posizionati nella directory /usr/share/fonts/truetype/msttcorefonts poiché Documentize per .NET scansiona questa cartella sui sistemi operativi simili a Linux. Nel caso in cui il sistema operativo abbia un’altra cartella/directory predefinita per i font, è necessario utilizzare la seguente riga di codice prima di eseguire qualsiasi operazione utilizzando Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<percorso dell'utente ai font ms>"));