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.
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.
// Ö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:
// 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:
// 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ı:
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 foundwwwroot 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:
<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.
.licdosyalarını kaynak kontrolünden uzak tutun — uygulamanın yanına dağıtın veya lisansı gizli depodanLicenseContentveyaLicenseStreamaracı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:
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.
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
| Semptom | Muhtemel neden | Kontrol |
|---|---|---|
| Görüntüleyici çalışıyor ancak her sayfa su işareti taşıyor | Lisans yüklenmedi veya Geçici lisans süresi doldu | IDoconutLicenseService sorununu çözün; çıkış dizinini ve işlem çalışma dizinini doğrulayın |
AddDoconut() bir eklenti için hata verir | Lisans o eklenti yeteneğini sağlamıyor | IsCapabilityGranted(...) 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şti | AppContext.BaseDirectory kullanın veya mutlak bir yol belirtin |
Değiştirilen .lic dosyası etkisiz | Tekil lisans hizmeti zaten oluşturulmuştu | Uygulamayı 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ıyor | Eski kod, Viewer yapıcısına açık lisans yolları gönderiyordu | Companion .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?