Ο βασικός προβολέας 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 είναι το αναγνωριστικό του πακέτου. Το επίθημα .26.7.0 ανήκει στο ληφθέν αρχείο Doconut.NET8.26.7.0.nupkg και δεν αποτελεί μέρος του αναγνωριστικού.

Καταχώριση του 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.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();

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

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

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

Ιεραρχία αδειών όταν ορίζεται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, το LicenseContent υπερισχύει του LicensePath, το LicensePath υπερισχύει της αυτόματης αναζήτησης — δείτε License Setup.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    options.ShowDoconutInfo = false;
});

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

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