Licencjonowanie

Ta strona jest odniesieniem w czasie działania, opisującym jak licencja kształtuje zachowanie Doconut: co pozwala każdy stan licencji, jak przyznawane są funkcje i jak je wszystkie sprawdzić w kodzie. (Aby załadować licencję, zobacz Rozpoczęcie → Konfiguracja licencji.)

Stany licencji i ich działanie

Dwie konsekwencje warte zapamiętania:

• Brak licencji nie jest licencją tymczasową. Gdy nie ma pliku licencji, strony wyświetlane są ze znakiem wodnym i żadna funkcja (wyszukiwanie, adnotacje, wtyczki) nie jest aktywna. Pełne, nieoznaczone znakiem wodnym doświadczenie wymaga rzeczywistej Licencji tymczasowej (pobierz ją).
• Tylko odrzucona licencja blokuje otwieranie. Wygaśnięcie kalendarza/subskrypcji powoduje jedynie renderowanie ze znakiem wodnym; natomiast wdrożenie kompilacji nowszej niż okno wersji licencji jest odrzucane i szybko kończy się niepowodzeniem z LicenseException, więc łapiesz to przy wdrożeniu — a nie przez ciche dostarczanie wyjścia ze znakiem wodnym. Ten wyjątek (z OpenDocumentAsync) zawiera przyczynę z License.RejectionMessage.

Funkcje

Doconut kontroluje opcjonalną funkcjonalność za pomocą funkcji. Obecnie są to wtyczki Converter i DICOM, które można włączyć, oraz wbudowane funkcje Search i Annotation, każda przyznawana na podstawie twojej licencji. Podstawowy przeglądarka nie jest funkcją — jest wymogiem wstępnym, udostępnianym jako IsViewerLicensed:

Sprawdza, czy istnieje licencja nie‑TRIAL i obejmuje wersję tej kompilacji.

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

Jedyną bramką, której używa cały potok, jest IsCapabilityGranted:

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Jej logika, dosłownie z implementacji: aktywna (nieprzeterminowana) licencja tymczasowa przyznaje wszystkie funkcje — w tym te, które nie mają jeszcze dedykowanego flagi zakupu; rzeczywista zakupiona licencja przyznaje dokładnie swoje flagi Has* i ma domyślne odrzucenie dla wszystkiego, co nie jest zmapowane. (Plik typu TRIAL z przeszłości nie jest uprawnieniem — jest traktowany jako nielicencjonowany: znak wodny, nic nie przyznane.)

Licencje tymczasowe

Standardowe funkcje Search i Annotation korzystają bezpośrednio ze swoich istniejących funkcji.

Licencje tymczasowe (Developer/NFR) są oznaczone tagiem ExpiryNote i posiadają sztywną datę wygaśnięcia:

Semantyka wygaśnięcia różni się w zależności od poziomu: licencja tymczasowa wygasa w samą datę podaną w LicenseExpiry (okno subskrypcji jest ignorowane; licencja tymczasowa bez daty jest traktowana jako wygasła, zabezpieczenie). Wszystkie pozostałe licencje wygasają w dacie okna subskrypcji/aktualizacji.

Odniesienie do IDoconutLicenseService

Wstrzyknij IDoconutLicenseService (przestrzeń nazw Doconut.Core.Interfaces; zarejestrowany jako singleton — licencja jest parsowana raz przy uruchomieniu):

DoconutLicenseInfo udostępnia przyjazną dla wyświetlania migawkę dla paneli administracyjnych: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flagi Has*, pola licencji tymczasowej oraz RejectionMessage.

Opisuje, jak udostępnić flagi funkcji w API, aby UI mogło się do nich odwołać.

// Feature-flag your UI from the same source of truth the SDK uses
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
    viewer     = lic.IsViewerLicensed || lic.IsTemporary,
    search     = lic.IsCapabilityGranted(LicenseCapability.Search),
    annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
    conversion = lic.HasConverter,
    dicom      = lic.HasDicom,
}));

Sprawdzenie stanu zdrowia

AddDoconut() rejestruje sprawdzanie stanu zdrowia "doconut", które raportuje stan licencji/wygaśnięcia poprzez standardowy mechanizm ASP.NET Core:

app.MapHealthChecks("/health");

Podłącz to do swojego monitoringu, a wygasająca subskrypcja stanie się alertem zamiast zgłoszenia wsparcia.

Aktualizacje wersji

Licencja obejmuje okno wersji. Aktualizacja pakietu NuGet do kompilacji nowszej niż to okno powoduje, że licencja jest nieważna dla tej kompilacji: IsVersionValid przyjmuje wartość false i otwieranie jest blokowane z LicenseException (przyczyna znajduje się w License.RejectionMessage) — celowo szybkie niepowodzenie, aby przestarzała lub nielicencjonowana kompilacja została wykryta przy wdrożeniu, a nie cicho znakowana w produkcji. Odnów subskrypcję, zamień plik .lic i uruchom ponownie aplikację, aby AddDoconut() załadował nową licencję.