Lisans Kurulumu

Doconut nerede lisans dosyanızı arıyor

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 ayarlandığında kesin önceliği kapsar.

Lisans sağlamak için dört yol

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 ayarlandığında, öncelik kesin olarak şöyledir:

LicenseStream üstün gelir LicenseContent üstün gelir LicensePath üstün gelir otomatik arama.

Yol ile

LicensePath tam olarak verildiği gibi File.Exists'a geçirilir. Göreceli bir yol, işlemin şu anki çalışma dizinine göre çözülür — proje klasörünüz değil ve Program.cs'nin bulunduğu klasör de değil. Yol çözülemezse, Doconut bir hata atmaz ve değil otomatik aramaya geri dönmez — 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, bu yüzden LicensePath ve AddPlugin<...>() temel lisansın yanında eklenti lisansları bulunduğunda birlikte çalışır.

Mutlak bir yol tercih edin (örneğin IWebHostEnvironment.WebRootPath veya AppContext.BaseDirectory'den 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 arama.
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
// License XML bir veritabanından, ortam değişkeninden veya gizli yöneticiden —
// 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 lisansı kendisi arar:

csharp
// Hiçbir şey yapılandırmayın ve 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)
// Önce Doconut.lic dosyasını arar; eğer bu eksikse, Doconut.Viewer.lic ve herhangi bir
// her eklenti için 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-plugin licenses, read only when Doconut.Viewer.lic was found

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

Lisansı çıktı klasörünüze kopyalayın

İşlem proje klasöründen çalışmadığında — yayınlanmış bir uygulama, IIS, bir konteyner, bir test çalıştırıcı — ilk sorgulama kaçırılır ve ikinci sorgulama, {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 silin, 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: çıktı 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, ya da lisansı gizli deponuzdan 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 filigranı taşır ve hiçbir isteğe bağlı yetenek verilmez.

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'nin LicenseException ile License.RejectionMessage atmasına neden olur. Süresi dolmuş Geçici lisans filigranlı modda devam eder. Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her derlemede temiz ve yetenekleriyle çalışmaya devam eder.

Eklentilerin yeteneklere ihtiyacı var

Uygun bir yetki olmadan bir eklenti kaydetmek farklıdır: eksik bir lisans, eski bir TRIAL dosyası veya o yeteneği içermeyen bir ücretli lisans durumunda, AddDoconut() InvalidOperationException atar, bu yüzden uygulama başlatılamaz. Örneğin, Converter sağlayan bir lisans olmadan Converter eklentisini 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, düzeltmeyi 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 dolmuş olsa bile hayatta kalmasına izin verilir, böylece önceden yapılandırılmış bir uygulama yeniden başlatma sırasında çökmek yerine çalışma zamanında gerileyebilir; süresi dolduğunda ise yetenekleri hâlâ iptal edilir.

Yüklenen lisansı doğrulama

IDoconutLicenseService'ı kullanın, SDK tarafından kullanılan aynı gerçek kaynağı, kimliği doğrulanmış bir tanı uç noktasını ortaya çıkarmak veya özellik bayraklarını yönlendirmek için. 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 uygulamayı yeniden başlatmayı gerektirir.

Sorun giderme matrisi

SemptomMuhtemel nedenKontrol
Görüntüleyici çalışıyor ancak her sayfa filigranlıLisans yüklenmedi veya Geçici lisans süresi dolduIDoconutLicenseService'ı çözün; çıktı 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/konteyner içinde çalışmıyorİşlem çalışma dizini değiştiAppContext.BaseDirectory'ı veya mutlak bir yolu kullanın
Değiştirilen .lic dosyası etkisizTekil lisans hizmeti zaten oluşturulmuştuUygulamayı yeniden başlatın
OpenDocumentAsync LicenseException verirİmza, domain, sürüm penceresi, kara liste veya eklenti çalışma zamanı kapısı lisansı reddettiİstisna/red mesajını güvensiz istemcilere göstermeden okuyun

Sonraki adımlar

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

Bu sayfa yardımcı oldu mu?