Αδειοδότηση
Δυνατότητες, επίπεδα αδειών και η υπηρεσία αδειών
Αυτή η σελίδα είναι η αναφορά χρόνου εκτέλεσης για το πώς μια άδεια διαμορφώνει τη συμπεριφορά του Doconut: τι επιτρέπει κάθε κατάσταση άδειας, πώς χορηγούνται οι δυνατότητες και πώς να τις ελέγξετε όλο από τον κώδικα. (Για φόρτωση μιας άδειας, δείτε Ξεκινώντας → Ρύθμιση Άδειας.)
Καταστάσεις άδειας και τι κάνουν
| Κατάσταση | Ανοίγει έγγραφα; | Υδατογράφημα | Δυνατότητες |
|---|---|---|---|
| Πλήρης (πληρωμένη) άδεια (αυτή η έκδοση κυκλοφόρησε πριν από την ημερομηνία συνδρομής) | Ναι | Κανένα | Οι αγορασμένες (Has* flags) |
| Προσωρινή άδεια (Developer/NFR — η άδεια αξιολόγησης, πριν από την ημερομηνία λήξης) | Ναι | Κανένα στον βασικό προβολέα· η έξοδος του plugin είναι υδατογραφημένη | Όλα — γενική χορήγηση (το κανάλι αξιολόγησης) |
Ληγμένη προσωρινή άδεια (πέρα από την ημερομηνία LicenseExpiry) | Ναι | Υδατογράφημα αξιολόγησης | Καμία χορήγηση |
| Καμία αρχείο άδειας καθόλου | Ναι | Υδατογράφημα αξιολόγησης | Καμία χορήγηση |
| Βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραποιημένο, σε μαύρη λίστα, ή έκδοση που κυκλοφόρησε μετά την ημερομηνία συνδρομής της άδειας) | Όχι — LicenseException σε κάθε άνοιγμα | — | — |
Μια πληρωμένη άδεια της οποίας η ημερομηνία συνδρομής έχει περάσει συνεχίζει να λειτουργεί — καθαρά, με τις δυνατότητές της — σε κάθε έκδοση που κυκλοφόρησε πριν από αυτήν την ημερομηνία. Μόνο μια έκδοση που κυκλοφορήσει μετά απορρίπτεται.
Δύο συνέπειες που αξίζει να εσωτερικεύσετε:
- Η απουσία άδειας δεν είναι προσωρινή άδεια. Χωρίς αρχείο άδειας, οι σελίδες εμφανίζονται με υδατογράφημα και καμία δυνατότητα (αναζήτηση, σχολιασμός, πρόσθετα) δεν είναι ενεργή. Η πλήρης, χωρίς υδατογράφημα εμπειρία απαιτεί μια πραγματική Προσωρινή άδεια (αποκτήστε μία).
- Μόνο μια απορριφθείσα άδεια εμποδίζει το άνοιγμα. Μια ληγμένη Προσωρινή άδεια διατηρεί την εφαρμογή σε λειτουργία με το υδατογράφημα αξιολόγησης, και μια πληρωμένη άδεια που έχει περάσει την ημερομηνία συνδρομής συνεχίζει να εμφανίζεται καθαρά στις εκδόσεις που καλύπτει· αλλά η ανάπτυξη μιας έκδοσης που κυκλοφορήσει μετά την ημερομηνία συνδρομής της άδειας απορρίπτεται και αποτυγχάνει άμεσα με ένα
LicenseException, ώστε να το εντοπίσετε κατά την ανάπτυξη — όχι με σιωπηλή αποστολή εξόδου με υδατογράφημα. Η εξαίρεση (απόOpenDocumentAsync) μεταφέρει τον λόγο απόLicense.RejectionMessage.
Δυνατότητες
Το Doconut ελέγχει την προαιρετική λειτουργικότητα με δυνατότητα. Καλύπτει τις ενσωματωμένες λειτουργίες Αναζήτηση και Σχόλιο και τα πρόσθετα Μετατροπέας, Dicom και Υπογραφέας, το καθένα χορηγείται από την άδειά σας. Ο βασικός προβολέας δεν είναι δυνατότητα — είναι η προϋπόθεση, εμφανιζόμενη ως IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL άδεια παρούσα ΚΑΙ καλύπτει την έκδοση αυτής της κατασκευήςΗ μοναδική πύλη που χρησιμοποιεί ολόκληρη η αλυσίδα επεξεργασίας είναι IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Η λογική του, ακριβώς από την υλοποίηση: μια ενεργή (μη ληγμένη) Προσωρινή άδεια χορηγεί κάθε δυνατότητα — συμπεριλαμβανομένων των δυνατοτήτων που δεν έχουν ακόμη ειδική σημαία αγοράς· μια πραγματική αγορασμένη άδεια χορηγεί ακριβώς τις σημαίες Has* της και είναι από προεπιλογή-απόρριψη για οτιδήποτε μη αντιστοιχισμένο. (Ένα κληροδοτημένο αρχείο τύπου TRIAL δεν είναι δικαίωμα — αντιμετωπίζεται ως χωρίς άδεια: υδατογραφημένο, καμία χορήγηση.)
Προσωρινές άδειες
Οι προσωρινές (Developer/NFR) άδειες σημειώνονται με μια ετικέτα ExpiryNote και έχουν μια σκληρή ημερομηνία λήξης:
| Μέλος | Σημασία |
|---|---|
IsTemporary | Μια ετικέτα ExpiryNote υπάρχει (η ανίχνευση γίνεται με την παρουσία της ετικέτας — ποτέ δεν ταιριάζει με το κείμενο της σημείωσης, είναι δυναμική) |
ExpiryNote | Πληροφοριακό κείμενο ενσωματωμένο στην άδεια |
LicenseExpiry | Η σκληρή ημερομηνία λήξης (DateTime?) |
Η σημασιολογία λήξης διαφέρει ανά επίπεδο: μια προσωρινή άδεια λήγει στην ημερομηνία LicenseExpiry μόνο (το παράθυρο συνδρομής αγνοείται· μια προσωρινή άδεια χωρίς ημερομηνία θεωρείται ληγμένη, ασφαλής αποτυχία). Κάθε άλλη άδεια λήγει στην ημερομηνία του παραθύρου συνδρομής/ενημέρωσης· για μια πληρωμένη άδεια, το IsExpired αναφέρει μόνο ότι αυτή η ημερομηνία έχει περάσει — οι εκδόσεις που κυκλοφόρησαν πριν παραμένουν καθαρές και διατηρούν τις δυνατότητές τους.
Αναφορά IDoconutLicenseService
Ενσωματώστε το IDoconutLicenseService (namespace Doconut.Core.Interfaces; καταχωρημένο ως singleton — η άδεια αναλύεται μία φορά κατά την εκκίνηση):
| Μέλος | Σημασία |
|---|---|
License | Πλήρης στιγμιότυπο DoconutLicenseInfo (παρακάτω) |
IsTrial | Ένα κληροδοτημένο αρχείο τύπου TRIAL (θεωρείται ως χωρίς άδεια — όχι δικαίωμα) |
IsTemporary / ExpiryNote / LicenseExpiry | Σημαίες προσωρινής άδειας |
IsExpired | Ληγμένη σύμφωνα με τους κανόνες επιπέδου παραπάνω |
IsVersionValid | Αυτή η έκδοση βρίσκεται εντός του παραθύρου υποστήριξης της άδειας |
IsViewerLicensed | Βρέθηκε αρχείο μη-TRIAL και η έκδοση καλύπτεται — βασική προϋπόθεση |
IsCapabilityGranted(cap) | Η μοναδική πύλη δυνατότητας |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Μία σημαία ανά δυνατότητα: αγορασμένη από άδεια που καλύπτει αυτήν την έκδοση, ή χορηγείται από ενεργή Προσωρινή άδεια. Το IsCapabilityGranted απαντά στην ίδια ερώτηση ανά δυνατότητα |
IsValidForDomain(host) | Κάλυψη κεντρικού υπολογιστή· οι άδειες V4 χρησιμοποιούν το μπαλαντέρ *.* |
LicenseRejectionReason | Μη κενό ⇒ το άνοιγμα εμποδίζεται με αυτό το μήνυμα |
DoconutLicenseInfo εκθέτει το φιλικό προς την εμφάνιση στιγμιότυπο για πίνακες διαχειριστών: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, τις σημαίες Has*, τα πεδία προσωρινής άδειας, και RejectionMessage.
// Feature-flag το UI σας από την ίδια πηγή αλήθειας που χρησιμοποιεί το SDK
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,
}));Έλεγχος υγείας
AddDoconut() καταχωρεί έναν έλεγχο υγείας "doconut" που αναφέρει την κατάσταση άδειας/λήξης μέσω του τυπικού μηχανισμού ASP.NET Core:
app.MapHealthChecks("/health");Συνδέστε το στην παρακολούθησή σας και μια λήγουσα συνδρομή γίνεται ειδοποίηση αντί για αίτημα υποστήριξης. Ο έλεγχος αναφέρει Unhealthy όταν η άδεια απορρίπτεται ή το IsExpired είναι αληθές· για μια πληρωμένη άδεια, αυτό σημαίνει ότι η ημερομηνία συνδρομής έχει περάσει και ένα πακέτο που κυκλοφορεί μετά θα απορριφθεί — η τρέχουσα έκδοση παραμένει καθαρή.
Αναβαθμίσεις έκδοσης
Μια άδεια καλύπτει ένα παράθυρο έκδοσης. Η ενημέρωση του πακέτου NuGet σε μια έκδοση νεότερη από αυτό το παράθυρο καθιστά την άδεια άκυρη για αυτήν την έκδοση: το IsVersionValid μετατρέπει το false και το άνοιγμα εμποδίζεται με ένα LicenseException (ο λόγος βρίσκεται στο License.RejectionMessage) — σκόπιμη αποτυχία άμεσα, ώστε μια παλιά ή χωρίς άδεια έκδοση να εντοπιστεί κατά την ανάπτυξη αντί για σιωπηλή υδατογράφημα της παραγωγικής εξόδου. Ανανεώστε τη συνδρομή, αντικαταστήστε το .lic, και επανεκκινήστε την εφαρμογή ώστε το AddDoconut() φορτώνει τη νέα άδεια.
Ήταν αυτή η σελίδα χρήσιμη;