Kurulum

Doconut'u .NET 6 projenize ekleyin

.NET 6 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 ve ara katmanı (middleware) kaydeder — ilk render'ınızdan önce gereken minimum şey.

Gereksinimler

Paket aşağıdaki platformlarda çalışır:

PlatformDestekleniyor
Windows x64 / x86Evet
Linux x64, glibc tabanlı (Debian, Ubuntu, resmi mcr.microsoft.com/dotnet/aspnet:6.0-bookworm-slim görüntüsü)Evet
Alpine ve diğer musl tabanlı dağıtımlarHayır
macOSHayır

Linux'ta, ilk belge açılmadan önce font yapılandırma kütüphanesini kurun:

bash
apt-get update && apt-get install -y libfontconfig1

RHEL, Fedora ve benzeri dağıtımlarda paket fontconfig (dnf install -y fontconfig) şeklindedir. Bu, Doconut'un ihtiyaç duyduğu tek sistem paketidir: kullandığı yerel kütüphaneler NuGet paketinin içinde gelir ve libgdiplus gerekli değildir. Docker'da, aspnet:6.0-bookworm-slim (Debian 12) tercih edin: varsayılan aspnet:6.0 etiketi Debian 11'dir ve paket aynaları libfontconfig1 kurulumunda başarısız olabilir. Sayfalar sunucuda kurulu fontlarla çizilir, bu yüzden fontlar ve Linux hata mesajları için Sorun Giderme bölümüne bakın.

Paketi Kurun

bash
dotnet add package Doconut.NET6

Versiyonsuz komut en son kararlı sürümü kurar. Bu belgede açıklanan sürümü sabitlemek için, sürümü ayrı bir seçenek olarak geçin:

bash
dotnet add package Doconut.NET6 --version 26.10.0

Doconut.NET6 paket kimliğidir. Sürüm soneki, indirilen Doconut.NET6.<version>.nupkg dosya adının bir parçasıdır ve kimliğin bir bölümü değildir.

Yükseltmeden Önce Entegrasyonu Belirleyin

Doconut.NET6 paket kimliği, klasik ve mevcut .NET 6 entegrasyonları tarafından kullanılmıştır. Belgeleri yalnızca paket adından seçmeyin:

  • DocImage.axd, new Viewer(_cache, _accessor, ...), eşzamanlı OpenDocument(...) ve manuel olarak kopyalanmış görüntüleyici betikleri, klasik entegrasyonu tanımlar;
  • AddDoconut(), UseDoconutResources(), bir enjekte edilmiş Viewer ve OpenDocumentAsync(...), burada belgelenen mevcut entegrasyonu tanımlar.

Çevrilmiş klasik kurulum kılavuzu hâlâ mevcuttur. Nesilleri değiştirmek için göç rehberini kullanın; normal bir paket güncellemesi başlangıcı, görüntüleyici ömrünü 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 servisini, lisans servisini ve render altyapısını DI konteynerine bağlar.

Kurulumu tamamlamak için iki ara katman (middleware) çağrısı vardır ve sıraları önemlidir: UseDoconutResources(), UseDoconut()'den önce çalışmalıdır. UseDoconut() terminal bir ara katmandır, bu yüzden onu önce çağırmak, bir /doconut-res varlığına yapılan her isteğin kaynak işleyicisine ulaşamamasına ve 404 hatası almasına neden olur. UseDoconut() ona ulaşan her isteğe yanıt verir, bu yüzden kendi dalında app.Map ile monte edin. Oturum bağlaması da gereklidir — Doconut'un varsayılan belge güvenliği, her sayfa isteğini ASP.NET oturum durumuna göre doğrular.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // session state bir önbellek gerektirir (MVC/Razor Pages zaten bir tane ekler)
builder.Services.AddSession(); // Doconut belge güvenliği ASP.NET session state üzerine kuruludur

app.UseSession();          // UseDoconut()'dan önce UseSession() çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.Map("/doconut", branch => branch.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.

ÖzellikVarsayılanAçıklama
ShowDoconutInfofalsetrue olduğunda, token içermeyen bir istek 404 yerine bir sürüm banner'ı döndürür. Bir test kontrolü olarak faydalıdır; üretimde kapalı bırakın.
UnsafeModefalsetrue olduğunda, sayfa isteklerinde ASP.NET-oturum güvenlik kontrolünü atlar. Üretimde kapalı bırakın.
MiddlewarePath"/doconut"Sayfa-görsel 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 nereden sunulduğu.
LicensePath"" (empty string)Lisans dosyasının yolu. Boş ise bir sonraki kaynağa geçilir, ardından otomatik arama yapılır.
LicenseContent"" (empty string)Ham lisans içeriği — bir ortam değişkeni, gizli yönetici veya veritabanından.
LicenseStreamnullLisans bir akış olarak, başlangıçta bir kez okunur.
ResetLicensefalseAyrılmış uyumluluk bayrağı. Mevcut .NET 6 servisleri lisansı AddDoconut() sırasında okur; bir lisans değiştirildikten sonra uygulamayı yeniden başlatın.
MaxConcurrentEditorSessions200Canlı editör oturumlarının (DocOptions.EditMode ile açılan belgeler) maksimum sayısı. Bu sayı aşılırsa, en az kullanılan boşta kalan editör oturumu kapatılır. Normal görüntüleyici oturumları sayılmaz. 0 veya negatif bir değer sınırlama olmadığı anlamına gelir.
EditorSnapshotEveryOps50Editör kalıcılığı etkinleştirildiğinde (AddDoconutEditorPersistence), canlı belgeyi her N kaydedilen değişiklikte bir anlık görüntü alır. 0 veya negatif bir değer oturum ortasında anlık görüntü almaz. Kalıcılık devre dışı bırakıldığında etkisi yoktur.

Birden fazla kaynak ayarlandığında lisans önceliği: LicenseStream, LicenseContent, LicensePath ve otomatik arama sırasıyla önceliklidir — Lisans Kurulumu bölümüne bakın.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // app haritalaması ve istemci BasePath'i ile koordine edin
    options.ResourcesPath   = "/doconut-res"; // görüntüleyicinin JS/CSS/görsellerinin nereden sunulduğu
    options.UnsafeMode      = false;          // session güvenliğini açık tutun
    options.ShowDoconutInfo = false;
});

Sonraki Adımlar

Bu sayfa yardımcı oldu mu?