Základní prohlížeč Doconut pro .NET 8 je distribuován jako jeden NuGet balíček, který se připojí k libovolné aplikaci ASP.NET Core. Volitelné pluginy používají samostatné balíčky. Tato stránka nainstaluje základní balíček a zaregistruje middleware — minimum potřebné před vaším prvním vykreslením.

Instalace balíčku

bash

dotnet add package Doconut.NET8

Příkaz bez verze nainstaluje nejnovější stabilní vydání. Pro přesnou reprodukci aktuálního vydání 26.7.0 zadejte verzi jako samostatnou možnost:

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 je ID balíčku. Přípona .26.7.0 patří ke staženému souboru Doconut.NET8.26.7.0.nupkg a není součástí ID.

Registrace Doconut

AddDoconut() je jediný vstupní bod registrace — existuje jediný overload a propojí službu Viewer, licenční službu a renderovací infrastrukturu do kontejneru DI.

Dvě volání middleware dokončují nastavení a jejich pořadí je důležité: UseDoconutResources() musí běžet před UseDoconut(). UseDoconut() je terminální middleware, takže jeho první volání způsobí, že každý požadavek na /doconut-res asset nikdy nedosáhne obsluhy zdrojů a skončí 404. Propojení se session je také vyžadováno — výchozí zabezpečení dokumentů Doconut ověřuje každý požadavek stránky vůči stavu ASP.NET session.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // stav relace potřebuje mezipaměť (MVC/Razor Pages již přidávají jednu)
builder.Services.AddSession(); // zabezpečení dokumentů Doconut používá stav relace ASP.NET

app.UseSession();          // zavolejte UseSession() před UseDoconut()
app.UseDoconutResources(); // musí být zaregistrováno před UseDoconut()
app.UseDoconut();

Všechny možnosti

DoconutOptions přijímá následující nastavitelná vlastnosti. Každá je volitelná — výchozí hodnoty níže platí, pokud je vlastnost ponechána nenastavenou.

Property	Default	Description
`ShowDoconutInfo`	`false`	Když je `true`, požadavek bez `token` vrátí banner verze místo 404. Užitečné jako rychlá kontrola; v produkci vypněte.
`UnsafeMode`	`false`	Když je `true`, přeskočí kontrolu zabezpečení ASP.NET‑session při požadavcích na stránky. V produkci vypněte.
`MiddlewarePath`	`"/doconut"`	Koordinační hodnota pro koncový bod stránka‑obrázek. Je ověřována, ale sama o sobě nevytváří větev; udržujte ji v souladu se skutečným mapováním `UseDoconut()` a klientským `BasePath`.
`ResourcesPath`	`"/doconut-res"`	Odkud jsou servírovány vložené JS/CSS/obrázkové zdroje.
`LicensePath`	`""` (empty string)	Cesta k souboru licence. Prázdná hodnota znamená přechod na další zdroj, poté automatické hledání.
`LicenseContent`	`""` (empty string)	Surový obsah licence — z proměnné prostředí, správce tajemství nebo databáze.
`LicenseStream`	`null`	Licence jako stream, načtená jednou při spuštění.
`ResetLicense`	`false`	Rezervovaný příznak kompatibility. Aktuální služby .NET 8 čtou licenci během `AddDoconut()`; po výměně licence restartujte aplikaci.

Priorita licencí, když je nastaveno více zdrojů: LicenseStream přebije LicenseContent, který přebije LicensePath, který přebije automatické hledání — viz Nastavení licence.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // koordinujte s mapováním aplikace a BasePath klienta
    options.ResourcesPath   = "/doconut-res"; // odkud jsou servírovány JS/CSS/obrázky prohlížeče
    options.UnsafeMode      = false;          // ponechte zabezpečení relace zapnuté
    options.ShowDoconutInfo = false;
});

Další kroky

Rychlý start — otevřete svůj první dokument a vykreslete jej v prohlížeči.
Nastavení licence — kde Doconut hledá váš soubor licence.