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

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

bash

dotnet add package Doconut.NET6

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

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 είναι το αναγνωριστικό του πακέτου. Το επίθημα .26.7.0 ανήκει στο ληφθέν αρχείο Doconut.NET6.26.7.0.nupkg και δεν αποτελεί μέρος του αναγνωριστικού.

Αναγνώριση της ενσωμάτωσης πριν από την αναβάθμιση

Το αναγνωριστικό πακέτου Doconut.NET6 έχει χρησιμοποιηθεί τόσο από την κλασική όσο και από την τρέχουσα ενσωμάτωση .NET 6. Μην επιλέγετε τεκμηρίωση μόνο βάσει του ονόματος του πακέτου:

το DocImage.axd, new Viewer(_cache, _accessor, ...), το συγχρονικό OpenDocument(...) και τα χειροκίνητα αντιγραμμένα σενάρια προβολέα προσδιορίζουν την κλασική ενσωμάτωση;
AddDoconut(), UseDoconutResources(), ένας ενσωματωμένος Viewer και το OpenDocumentAsync(...) προσδιορίζουν την τρέχουσα ενσωμάτωση που τεκμηριώνεται εδώ.

Το μεταφρασμένο εγχειρίδιο κλασικής ρύθμισης παραμένει διαθέσιμο. Χρησιμοποιήστε τον οδηγό μετάβασης για να αλλάξετε γενιές· μια κανονική ενημέρωση πακέτου δεν μετατρέπει αυτόματα την εκκίνηση, τη διάρκεια ζωής του προβολέα ή τους πόρους του προγράμματος περιήγησης.

Καταχώριση του 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 δέχεται τις παρακάτω ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.

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

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

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 ψάχνει για το αρχείο άδειας σας.