Ο βασικός προβολέας Doconut για .NET 8 διανέμεται ως ένα πακέτο NuGet που ενσωματώνεται σε οποιαδήποτε εφαρμογή ASP.NET Core. Προαιρετικά πρόσθετα χρησιμοποιούν ξεχωριστά πακέτα. Αυτή η σελίδα εγκαθιστά το βασικό πακέτο και καταχωρίζει το middleware — το ελάχιστο που απαιτείται πριν από την πρώτη σας απόδοση.

Εγκατάσταση του πακέτου

bash

dotnet add package Doconut.NET8

Η εντολή χωρίς έκδοση εγκαθιστά την πιο πρόσφατη σταθερή έκδοση. Για να αναπαράγετε ακριβώς την τρέχουσα έκδοση 26.7.0, περάστε την έκδοση ως ξεχωριστή επιλογή:

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 είναι το ID του πακέτου. Το επίθημα .26.7.0 ανήκει στο όνομα αρχείου Doconut.NET8.26.7.0.nupkg και δεν αποτελεί μέρος του ID.

Καταχώριση του Doconut

AddDoconut() είναι το μοναδικό σημείο εισόδου καταχώρισης — υπάρχει μόνο μία υπερφόρτωση και συνδέει την υπηρεσία Viewer, την υπηρεσία άδειας και την υποδομή απόδοσης στο DI container.

Δύο κλήσεις middleware ολοκληρώνουν τη ρύθμιση, και η σειρά τους έχει σημασία: UseDoconutResources() πρέπει να εκτελεστεί πριν το UseDoconut(). Το UseDoconut() είναι τελικό middleware, οπότε η κλήση του πρώτα σημαίνει ότι κάθε αίτημα σε πόρο /doconut-res δεν φτάνει ποτέ στον διαχειριστή πόρων και επιστρέφει 404. Η σύνδεση της συνεδρίας απαιτείται επίσης — η προεπιλεγμένη ασφάλεια εγγράφων του Doconut επικυρώνει κάθε αίτημα σελίδας έναντι της κατάστασης συνεδρίας ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // η κατάσταση συνεδρίας χρειάζεται μια κρυφή μνήμη (MVC/Razor Pages ήδη προσθέτουν μία)
builder.Services.AddSession(); // η ασφάλεια εγγράφων Doconut βασίζεται στην κατάσταση συνεδρίας ASP.NET

app.UseSession();          // καλέστε το UseSession() πριν το UseDoconut()
app.UseDoconutResources(); // πρέπει να καταχωρηθεί πριν το UseDoconut()
app.UseDoconut();

Όλες οι επιλογές

DoconutOptions δέχεται τις παρακάτω ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.

Ιδιότητα	Προεπιλογή	Περιγραφή
`ShowDoconutInfo`	`false`	Όταν είναι `true`, ένα αίτημα χωρίς `token` επιστρέφει μια λωρίδα έκδοσης αντί για 404. Χρήσιμο ως γρήγορος έλεγχος· απενεργοποιήστε το στην παραγωγή.
`UnsafeMode`	`false`	Όταν είναι `true`, παραλείπεται ο έλεγχος ασφαλείας της ASP.NET‑session στα αιτήματα σελίδας. Απενεργοποιήστε το στην παραγωγή.
`MiddlewarePath`	`"/doconut"`	Τιμή συντονισμού για το endpoint εικόνας σελίδας. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε τη σύμφωνη με την πραγματική αντιστοίχιση του `UseDoconut()` και το `BasePath` του πελάτη.
`ResourcesPath`	`"/doconut-res"`	Από όπου σερβίρονται οι ενσωματωμένοι πόροι JS/CSS/εικόνας.
`LicensePath`	`""` (κενή συμβολοσειρά)	Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει ότι περνάει στην επόμενη πηγή, έπειτα γίνεται αυτόματη αναζήτηση.
`LicenseContent`	`""` (κενή συμβολοσειρά)	Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων.
`LicenseStream`	`null`	Άδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση.
`ResetLicense`	`false`	Καθορισμένη σημαία συμβατότητας. Οι τρέχουσες υπηρεσίες .NET 8 διαβάζουν την άδεια κατά το `AddDoconut()`· επανεκκινήστε την εφαρμογή μετά την αντικατάσταση μιας άδειας.

Προτεραιότητα άδειας όταν ορίζονται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, το LicenseContent υπερισχύει του LicensePath, το LicensePath υπερισχύει της αυτόματης αναζήτησης — δείτε Ρύθμιση Άδειας.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // συντονίστε με την αντιστοίχιση της εφαρμογής και το BasePath του πελάτη
    options.ResourcesPath   = "/doconut-res"; // από όπου σερβίρονται τα JS/CSS/εικόνες του προβολέα
    options.UnsafeMode      = false;          // διατηρήστε την ασφάλεια της συνεδρίας ενεργή
    options.ShowDoconutInfo = false;
});

Επόμενα βήματα

Γρήγορη Εκκίνηση — ανοίξτε το πρώτο σας έγγραφο και αποδώστε το στον περιηγητή.
Ρύθμιση Άδειας — όπου το Doconut αναζητά το αρχείο άδειας σας.