Základní prohlížeč Doconut pro .NET 8 je distribuován jako jeden balíček NuGet, který se připojuje 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řesné reprodukování aktuálního vydání 26.7.0 zadejte verzi jako samostatnou volbu:

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ý přetížení a propojuje službu Viewer, licenční službu a infrastrukturu vykreslování 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 pokud je zavoláno jako první, každá žádost o prostředek /doconut-res nikdy nedosáhne obsluhy zdrojů a vrátí 404. Propojení sezení je také vyžadováno — výchozí zabezpečení dokumentů Doconut ověřuje každou žádost o stránku vůči stavu sezení ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Zabezpečení dokumentů Doconut využívá stav sezení ASP.NET

app.UseSession();          // volání 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 se použijí, pokud je vlastnost ponechána nenastavena.

Vlastnost	Výchozí	Popis
`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 u požadavků na stránky. V produkci vypněte.
`MiddlewarePath`	`"/doconut"`	Koordinační hodnota pro endpoint stránky-obrázku. Je ověřena, 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 poskytovány vložené JS/CSS/obrázkové zdroje.
`LicensePath`	`""` (empty string)	Cesta k licenčnímu souboru. Prázdná hodnota znamená přechod na další zdroj, pak 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 má přednost před LicenseContent, který má přednost před LicensePath, který má přednost před automatickým hledáním — viz License Setup.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // koordinovat s mapováním aplikace a klientským BasePath
    options.ResourcesPath   = "/doconut-res"; // kde jsou poskytovány JS/CSS/obrázky prohlížeče
    options.UnsafeMode      = false;          // zachovat zabezpečení sezení
    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áš licenční soubor.