Lisans Kurulumu

Doconut'un lisans dosyanızı nerede aradığı

Bir lisans olmadan, Doconut hâlâ belgeleri render eder — her sayfa sadece bir değerlendirme filigranı taşır. Bu sayfa, bir lisansı sağlamanın dört yolunu ve birden fazla yol ayarlandığında tam önceliği kapsar.

Lisans bir kez, AddDoconut() sırasında yüklenir. Bu, önceki .NET Standard kütüphanesinden bir değişikliktir; o zaman lisans bir Viewer örneğine verilirdi ya da statik Viewer.DoconutLicense(...) / Viewer.SetLicensePlugin(...) çağrılarıyla ayarlanırdı. Bu yöntemler bu sürümde bir başlangıç mekanizması değildir — geçiş rehberi bölümüne bakın.

Lisansı sağlamanın dört yolu

Dört yol vardır: DoconutOptions üzerindeki üç açık kaynak — bir akış, ham içerik veya bir dosya yolu — ve hiçbiri ayarlanmamışsa otomatik keşif. Birden fazla kaynak ayarlandığında, öncelik tam olarak şöyledir:

LicenseStream, LicenseContent, LicensePath ve otomatik arama üstüne gelir.

Yol ile

LicensePath tam olarak verildiği gibi File.Exists'a geçirilir. Göreceli bir yol, işlemin current working directory'e göre çözülür — projenizin klasörü değil ve Program.cs'ın bulunduğu klasör de değil. Yol çözülemezse, Doconut bir hata atmaz ve not otomatik arama — sadece lisans yüklemez ve görüntüleyici filigran ekler. Otomatik arama yalnızca LicensePath, LicenseContent veya LicenseStream'dan hiçbiri ayarlı olmadığında çalışır. Aynı klasördeki (Doconut.Viewer.<Capability>.lic) eklenti başına lisans dosyaları onunla birlikte okunur, böylece LicensePath ve AddPlugin<...>(), eklenti lisansları temel lisansın yanında bulunduğunda birlikte çalışır.

Mutlak bir yol tercih edin (örneğin IWebHostEnvironment.WebRootPath veya AppContext.BaseDirectory'dan oluşturulan), ya da LicensePath'ı tamamen atlayıp aşağıdaki otomatik keşfe güvenin.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});

Akış ile

LicenseStream başlangıçta bir kez okunur — lisansın bir dosya yerine gizli bir depodan gelmesi durumunda kullanışlıdır.

csharp
// Öncelik: LicenseStream > LicenseContent > LicensePath > otomatik-ara.
builder.Services.AddDoconut(options =>
{
    options.LicenseStream = licenseStream;
});

İçerik ile

LicenseContent lisans metnini doğrudan kabul eder — bir ortam değişkeni, bir veritabanı veya bir gizli yönetici aracılığıyla:

csharp
// Veritabanı, ortam değişkeni veya gizli yönetici üzerinden Lisans XML'i —
// diskte dosya yok. Sadece LicenseStream tarafından geçilir.
builder.Services.AddDoconut(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

Otomatik keşif

Üç açık kaynağın hiçbirini yapılandırmazsanız, Doconut kendisi lisansı arar:

csharp
// Hiçbir şey yapılandırmayın, Doconut lisansı kendisi arar, yalnızca bu iki klasörde:
//   1. {CurrentDirectory}/wwwroot
//   2. {AppContext.BaseDirectory}/wwwroot   (wwwroot, derleme çıktı klasörünün içinde)
// İlk olarak Doconut.lic dosyasını arar; eğer bu eksikse, Doconut.Viewer.lic ve herhangi bir
// her-yetenek Doconut.Viewer.<Capability>.lic dosyaları.
builder.Services.AddDoconut();

Sorgulama klasörleri sırasıyla ve aranan dosya adları:

text
1. {CurrentDirectory}/wwwroot
2. {AppContext.BaseDirectory}/wwwroot

Filenames, in order (each one looked for in folder 1, then folder 2):
  Doconut.lic                          — legacy all-in-one license; if found, nothing else is read
  Doconut.Viewer.lic                   — base viewer license
  Doconut.Viewer.<Capability>.lic      — per-capability licenses, read only when Doconut.Viewer.lic was found

wwwroot klasörünün dışındaki hiçbir şey okunmaz: çıktı klasöründeki bir .lic veya wwwroot/lib içinde bulunan bir dosya yok sayılır.

Daha önce Viewer yapıcısına lisans yollarının bir List<string>'ını — yetenek başına bir tane — ilettiyseniz, bu yardımcı dosyaları Doconut.Viewer.lic'ın yanına koyun ve otomatik keşfin onları almasını sağlayın. DoconutOptions üzerinde yol listesi seçeneği yoktur.

Lisansı çıkış klasörüne kopyalayın

İşlem proje klasöründen çalışmadığında — yayınlanmış bir uygulama, IIS, bir konteyner, bir test çalıştırıcı — ilk tarama başarısız olur ve ikinci tarama, {AppContext.BaseDirectory}/wwwroot, dosyayı bulmak zorundadır. Bu MSBuild hedefi, her derlemede lisansları oraya kopyalar:

xml
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
  <ItemGroup>
    <DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
    <StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
  </ItemGroup>
  <!-- İlk olarak sil, böylece wwwroot içindeki bir .lic dosyasını yeniden adlandırmak veya kaldırmak da çıktıda yer almaz. -->
  <Delete Files="@(StaleOutputLicenses)" />
  <Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>

Hedef, $(OutDir)wwwroot olmalıdır: çıkış köküne kopyalanan bir .lic otomatik arama tarafından asla bulunmaz. Bu sayfadaki LicensePath örnekleri aynı konuma işaret eder.

.lic dosyalarını kaynak kontrolünden uzak tutun — uygulamanın yanına dağıtın veya lisansı gizli depodan LicenseContent veya LicenseStream aracılığıyla enjekte edin.

Lisans olmadan ne olur

Eksik bir lisans hata vermez. AddDoconut() başarılı olur, uygulama başlar ve görüntüleyici çalışır — ancak her sayfa bir değerlendirme su işareti taşır ve hiçbir isteğe bağlı yetenek sağlanmaz.

Bulunan ancak reddedilen bir lisans dosyası farklıdır. Geçersiz bir imza, müdahale, kara listeye alma veya lisansın sürüm penceresinin dışındaki bir derleme, OpenDocumentAsync'un LicenseException hatası atmasına ve License.RejectionMessage ile birlikte gelmesine neden olur. Süresi dolmuş bir Geçici lisans su işareti modunda devam eder. Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her derlemede temiz bir şekilde ve yetenekleriyle çalışmaya devam eder.

Eklentiler yeteneklere ihtiyaç duyar

İlgili bir yetki olmadan bir eklentiyi kaydetmek farklıdır: eksik bir lisans, eski bir TRIAL dosyası veya o yeteneği içermeyen ücretli bir lisans durumunda, AddDoconut() InvalidOperationException hatası verir, bu yüzden uygulama başlatılamaz. Örneğin, Converter eklentisini, Converter yetkisini veren bir lisans olmadan kaydetmek:

text
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.

Mesaj, çözümü doğrudan söyler: ya o eklenti için options.AddPlugin<...>() çağrısını kaldırın, ya da yeteneği sağlayan bir ücretli lisans ya da aktif bir Geçici/Demo (NFR) lisansı kurun. Geçici kayıtların süresi dolduktan sonra da varlıklarını sürdürmesine izin verilir, böylece önceden yapılandırılmış bir uygulama yeniden başlatma sırasında çökmek yerine çalışma zamanında işlevselliğini azaltabilir; süresi dolduğunda ise yetenekleri hâlâ iptal edilir.

Yüklenen lisansı doğrulayın

SDK tarafından kullanılan aynı doğruluk kaynağı olan IDoconutLicenseService'ı kullanarak kimliği doğrulanmış bir tanı uç noktası açın veya özellik bayraklarını yönetin. Lisans içeriğini veya anahtarlarını geri döndürmeyin.

csharp
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(new
{
    viewer = license.IsViewerLicensed || license.IsTemporary,
    temporary = license.IsTemporary,
    search = license.IsCapabilityGranted(LicenseCapability.Search),
    annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
    converter = license.HasConverter,
    dicom = license.HasDicom
}));

Lisans, AddDoconut() kaydı sırasında okunur. ResetLicense şu anda aktif bir yeniden yükleme yolu olmayan bir uyumluluk özelliğidir, bu yüzden bir lisans dosyasını değiştirmek uygulamanın yeniden başlatılmasını gerektirir.

Sorun giderme matrisi

SemptomMuhtemel nedenKontrol
Görüntüleyici çalışıyor ancak her sayfa su işareti taşıyorLisans yüklenmedi veya Geçici lisans süresi dolduIDoconutLicenseService sorununu çözün; çıkış dizinini ve işlem çalışma dizinini doğrulayın
AddDoconut() bir eklenti için hata verirLisans o eklenti yeteneğini sağlamıyorIsCapabilityGranted(...) kontrol edin ve satın almadığınız kayıtları kaldırın
Yapılandırılmış bir göreli yol yerel olarak çalışıyor ancak IIS/konteynerde çalışmıyorİşlem çalışma dizini değiştiAppContext.BaseDirectory kullanın veya mutlak bir yol belirtin
Değiştirilen .lic dosyası etkisizTekil lisans hizmeti zaten oluşturulmuştuUygulamayı yeniden başlatın
OpenDocumentAsync LicenseException hatası verirİmza, domain, sürüm aralığı, kara liste veya eklenti çalışma zamanı kontrolü lisansı reddettiİstisna/red mesajını güvensiz istemcilere göstermeden okuyun
Yeteneğe özgü lisans daha önce çalışıyordu ancak artık çalışmıyorEski kod, Viewer yapıcısına açık lisans yolları gönderiyorduCompanion .lic dosyalarını Doconut.Viewer.lic yanına taşıyın ve otomatik keşfin onları yüklemesine izin verin

Sonraki adımlar

  • Lisanslama — yetenekler, lisans seviyeleri ve çalışma zamanında ne yüklendiğini doğrulama.
  • Sorun Giderme — filigranlar, reddedilen lisanslar ve yetenek hataları.

Bu sayfa yardımcı oldu mu?