Installazione

Il SDK di Documentize può essere installato tramite più metodi, ciascuno adattato a diversi ambienti di sviluppo e preferenze. Di seguito sono riportati i modi consigliati per installare Documentize:

1. NuGet (Metodo Preferito)

NuGet è il metodo più semplice e preferito per installare Documentize, garantendo che tu abbia sempre l’ultima versione e aggiornamenti direttamente all’interno del tuo ambiente di sviluppo. Controlla ulteriori dettagli su questo metodo di installazione in Come installare gli SDK di Documentize utilizzando NuGet.

2. Installer MSI

L’installer MSI è un’opzione conveniente se preferisci avere le DLL di Documentize installate direttamente sul tuo sistema. Questo metodo è ideale per gli sviluppatori che potrebbero voler utilizzare Documentize su più progetti senza dover gestire manualmente i file DLL. Controlla ulteriori dettagli su questo metodo di installazione in Come installare gli SDK di Documentize utilizzando MSI.

3. Archivio ZIP

Per gli sviluppatori che preferiscono un approccio manuale, l’archivio ZIP contiene le DLL di Documentize, che possono essere estratte e aggiunte direttamente al tuo progetto. Controlla ulteriori dettagli su questo metodo di installazione in Come installare gli SDK di Documentize utilizzando ZIP.

Requisiti di Sistema

Gli SDK di Documentize sono progettati per integrarsi con applicazioni .NET e supportano vari sistemi operativi e ambienti di sviluppo. Di seguito sono riportati i requisiti di sistema chiave:

Sistemi Operativi Supportati

Windows

Windows 7 (x64, x86)
Windows 8, 8.1 (x64, x86)
Windows 10 (x64, x86)
Windows 11 (x64, x86)
Windows Server 2003 a Windows Server 2022 (x64, x86)
Cloud: Microsoft Azure

macOS

macOS 10.12 (Sierra) e versioni successive

Linux

Compatibile con più distribuzioni Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)

Android

Supporta Android 8.0 (Oreo) e versioni successive.

Ambienti di Sviluppo

Microsoft Visual Studio:
- Visual Studio 2010 e versioni successive (incluso 2019 e 2022)
Supporta qualsiasi ambiente di sviluppo che punta alle piattaforme .NET.

Framework .NET Supportati

.NET Framework 4.0 e superiori
.NET Standard 2.0 (.NET Core 3.1+)
.NET 6.0, .NET 7.0, .NET 8.0

Note Aggiuntive

Adobe Acrobat non è necessario per eseguire gli SDK di Documentize, ma è consigliato per visualizzare PDF.

Dichiarazione

Gli SDK di Documentize.com richiedono un set di autorizzazioni Full Trust quando vengono utilizzati all’interno delle applicazioni .NET. Questo livello di autorizzazione è essenziale per consentire agli SDK di eseguire alcune operazioni a livello di sistema, come l’accesso alle impostazioni del registro, ai file di sistema e l’analisi dei caratteri.

Perché è necessaria la Full Trust

Gli SDK di Documentize utilizzano classi di sistema .NET fondamentali, che spesso richiedono autorizzazioni elevate per i seguenti motivi:

Accesso al Registro: Alcune operazioni potrebbero richiedere la lettura o la scrittura nel registro di sistema.
File di Sistema: L’accesso a file di sistema oltre la directory virtuale dell’applicazione potrebbe essere necessario per alcune operazioni, come la gestione dei caratteri o l’esecuzione di operazioni file.

Limitazioni dell’Ambiente a Fiducia Media

Negli ambienti di hosting che impongono la sicurezza Medium Trust, diverse autorizzazioni importanti sono limitate o non disponibili. Questo potrebbe impedire il corretto funzionamento degli SDK in tali ambienti. Le seguenti restrizioni si applicano sotto Medium Trust:

OleDbPermission: Impossibile utilizzare il provider dati OLE DB gestito ADO.NET per accedere ai database.
EventLogPermission: L’accesso al Registro eventi di Windows è vietato.
ReflectionPermission: Impedisce l’uso della riflessione, il che potrebbe influenzare alcune operazioni dinamiche.
RegistryPermission: L’accesso al registro di sistema è negato.
WebPermission: La comunicazione è limitata a indirizzi o intervalli predefiniti come configurato nell’elemento <trust>.
FileIOPermission: L’accesso ai file è limitato a quelli all’interno della directory virtuale dell’applicazione.

Ambiente Non-Windows

Documentize SDK supporta .NET Standard 2.0, che consente di utilizzarli in applicazioni .NET Core che girano su Linux o altri ambienti non-Windows. Per garantire prestazioni ottimali e un corretto rendering del testo, segui i passi qui sotto:

Configurazione Raccomandata per Linux

1. Installa il pacchetto libgdiplus

Questo pacchetto fornisce le necessarie funzionalità GDI+, che sono fondamentali per il rendering e l’elaborazione dei PDF. Puoi installarlo eseguendo il seguente comando nel tuo terminale:

sudo apt-get install libgdiplus

2. Installa i Font Compatibili con Microsoft

Per un corretto rendering del testo, installa i font TrueType di Microsoft utilizzando il comando:

sudo apt-get install ttf-mscorefonts-installer

Questi font dovrebbero essere collocati nella directory /usr/share/fonts/truetype/msttcorefonts. Se il tuo sistema memorizza i font in una directory diversa, aggiorna il percorso nel tuo codice prima di eseguire qualsiasi operazione con gli SDK di Documentize:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<percorso ai font microsoft>"));

Suggerimento

Assicurandoti che queste installazioni siano complete e configurando correttamente il percorso dei font, puoi massimizzare le prestazioni degli SDK di Documentize su Linux o altri sistemi non-Windows.

Valutazione

Puoi facilmente scaricare gli SDK di Documentize per scopi di valutazione. La versione di valutazione è identica alla versione acquistata, con l’unica differenza nel modo in cui applichi la licenza.

Limitazioni della Versione di Valutazione

Sebbene la versione di valutazione fornisca accesso completo a tutte le funzionalità, include le seguenti limitazioni fino all’applicazione di una licenza:

Un watermark di valutazione è inserito in tutti i documenti di output.
Possono essere visualizzate o modificate solo le prime quattro pagine di qualsiasi documento PDF.

Per rimuovere queste limitazioni e sbloccare la versione completa, è sufficiente applicare una licenza aggiungendo alcune righe di codice al tuo progetto.