Installazione
Aggiungi Doconut al tuo progetto .NET 8
Il visualizzatore base Doconut per .NET 8 è fornito come un unico pacchetto NuGet che si integra in qualsiasi applicazione ASP.NET Core. I plugin opzionali usano pacchetti separati. Questa pagina installa il pacchetto base e registra il middleware — il minimo necessario prima del tuo primo rendering.
Requisiti
Il pacchetto funziona su queste piattaforme:
| Piattaforma | Supportato |
|---|---|
| Windows x64 / x86 | Sì |
Linux x64, basato su glibc (Debian, Ubuntu, l'immagine ufficiale mcr.microsoft.com/dotnet/aspnet:8.0) | Sì |
| Alpine e altre distribuzioni basate su musl | No |
| macOS | No |
Su Linux, installa la libreria di configurazione dei font prima che il primo documento si apra:
apt-get update && apt-get install -y libfontconfig1Su RHEL, Fedora e distribuzioni simili il pacchetto è fontconfig (dnf install -y fontconfig). È l'unico pacchetto di sistema di cui Doconut ha bisogno: le librerie native che utilizza sono incluse nel pacchetto NuGet, e libgdiplus non è necessario. Le pagine sono renderizzate con i font installati sul server, quindi consulta Risoluzione dei problemi per i font e i messaggi di errore di Linux.
Installa il pacchetto
dotnet add package Doconut.NET8Il comando senza versione installa l'ultima versione stabile. Per fissare la versione descritta in questa documentazione, passa la versione come opzione separata:
dotnet add package Doconut.NET8 --version 26.10.0Doconut.NET8 è l'ID del pacchetto. Il suffisso di versione appartiene al nome file Doconut.NET8.<version>.nupkg scaricato e non fa parte dell'ID.
Registra Doconut
AddDoconut() è l'unico punto di ingresso per la registrazione — c'è un unico overload, e collega il servizio Viewer, il servizio licenza e l'infrastruttura di rendering al contenitore DI.
Due chiamate middleware completano la configurazione, e il loro ordine è importante: UseDoconutResources() deve essere eseguito prima di UseDoconut(). UseDoconut() è un middleware terminale, quindi chiamarlo per primo significa che ogni richiesta a una risorsa /doconut-res non raggiunge mai il gestore delle risorse e restituisce 404. UseDoconut() risponde a ogni richiesta che lo raggiunge, quindi montalo su un ramo separato con app.Map. Il collegamento della sessione è richiesto anche — la sicurezza dei documenti predefinita di Doconut valida ogni richiesta di pagina rispetto allo stato della sessione ASP.NET.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // lo stato della sessione richiede una cache (MVC/Razor Pages ne aggiungono già una)
builder.Services.AddSession(); // La sicurezza dei documenti Doconut si basa sullo stato della sessione ASP.NET
app.UseSession(); // chiamare UseSession() prima di UseDoconut()
app.UseDoconutResources(); // deve essere registrato prima di UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());Tutte le opzioni
DoconutOptions accetta le seguenti proprietà configurabili. Ognuna è opzionale — i valori predefiniti sotto si applicano quando una proprietà è lasciata non impostata.
| Proprietà | Predefinito | Descrizione |
|---|---|---|
ShowDoconutInfo | false | Quando true, una richiesta senza token restituisce un banner di versione invece di un 404. Utile come verifica rapida; disabilitarlo in produzione. |
UnsafeMode | false | Quando true, salta il controllo di sicurezza della sessione ASP.NET sulle richieste di pagina. Disabilitarlo in produzione. |
MiddlewarePath | "/doconut" | Valore di coordinamento per l'endpoint page-image. È validato, ma non monta un ramo da solo; mantienilo allineato con la mappatura reale UseDoconut() e il client BasePath. |
ResourcesPath | "/doconut-res" | Da dove vengono servite le risorse incorporate JS/CSS/immagine. |
LicensePath | "" (stringa vuota) | Percorso al file di licenza. Vuoto significa passare alla fonte successiva, poi ricerca automatica. |
LicenseContent | "" (stringa vuota) | Contenuto grezzo della licenza — da una variabile d'ambiente, un gestore di segreti o un database. |
LicenseStream | null | Licenza come stream, letta una volta all'avvio. |
ResetLicense | false | Flag di compatibilità riservato. I servizi .NET 8 attuali leggono la licenza durante AddDoconut(); riavvia l'app dopo aver sostituito una licenza. |
MaxConcurrentEditorSessions | 200 | Numero massimo di sessioni editor live (documenti aperti con DocOptions.EditMode). Superato questo limite, la sessione editor inattiva meno recentemente usata viene chiusa. Le sessioni visualizzatore normali non sono mai conteggiate. 0 o un valore negativo indica nessun limite. |
EditorSnapshotEveryOps | 50 | Con la persistenza dell'editor abilitata (AddDoconutEditorPersistence), crea snapshot del documento live ogni N modifiche registrate. 0 o un valore negativo non crea mai snapshot a metà sessione. Nessun effetto quando la persistenza è disabilitata. |
Priorità della licenza quando è impostata più di una fonte: LicenseStream prevale su LicenseContent; su LicensePath; su ricerca automatica — vedi Configurazione della licenza.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // coordinare con la mappatura dell'app e il BasePath del client
options.ResourcesPath = "/doconut-res"; // da dove vengono serviti i JS/CSS/immagini del visualizzatore
options.UnsafeMode = false; // mantieni attiva la sicurezza della sessione
options.ShowDoconutInfo = false;
});Prossimi passi
- Avvio rapido — apri il tuo primo documento e renderizzalo nel browser.
- Configurazione della licenza — dove Doconut cerca il tuo file di licenza.
Questa pagina è stata utile?