.NET 8 için temel Doconut görüntüleyicisi, herhangi bir ASP.NET Core uygulamasına takılan tek bir NuGet paketi olarak gelir. İsteğe bağlı eklentiler ayrı paketler kullanır. Bu sayfa temel paketi kurar ve ara katmanı (middleware) kaydeder — ilk renderınızdan önce gereken minimum şeyler.

Paketi kurun

bash

dotnet add package Doconut.NET8

Sürüm belirtilmemiş komut en son kararlı sürümü kurar. Mevcut 26.7.0 sürümünü tam olarak yeniden oluşturmak için sürümü ayrı bir seçenek olarak geçirin:

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 paket kimliğidir. .26.7.0 eki, indirilen Doconut.NET8.26.7.0.nupkg dosya adının bir parçasıdır ve kimliğin içinde yer almaz.

Doconut'u kaydedin

AddDoconut() tek kayıt giriş noktasıdır — tek bir aşırı yükleme vardır ve Viewer hizmetini, lisans hizmetini ve render altyapısını DI konteynerine bağlar.

İki ara katman çağrısı kurulumu tamamlar ve sıraları önemlidir: UseDoconutResources() UseDoconut()'dan önce çalıştırılmalıdır. UseDoconut() uç (terminal) ara katmandır, bu yüzden onu önce çağırmak, /doconut-res varlığına yapılan her isteğin kaynak işleyicisine ulaşamamasına ve 404 hatası almasına neden olur. Oturum bağlaması da gereklidir — Doconut'un varsayılan belge güvenliği her sayfa isteğini ASP.NET oturum durumu ile doğrular.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // oturum durumu bir önbellek gerektirir (MVC/Razor Pages zaten bir tane ekler)
builder.Services.AddSession(); // Doconut belge güvenliği ASP.NET oturum durumuna dayanır

app.UseSession();          // UseSession()'i UseDoconut()'dan önce çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.UseDoconut();

Tüm seçenekler

DoconutOptions aşağıdaki ayarlanabilir özellikleri kabul eder. Hepsi isteğe bağlıdır — bir özellik ayarlanmamışsa aşağıdaki varsayılanlar uygulanır.

Özellik	Varsayılan	Açıklama
`ShowDoconutInfo`	`false`	`true` olduğunda, `token` içermeyen bir istek 404 yerine bir sürüm bannerı döndürür. Bir sağlık kontrolü olarak faydalıdır; üretimde kapalı tutun.
`UnsafeMode`	`false`	`true` olduğunda, sayfa isteklerinde ASP.NET-oturum güvenlik kontrolünü atlar. Üretimde kapalı tutun.
`MiddlewarePath`	`"/doconut"`	Sayfa-görüntü uç noktası için koordinasyon değeri. Doğrulanır, ancak tek başına bir dal oluşturmaz; gerçek `UseDoconut()` eşlemesi ve istemci `BasePath` ile uyumlu tutun.
`ResourcesPath`	`"/doconut-res"`	Gömülü JS/CSS/görsel kaynakların sunulduğu yer.
`LicensePath`	`""` (boş dize)	Lisans dosyasının yolu. Boş bırakmak, bir sonraki kaynağa geçilmesi ve ardından otomatik arama anlamına gelir.
`LicenseContent`	`""` (boş dize)	Ham lisans içeriği — bir ortam değişkeni, gizli yönetici veya veritabanından.
`LicenseStream`	`null`	Lisans bir akış olarak, başlangıçta bir kez okunur.
`ResetLicense`	`false`	Ayrılmış uyumluluk bayrağı. Mevcut .NET 8 hizmetleri lisansı `AddDoconut()` sırasında okur; bir lisans değiştirildikten sonra uygulamayı yeniden başlatın.

Birden fazla kaynak ayarlandığında lisans önceliği: LicenseStream, LicenseContent'i, LicensePath'i ve otomatik aramayı geçer — bkz. Lisans Kurulumu.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // uygulama eşlemesi ve istemci BasePath'iyle koordine edin
    options.ResourcesPath   = "/doconut-res"; // görüntüleyicinin JS/CSS/görsellerinin sunulduğu yer
    options.UnsafeMode      = false;          // oturum güvenliğini açık tutun
    options.ShowDoconutInfo = false;
});

Sonraki adımlar

Hızlı Başlangıç — ilk belgenizi açın ve tarayıcıda render edin.
Lisans Kurulumu — Doconut'un lisans dosyanızı aradığı yer.