Installazione

Documentize SDK può essere installato attraverso vari metodi, ciascuno adattato a diversi ambienti di sviluppo e preferenze. Di seguito sono riportati i metodi raccomandati 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 gli aggiornamenti direttamente all’interno del tuo ambiente di sviluppo. Controlla ulteriori dettagli su questo metodo di installazione in Come installare i SDK di Documentize utilizzando NuGet.

2. Installer MSI

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

3. Archivio ZIP

Per gli sviluppatori che preferiscono un approccio manuale, l’archivio ZIP contiene i DLL di Documentize, che possono essere estratti e aggiunti direttamente al tuo progetto. Controlla ulteriori dettagli su questo metodo di installazione in Come installare i 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 (inclusi 2019 e 2022)
Supporta qualsiasi ambiente di sviluppo mirato 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 è richiesto per eseguire gli SDK di Documentize, ma è raccomandato per visualizzare i PDF.

Dichiarazione

Le SDK di Documentize.com richiedono un insieme di permessi di Full Trust quando utilizzate all’interno di applicazioni .NET. Questo livello di permesso è essenziale per le SDK per eseguire alcune operazioni a livello di sistema, come accedere alle impostazioni del registro, ai file di sistema e all’analisi dei font.

Perché è Richiesto il Full Trust

Le SDK di Documentize utilizzano classi di sistema .NET fondamentali, che spesso necessitano di permessi elevati per le seguenti ragioni:

Accesso al Registro: Alcune operazioni possono richiedere di leggere o scrivere nel registro di sistema.
File di Sistema: L’accesso ai file di sistema al di fuori della directory virtuale dell’applicazione può essere necessario per alcuni compiti, come gestire i font o eseguire operazioni sui file.

Limitazioni dell’Ambiente Medium Trust

Negli ambienti di hosting che applicano la sicurezza di Medium Trust, diversi permessi importanti sono limitati o non disponibili. Questo potrebbe impedire alle SDK di funzionare correttamente in tali ambienti. Le seguenti restrizioni si applicano sotto Medium Trust:

OleDbPermission: Impossibile utilizzare il provider di dati ADO.NET gestito OLE DB per accedere ai database.
EventLogPermission: L’accesso al registro eventi di Windows è vietato.
ReflectionPermission: Previene l’uso della riflessione, che può 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

I SDK di Documentize supportano .NET Standard 2.0, che consente di essere utilizzati in applicazioni .NET Core che girano su Linux o altri ambienti non-Windows. Per garantire prestazioni ottimali e una corretta resa del testo, segui i passaggi sottostanti:

Configurazione Raccomandata per Linux

1. Installare il Pacchetto libgdiplus

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

sudo apt-get install libgdiplus

2. Installare i Caratteri Compatibili con Microsoft

Per una corretta resa del testo, installa i caratteri TrueType di Microsoft utilizzando il comando:

sudo apt-get install ttf-mscorefonts-installer

Questi caratteri dovrebbero essere collocati nella directory /usr/share/fonts/truetype/msttcorefonts. Se il tuo sistema memorizza i caratteri 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("<path to ms fonts>"));

Suggerimento

Assicurandoti che queste installazioni siano complete e configurando correttamente il percorso dei caratteri, 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

Mentre la versione di valutazione fornisce accesso completo a tutte le funzionalità, include le seguenti limitazioni fino a quando non viene applicata una licenza:

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

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