Kurulum

.NET Standard için temel Doconut görüntüleyicisi, herhangi bir ASP.NET Core uygulamasına bağlanan tek bir NuGet paketi olarak gelir. İsteğe bağlı eklentiler ayrı paketler kullanır. Bu sayfa temel paketi kurar, ana bilgisayarınızın bunu tüketebileceğini doğrular ve ara katmanı (middleware) kaydeder — ilk render'ınızdan önce gereken minimum şey.

Öncelikle ana bilgisayar çerçevesini kontrol edin

Kütüphane netstandard2.1 hedeflemektedir. Bu, önceki netstandard2.0 derlemesinden daha dar bir sözleşmedir ve doğrulanması gereken ilk şeydir:

Uygulama .NET Framework üzerinde çalışıyorsa, bu doğru paket değildir. Bunun yerine Doconut.NETFramework kullanın; 26.9.0 sürümünden itibaren .NET Framework 4.7.2 gerektirir. Bu sürümle birlikte gelen referans uygulamaları net8.0 hedeflemektedir.

Paketi kurun

dotnet add package Doconut.NETStandard

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

dotnet add package Doconut.NETStandard --version 26.8.0

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

Sürüm numarası nesli belirler

Bu, paket adından daha çok burada önemlidir. Her iki .NET Standard kütüphane nesli aynı paket kimliği altında yayınlanır, ve yalnızca sürüm onları ayırır:

Uyumluluk köprüsü ve yan yana paket yoktur. Sürümü yükseltmek yükseltmedir ve derleyici API farklarını hemen rapor eder.

Belgelendirmeyi yalnızca paket adından seçmeyin:

• new Viewer(_cache, _accessor, …), UnSafeMode, senkron OpenDocument(...), viewer.InitCache(), UseDoconutWebFarm ve manuel olarak kopyalanmış görüntüleyici betikleri önceki entegrasyonu tanımlar;
• AddDoconut(), UseDoconutResources(), enjekte edilmiş bir Viewer ve OpenDocumentAsync(...) mevcut entegrasyonu burada belgeler.

Çevrilen önceki kurulum kılavuzu hâlâ kullanılabilir.
Göç rehberini kullanarak nesilleri değiştirebilirsiniz; bir paket güncellemesi başlangıç, görüntüleyici ömrü veya tarayıcı kaynaklarını otomatik olarak dönüştürmez.

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() terminal ara katmandır, bu yüzden önce çağrılırsa /doconut-res varlığına yapılan her istek kaynak işleyicisine ulaşamaz ve 404 döner. Oturum bağlaması da gereklidir — Doconut'un varsayılan belge güvenliği her sayfa isteğini ASP.NET oturum durumu ile doğrular.

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 durumu üzerine kuruludur

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

Ad Alanları

Bu sürümde yapılandırma tipleri artık dört ayrı ad alanına yayılmış değildir. Neredeyse her şey kök Doconut ad alanında bulunur:

using Doconut;                       // Viewer, DoconutOptions, DocOptions ve tüm format yapılandırmaları
using Doconut.Middleware;            // AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds;                // bulut ve dosya paylaşım yapılandırmaları
using Doconut.Configs.Conversion;    // ConversionTarget

Tip adları değişmedi — PdfConfig, WordConfig, ExcelConfig, CssConfig, ScriptConfig ve diğerleri hâlâ mevcuttur. Mevcut bir uygulamayı taşıyorsanız, çoğu dosyada sadece iki using satırını silmeniz yeterlidir; bkz. göç rehberi.

Tüm seçenekler

DoconutOptions aşağıdaki ayarlanabilir özellikleri kabul eder. Hepsi isteğe bağlıdır — bir özellik boş bırakıldığında aşağıdaki varsayılanlar uygulanır.

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

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // uygulama eşlemesi ve istemci BasePath ile koordinasyon
    options.ResourcesPath   = "/doconut-res"; // görüntüleyicinin JS/CSS/görsellerinin hizmet verdiği yer
    options.UnsafeMode      = false;          // oturum güvenliğini açık tut
    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.